6.55. DataCenters
データセンターを管理するサービス
名前 | Summary |
---|---|
| 新しいデータセンターを作成します。 |
| データセンターをリスト表示します。 |
6.55.1. add POST
新しいデータセンターを作成します。
新しいデータセンターを作成するには、name
および local
要素が必要です。たとえば、共有ストレージ (NFS、iSCSI、またはファイバーチャネル) を使用する mydc
という名前のデータセンターを作成するには、以下のようなリクエストを送信します。
POST /ovirt-engine/api/datacenters
リクエスト本文は以下のようになります。
<data_center> <name>mydc</name> <local>false</local> </data_center>
名前 | 型 | 方向 | Summary |
---|---|---|---|
| In/Out | 追加するデータセンター。 |
6.55.2. list GET
データセンターをリスト表示します。
以下の要求は、データセンターの表現を取得します。
GET /ovirt-engine/api/datacenters
上記のリクエストは curl
で実行されました:
curl \ --request GET \ --cacert /etc/pki/ovirt-engine/ca.pem \ --header "Version: 4" \ --header "Accept: application/xml" \ --user "admin@internal:mypassword" \ https://myengine.example.com/ovirt-engine/api/datacenters
応答の例を以下に示します。
<data_center href="/ovirt-engine/api/datacenters/123" id="123"> <name>Default</name> <description>The default Data Center</description> <link href="/ovirt-engine/api/datacenters/123/networks" rel="networks"/> <link href="/ovirt-engine/api/datacenters/123/storagedomains" rel="storagedomains"/> <link href="/ovirt-engine/api/datacenters/123/permissions" rel="permissions"/> <link href="/ovirt-engine/api/datacenters/123/clusters" rel="clusters"/> <link href="/ovirt-engine/api/datacenters/123/qoss" rel="qoss"/> <link href="/ovirt-engine/api/datacenters/123/iscsibonds" rel="iscsibonds"/> <link href="/ovirt-engine/api/datacenters/123/quotas" rel="quotas"/> <local>false</local> <quota_mode>disabled</quota_mode> <status>up</status> <supported_versions> <version> <major>4</major> <minor>0</minor> </version> </supported_versions> <version> <major>4</major> <minor>0</minor> </version> </data_center>
Default
データセンターの ID
コードに注意してください。このコードは、仮想環境の他のリソースに関連して、このデータセンターを特定します。
データセンターには、ストレージドメインコレクションへのリンクも含まれています。データセンターはこのコレクションを使用して、ストレージドメインのメインコレクションからストレージドメインを割り当てます。
返されるデータセンターのリストの順序は、sortby
句が search
パラメーターに含まれている場合にのみ保証されます。
名前 | 型 | 方向 | Summary |
---|---|---|---|
| In |
| |
| Out | ||
| In | ユーザーのパーミッションにしたがって、結果をフィルターする必要があるかどうかを示します。 | |
| In | たどる 必要のある内部リンクを指定します。 | |
| In | 返すデータセンターの最大数を設定します。 | |
| In | 返されたデータセンターを制限するために使用されるクエリー文字列。 |
6.55.2.1. case_sensitive
search
パラメーターを使用して実行する検索を、大文字と小文字を区別して実行する必要があるかどうかを示します。デフォルト値は true
です。つまり、大文字と小文字の区別が考慮されます。ケースを無視する場合は、false
に設定します。
6.55.2.2. follow
たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。
6.55.2.3. max
返すデータセンターの最大数を設定します。指定されていない場合は、すべてのデータセンターが返されます。