Red Hat Summit6.38. クラスター
特定のクラスターを管理するサービス。
| 名前 | Summary |
|---|---|
|
| クラスターに関する情報を取得します。 |
|
| クラスター内のすべてのボリュームの Gluster 修復情報を更新します。 |
|
| システムからクラスターを削除します。 |
|
| |
|
| クラスターのすべてのネットワークを同期します。 |
|
| クラスターに関する情報を更新します。 |
|
| アクションの値に基づいて、クラスターのアップグレードプロセスを開始、更新、または終了します。 |
6.38.1. get GET
クラスターに関する情報を取得します。
クラスターを取得する例:
GET /ovirt-engine/api/clusters/123<cluster href="/ovirt-engine/api/clusters/123" id="123">
<actions>
<link href="/ovirt-engine/api/clusters/123/resetemulatedmachine" rel="resetemulatedmachine"/>
</actions>
<name>Default</name>
<description>The default server cluster</description>
<link href="/ovirt-engine/api/clusters/123/networks" rel="networks"/>
<link href="/ovirt-engine/api/clusters/123/permissions" rel="permissions"/>
<link href="/ovirt-engine/api/clusters/123/glustervolumes" rel="glustervolumes"/>
<link href="/ovirt-engine/api/clusters/123/glusterhooks" rel="glusterhooks"/>
<link href="/ovirt-engine/api/clusters/123/affinitygroups" rel="affinitygroups"/>
<link href="/ovirt-engine/api/clusters/123/cpuprofiles" rel="cpuprofiles"/>
<ballooning_enabled>false</ballooning_enabled>
<cpu>
<architecture>x86_64</architecture>
<type>Intel Nehalem Family</type>
</cpu>
<error_handling>
<on_error>migrate</on_error>
</error_handling>
<fencing_policy>
<enabled>true</enabled>
<skip_if_connectivity_broken>
<enabled>false</enabled>
<threshold>50</threshold>
</skip_if_connectivity_broken>
<skip_if_sd_active>
<enabled>false</enabled>
</skip_if_sd_active>
</fencing_policy>
<gluster_service>false</gluster_service>
<ha_reservation>false</ha_reservation>
<ksm>
<enabled>true</enabled>
<merge_across_nodes>true</merge_across_nodes>
</ksm>
<memory_policy>
<over_commit>
<percent>100</percent>
</over_commit>
<transparent_hugepages>
<enabled>true</enabled>
</transparent_hugepages>
</memory_policy>
<migration>
<auto_converge>inherit</auto_converge>
<bandwidth>
<assignment_method>auto</assignment_method>
</bandwidth>
<compressed>inherit</compressed>
</migration>
<required_rng_sources>
<required_rng_source>random</required_rng_source>
</required_rng_sources>
<scheduling_policy href="/ovirt-engine/api/schedulingpolicies/456" id="456"/>
<threads_as_cores>false</threads_as_cores>
<trusted_service>false</trusted_service>
<tunnel_migration>false</tunnel_migration>
<version>
<major>4</major>
<minor>0</minor>
</version>
<virt_service>true</virt_service>
<data_center href="/ovirt-engine/api/datacenters/111" id="111"/>
</cluster>| 名前 | 型 | 方向 | Summary |
|---|---|---|---|
|
| Out | ||
|
| In | ユーザーのパーミッションにしたがって、結果をフィルターする必要があるかどうかを示します。 | |
|
| In | たどる 必要のある内部リンクを指定します。 |
6.38.1.1. follow
たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。
6.38.2. refreshglusterhealstatus POST
クラスター内のすべてのボリュームの Gluster 修復情報を更新します。
たとえば、Cluster 123 では、以下のような要求を送信します。
POST /ovirt-engine/api/clusters/123/refreshglusterhealstatus6.38.3. remove DELETE
システムからクラスターを削除します。
DELETE /ovirt-engine/api/clusters/00000000-0000-0000-0000-000000000000| 名前 | 型 | 方向 | Summary |
|---|---|---|---|
|
| In | 削除を非同期的に実行するかどうかを指定します。 |
6.38.4. resetemulatedmachine POST
| 名前 | 型 | 方向 | Summary |
|---|---|---|---|
|
| In | リセットを非同期で実行する必要があるかどうかを示します。 |
6.38.5. syncallnetworks POST
クラスターのすべてのネットワークを同期します。
POST /ovirt-engine/api/clusters/123/syncallnetworksリクエスト本文は以下のようになります。
<action/>| 名前 | 型 | 方向 | Summary |
|---|---|---|---|
|
| In | アクションを非同期で実行する必要があるかどうかを示します。 |
6.38.6. update PUT
クラスターに関する情報を更新します。
指定されたフィールドのみが更新されます。その他は変更されません。
たとえば、クラスターの CPU を更新するには、次のようにします。
PUT /ovirt-engine/api/clusters/123リクエスト本文は以下のようになります。
<cluster>
<cpu>
<type>Intel Haswell-noTSX Family</type>
</cpu>
</cluster>6.38.7. upgrade POST
アクションの値に基づいて、クラスターのアップグレードプロセスを開始、更新、または終了します。このアクションは、start、stop、または update_progress の値をとるアクション値に基づいて、クラスターにアップグレードのマークを付けたり、進行状況を更新したり、クラスターのアップグレード実行フラグをクリアしたりします。
POST /ovirt-engine/api/clusters/123/upgradeアップグレードの対象となるクラスターをマークするための次のようなリクエスト本文を使用します。
<action>
<upgrade_action>
start
</upgrade_action>
</action>アップグレードを開始した後、次のようなリクエスト本文を使用して、進行状況を 15% に更新します。
<action>
<upgrade_action>
update_progress
</upgrade_action>
<upgrade_percent_complete>
15
</upgrade_percent_complete>
</action>| 名前 | 型 | 方向 | Summary |
|---|---|---|---|
|
| In | アクションを非同期で実行する必要があるかどうかを示します。 | |
|
| In | アップグレード相関識別子を明示的に設定します。 | |
|
| In | 実行するアクション。 | |
|
| In | アップグレードの進行状況を、プロセス全体の完了率として更新します。 |
6.38.7.1. correlation_id
アップグレード相関識別子を明示的に設定します。クラスターのアップグレードの詳細を示すイベントをアップグレード自体に関連付けるために使用します。指定のない場合は、Correlation-Id http ヘッダーの相関 ID が使用されます。
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}