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

6.101. GlusterBricks

このサービスは、gluster ボリュームで gluster ブリックを管理します。

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

activate

削除操作のデータ移行の後のデータ移行をアクティベートします。

add

gluster ボリュームに、ブリックのリストを追加します。

list

gluster ボリュームのブリックをリスト表示します。

migrate

ブリックを削除する前にデータの移行を開始します。

remove

gluster ボリュームからブリックを削除します。

stopmigrate

削除のブリック操作に関するデータのブリックからの移行を停止します。

6.101.1. activate POST
リンクのコピー

削除操作のデータ移行の後のデータ移行をアクティベートします。

ブリックからのデータ移行が完了し、ユーザーがブリックを削除したくないと、ブリックをアクティベートするために使用されます。削除用に以前にマークされていたブリックは、通常のブリックとして使用されるようになりました。

たとえば、データの移行元である glustervolume 123 のブリックを保持するには、次のようなリクエストを送信します。 

POST /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks/activate
Copy to Clipboard Toggle word wrap

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

<action>
  <bricks>
    <brick>
      <name>host1:/rhgs/brick1</name>
    </brick>
  </bricks>
</action>
Copy to Clipboard Toggle word wrap
Expand
表6.286 パラメーターの概要
名前型方向Summary

async

ブール値

In

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

ブリック

GlusterBrick[]

In

再アクティベートする必要があるブリックのリスト。

6.101.2. add POST
リンクのコピー

gluster ボリュームに、ブリックのリストを追加します。

ブリックを追加して gluster ボリュームを拡張するのに使用します。複製されたボリュームタイプの場合は、replica_count パラメーターを渡す必要があります。レプリカ数が増える場合、ブリックの数はレプリカセットの数と同じである必要があります。

たとえば、gluster ボリューム 123 にブリックを追加するには、次のようなリクエストを送信します。 

POST /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks
Copy to Clipboard Toggle word wrap

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

<bricks>
  <brick>
    <server_id>111</server_id>
    <brick_dir>/export/data/brick3</brick_dir>
  </brick>
</bricks>
Copy to Clipboard Toggle word wrap
Expand
表6.287 パラメーターの概要
名前型方向Summary

bricks

GlusterBrick[]

In/Out

ボリュームに追加するブリックのリスト

replica_count

Integer

In

ボリューム後の追加操作のレプリカ数。

stripe_count

Integer

In

追加後の操作のストライプ数。

6.101.3. list GET
リンクのコピー

gluster ボリュームのブリックをリスト表示します。

たとえば、gluster ボリューム 123 のブリックをリスト表示するには、以下のように要求を送信します。 

GET /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks
Copy to Clipboard Toggle word wrap

以下のような出力を提供します。 

<bricks>
  <brick id="234">
    <name>host1:/rhgs/data/brick1</name>
    <brick_dir>/rhgs/data/brick1</brick_dir>
    <server_id>111</server_id>
    <status>up</status>
  </brick>
  <brick id="233">
    <name>host2:/rhgs/data/brick1</name>
    <brick_dir>/rhgs/data/brick1</brick_dir>
    <server_id>222</server_id>
    <status>up</status>
  </brick>
</bricks>
Copy to Clipboard Toggle word wrap

返されるリストの順序は、gluster ボリュームの作成時に提供されるブリックの順序に基づいています。

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

bricks

GlusterBrick[]

Out

 

follow

String

In

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

max

Integer

In

返すブリックの最大数を設定します。

6.101.3.1. follow
リンクのコピー

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

6.101.3.2. max
リンクのコピー

返すブリックの最大数を設定します。指定されていない場合は、すべてのブリックが返されます。

6.101.4. migrate POST
リンクのコピー

ブリックを削除する前にデータの移行を開始します。

ブリックの削除は 2 つのステップで、削除されるブリック上のデータが最初に残りのブリックに移行します。移行が完了すると、API remove を介してブリックの削除が確定されます。いずれの時点でも、stopmigrate をキャンセルするアクションを呼び出す必要があります。

たとえば、ID が 123 の gluster ボリュームからブリックを削除するには、次のリクエストを送信します。 

POST /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks/migrate
Copy to Clipboard Toggle word wrap

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

<action>
  <bricks>
    <brick>
      <name>host1:/rhgs/brick1</name>
    </brick>
  </bricks>
</action>
Copy to Clipboard Toggle word wrap

移行プロセスは、ジョブを使用して API から返されたジョブ ID と、ステップを使用して job の step から追跡できます。

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

async

ブール値

In

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

bricks

GlusterBrick[]

In

データ移行を開始する必要のあるブリックのリスト。

6.101.5. remove DELETE
リンクのコピー

gluster ボリュームからブリックを削除します。

データ損失なしでブリックを削除する場合は、最初に stopmigrate を使用してそれらのデータを削除してからそれらを削除する方法が推奨されます。削除前にイメージストリームで移行が呼び出されなかった場合、データ移行なしにブリックが削除され、データが失われる可能性があります。

たとえば、gluster ボリューム 123 からブリックを削除するには、以下のように要求を送信します。 

DELETE /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks
Copy to Clipboard Toggle word wrap

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

<bricks>
  <brick>
    <name>host:brick_directory</name>
  </brick>
</bricks>
Copy to Clipboard Toggle word wrap
Expand
表6.290 パラメーターの概要
名前型方向Summary

async

ブール値

In

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

bricks

GlusterBrick[]

In

削除するブリックのリスト

replica_count

Integer

In

ボリューム後の追加操作のレプリカ数。

6.101.6. stopmigrate POST
リンクのコピー

削除のブリック操作に関するデータのブリックからの移行を停止します。

ユーザーがブリックの使用を継続したい場合に備えて、2 ステップのブリック削除プロセスの一部として開始されたデータ移行をキャンセルするには。削除用にマーク付けされていたブリックは、この操作の後に通常のブリックとして機能します。

たとえば、gluster ボリューム 123 のブリックからデータの移行を停止するには、以下のように要求を送信します。 

POST /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks/stopmigrate
Copy to Clipboard Toggle word wrap

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

<bricks>
  <brick>
    <name>host:brick_directory</name>
  </brick>
</bricks>
Copy to Clipboard Toggle word wrap
Expand
表6.291 パラメーターの概要
名前型方向Summary

async

ブール値

In

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

bricks

GlusterBrick[]

In

データ移行を停止する必要のあるブリックのリスト。

6.101.6.1. bricks
リンクのコピー

データ移行を停止する必要のあるブリックのリスト。このリストは、migrate のために渡された引数と一致する必要があります。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2025 Red Hat