3.2. リソースおよびコレクション
API の RESTful の性質は、理論的および実用的な理由の両方で Python バインディング全体で明らかになります。すべての RESTful API には、認識する必要のある 2 つの主要な概念があります。
- コレクション
- コレクションは、同じタイプのリソースのセットです。API は最上位のコレクションとサブコレクションの両方を提供します。トップレベルのコレクションの例は、環境内のすべての仮想化ホストが含まれる
hosts
コレクションです。サブコレクションの例は、ホストリソースに割り当てられたすべてのネットワークインターフェイスカードのリソースが含まれるhost.nics
コレクションです。コレクションと対話するインターフェイスは、リソースの追加(の追加)、リソースの取得(get
)、およびリソースの一覧表示を行うメソッド(リスト
)を提供します。 - リソース
- RESTful API のリソースは、固定されたインターフェイスを持つオブジェクトで、表現される特定のタイプのリソースに関連する属性のセットも含まれます。リソースと対話するインターフェイスは、リソースの更新(
更新
)およびリソースの削除(削除
)を行う方法を提供します。また、リソースによっては、リソースタイプに固有のアクションをサポートするものもあります。たとえば、ホストリソースの
ます。承認
方法が挙げられ