3.2. リソースおよびコレクション

コレクションは、同じタイプのリソースのセットです。API は、最上位コレクションとサブコレクションの両方を提供します。最上位コレクションの例としては、環境内の全仮想化ホストを含む hosts コレクションがあげられます。また、サブコレクションの例としては、ホストリソースにアタッチされた全ネットワークインターフェースカードのリソースを含む host.nics コレクションがあげられます。

コレクションと対話するインターフェースは、リソースを追加するメソッド (add)、リソースを取得するメソッド (get)、およびリソースをリストするメソッド (list) を提供します。

RESTful API のリソースは、表現されるリソースの特定のタイプに関連する属性セットも含む固定インターフェースがあるオブジェクトです。リソースと対話するインターフェースは、リソースを更新するメソッド (update) とリソースを削除するメソッド (delete) を提供します。また、一部のリソースはリソースタイプに固有なアクションをサポートします。Host リソースの approve メソッドはその一例です。