Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

6.38. クラスター

特定のクラスターを管理するサービス。

Expand
表6.108 メソッドの概要
名前Summary

get

クラスターに関する情報を取得します。

refreshglusterhealstatus

クラスター内のすべてのボリュームの Gluster 修復情報を更新します。

remove

システムからクラスターを削除します。

resetemulatedmachine

 

syncallnetworks

クラスターのすべてのネットワークを同期します。

update

クラスターに関する情報を更新します。

upgrade

アクションの値に基づいて、クラスターのアップグレードプロセスを開始、更新、または終了します。

6.38.1. get GET
リンクのコピー

クラスターに関する情報を取得します。

クラスターを取得する例: 

GET /ovirt-engine/api/clusters/123
Copy to Clipboard Toggle word wrap 
<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>
Copy to Clipboard Toggle word wrap
Expand
表6.109 パラメーターの概要
名前型方向Summary

cluster

クラスター

Out

 

filter

ブール値

In

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

follow

String

In

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

6.38.1.1. follow
リンクのコピー

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

6.38.2. refreshglusterhealstatus POST
リンクのコピー

クラスター内のすべてのボリュームの Gluster 修復情報を更新します。

たとえば、Cluster 123 では、以下のような要求を送信します。 

POST /ovirt-engine/api/clusters/123/refreshglusterhealstatus
Copy to Clipboard Toggle word wrap

6.38.3. remove DELETE
リンクのコピー

システムからクラスターを削除します。 

DELETE /ovirt-engine/api/clusters/00000000-0000-0000-0000-000000000000
Copy to Clipboard Toggle word wrap
Expand
表6.110 パラメーターの概要
名前型方向Summary

async

ブール値

In

削除を非同期的に実行するかどうかを指定します。

6.38.4. resetemulatedmachine POST
リンクのコピー

Expand
表6.111 パラメーターの概要
名前型方向Summary

async

ブール値

In

リセットを非同期で実行する必要があるかどうかを示します。

6.38.5. syncallnetworks POST
リンクのコピー

クラスターのすべてのネットワークを同期します。 

POST /ovirt-engine/api/clusters/123/syncallnetworks
Copy to Clipboard Toggle word wrap

リクエスト本文は以下のようになります。 

<action/>
Copy to Clipboard Toggle word wrap
Expand
表6.112 パラメーターの概要
名前型方向Summary

async

ブール値

In

アクションを非同期で実行する必要があるかどうかを示します。

6.38.6. update PUT
リンクのコピー

クラスターに関する情報を更新します。

指定されたフィールドのみが更新されます。その他は変更されません。

たとえば、クラスターの CPU を更新するには、次のようにします。 

PUT /ovirt-engine/api/clusters/123
Copy to Clipboard Toggle word wrap

リクエスト本文は以下のようになります。 

<cluster>
  <cpu>
    <type>Intel Haswell-noTSX Family</type>
  </cpu>
</cluster>
Copy to Clipboard Toggle word wrap
Expand
表6.113 パラメーターの概要
名前型方向Summary

async

ブール値

In

更新を非同期的に実行するかどうかを指定します。

cluster

クラスター

In/Out

 

6.38.7. upgrade POST
リンクのコピー

アクションの値に基づいて、クラスターのアップグレードプロセスを開始、更新、または終了します。このアクションは、start、stop、または update_progress の値をとるアクション値に基づいて、クラスターにアップグレードのマークを付けたり、進行状況を更新したり、クラスターのアップグレード実行フラグをクリアしたりします。 

POST /ovirt-engine/api/clusters/123/upgrade
Copy to Clipboard Toggle word wrap

アップグレードの対象となるクラスターをマークするための次のようなリクエスト本文を使用します。 

<action>
    <upgrade_action>
        start
    </upgrade_action>
</action>
Copy to Clipboard Toggle word wrap

アップグレードを開始した後、次のようなリクエスト本文を使用して、進行状況を 15% に更新します。 

<action>
    <upgrade_action>
        update_progress
    </upgrade_action>
    <upgrade_percent_complete>
        15
    </upgrade_percent_complete>
</action>
Copy to Clipboard Toggle word wrap
Expand
表6.114 パラメーターの概要
名前型方向Summary

async

ブール値

In

アクションを非同期で実行する必要があるかどうかを示します。

correlation_id

String

In

アップグレード相関識別子を明示的に設定します。

upgrade_action

ClusterUpgradeAction

In

実行するアクション。

upgrade_percent_complete

Integer

In

アップグレードの進行状況を、プロセス全体の完了率として更新します。

6.38.7.1. correlation_id
リンクのコピー

アップグレード相関識別子を明示的に設定します。クラスターのアップグレードの詳細を示すイベントをアップグレード自体に関連付けるために使用します。指定のない場合は、Correlation-Id http ヘッダーの相関 ID が使用されます。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2025 Red Hat