6.55. DataCenters


データセンターを管理するサービス

表6.160 メソッドの概要
名前Summary

add

新しいデータセンターを作成します。

list

データセンターをリスト表示します。

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>
表6.161 パラメーターの概要
名前方向Summary

data_center

DataCenter

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 パラメーターに含まれている場合にのみ保証されます。

表6.162 パラメーターの概要
名前方向Summary

case_sensitive

ブール値

In

search パラメーターを使用して実行する検索を、大文字と小文字を区別して実行する必要があるかどうかを示します。

data_centers

DataCenter[]

Out

 

filter

ブール値

In

ユーザーのパーミッションにしたがって、結果をフィルターする必要があるかどうかを示します。

follow

String

In

たどる 必要のある内部リンクを指定します。

max

Integer

In

返すデータセンターの最大数を設定します。

search

String

In

返されたデータセンターを制限するために使用されるクエリー文字列。

6.55.2.1. case_sensitive

search パラメーターを使用して実行する検索を、大文字と小文字を区別して実行する必要があるかどうかを示します。デフォルト値は true です。つまり、大文字と小文字の区別が考慮されます。ケースを無視する場合は、false に設定します。

6.55.2.2. follow

たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。

6.55.2.3. max

返すデータセンターの最大数を設定します。指定されていない場合は、すべてのデータセンターが返されます。

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.