検索

6.104. GlusterVolume

download PDF

このサービスは単一の gluster ボリュームを管理します。

表6.300 メソッドの概要
名前概要

get

gluster ボリュームの詳細を取得します。

getprofilestatistics

gluster ボリュームプロファイルの統計を取得します。

rebalance

gluster ボリュームをリバランスします。

remove

gluster ボリュームを削除します。

resetalloptions

gluster ボリュームに設定されたすべてのオプションをリセットします。

resetoption

gluster ボリュームで特定のオプションをリセットします。

setoption

gluster ボリュームに特定のオプションを設定します。

start

gluster ボリュームを起動します。

startprofile

gluster ボリュームのプロファイリングを開始します。

stop

gluster ボリュームを停止します。

stopprofile

gluster ボリュームのプロファイリングを停止します。

stoprebalance

gluster ボリュームのリバランスを停止します。

6.104.1. get GET

gluster ボリュームの詳細を取得します。

たとえば、クラスター 456 で識別子 123 の gluster ボリュームの詳細を取得するには、以下のように要求を送信します。

GET /ovirt-engine/api/clusters/456/glustervolumes/123

この GET リクエストは以下の出力を返します。

<gluster_volume id="123">
 <name>data</name>
 <link href="/ovirt-engine/api/clusters/456/glustervolumes/123/glusterbricks" rel="glusterbricks"/>
 <disperse_count>0</disperse_count>
 <options>
   <option>
     <name>storage.owner-gid</name>
     <value>36</value>
   </option>
   <option>
     <name>performance.io-cache</name>
     <value>off</value>
   </option>
   <option>
     <name>cluster.data-self-heal-algorithm</name>
     <value>full</value>
   </option>
 </options>
 <redundancy_count>0</redundancy_count>
 <replica_count>3</replica_count>
 <status>up</status>
 <stripe_count>0</stripe_count>
 <transport_types>
   <transport_type>tcp</transport_type>
 </transport_types>
 <volume_type>replicate</volume_type>
 </gluster_volume>
表6.301 パラメーターの概要
名前タイプ方向概要

follow

文字列

In

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

volume

GlusterVolume

Out

gluster ボリュームを表します。

6.104.1.1. follow

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

6.104.2. getprofilestatistics POST

gluster ボリュームプロファイルの統計を取得します。

たとえば、クラスター 456 で識別子 123 の gluster ボリュームのプロファイル統計を取得するには、以下のように要求を送信します。

POST /ovirt-engine/api/clusters/456/glustervolumes/123/getprofilestatistics
表6.302 パラメーターの概要
名前タイプ方向概要

details

GlusterVolumeProfileDetails

Out

アクションから返される Gluster ボリュームのプロファイリング情報。

6.104.3. rebalance POST

gluster ボリュームをリバランスします。

gluster ボリュームのリバランスは、すべてのブリックにデータを均等に分散するのに役立ちます。(データの移行なし) gluster ボリュームを拡張または縮小した後、ブリック間でデータのリバランスを行う必要があります。複製されていないボリュームでは、リバランス操作を実行するために、すべてのブリックをオンラインにする必要があります。複製されたボリュームでは、レプリカ内の少なくとも 1 つのブリックがオンラインである必要があります。

たとえば、クラスター 456 で識別子 123 の gluster ボリュームをリバランスするには、以下のように要求を送信します。

POST /ovirt-engine/api/clusters/456/glustervolumes/123/rebalance
表6.303 パラメーターの概要
名前タイプ方向概要

async

Boolean

In

リバランスを非同期的に実行するかどうかを指定します。

fix_layout

Boolean

In

true に設定すると、リバランスによってレイアウトが修正され、ボリュームに追加された新規データがすべてのホストに分散されます。

force

Boolean

In

リバランスを強制的に起動するかどうかを示します。

6.104.3.1. fix_layout

true に設定すると、リバランスによってレイアウトが修正され、ボリュームに追加された新規データがすべてのホストに分散されます。ただし、既存のデータは移行/リバランスされません。デフォルトは false です。

6.104.3.2. force

リバランスを強制的に起動するかどうかを示します。rebalance コマンドは、古いクライアントがクラスターに接続されている場合でも、force オプションを使用して実行できます。ただし、これにより、データが失われる可能性があります。デフォルトは false です。

6.104.4. remove DELETE

gluster ボリュームを削除します。

たとえば、クラスター 456 で識別子 123 のボリュームを削除するには、以下のように要求を送信します。

DELETE /ovirt-engine/api/clusters/456/glustervolumes/123
表6.304 パラメーターの概要
名前タイプ方向概要

async

Boolean

In

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

6.104.5. resetalloptions POST

gluster ボリュームに設定されたすべてのオプションをリセットします。

たとえば、クラスター 456 で識別子 123 を使用して gluster ボリューム内のすべてのオプションをリセットするには、以下のように要求を送信します。

POST /ovirt-engine/api/clusters/456/glustervolumes/123/resetalloptions
表6.305 パラメーターの概要
名前タイプ方向概要

async

Boolean

In

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

6.104.6. resetoption POST

gluster ボリュームで特定のオプションをリセットします。

たとえば、クラスター 456 で識別子 123 の gluster ボリュームで特定の option1 をリセットするには、以下のように要求を送信します。

POST /ovirt-engine/api/clusters/456/glustervolumes/123/resetoption

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

<action>
 <option name="option1"/>
</action>
表6.306 パラメーターの概要
名前タイプ方向概要

async

Boolean

In

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

force

Boolean

In

 

option

オプション

In

リセットするオプション。

6.104.7. setoption POST

gluster ボリュームに特定のオプションを設定します。

たとえば、クラスター 456 で識別子 123 で gluster ボリュームに option1 の値 value1 を設定するには、以下のように要求を送信します。

POST /ovirt-engine/api/clusters/456/glustervolumes/123/setoption

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

<action>
 <option name="option1" value="value1"/>
</action>
表6.307 パラメーターの概要
名前タイプ方向概要

async

Boolean

In

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

option

オプション

In

設定するオプション。

6.104.8. start POST

gluster ボリュームを起動します。

Gluster ボリュームは、データの読み取り/書き込みを開始する必要があります。たとえば、クラスター 456 で識別子 123 で gluster ボリュームを起動するには、以下のように要求を送信します。

POST /ovirt-engine/api/clusters/456/glustervolumes/123/start
表6.308 パラメーターの概要
名前タイプ方向概要

async

Boolean

In

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

force

Boolean

In

ボリュームが強制的に起動するかどうかを示します。

6.104.8.1. force

ボリュームが強制的に起動するかどうかを示します。gluster ボリュームがすでに開始されているが、いくつか/すべてのブリックがダウンしている場合は、強制開始を使用してすべてのブリックを起動できます。デフォルトは false です。

6.104.9. startprofile POST

gluster ボリュームのプロファイリングを開始します。

たとえば、クラスター 456 で識別子 123 の gluster ボリュームのプロファイリングを開始するには、以下のような要求を送信します。

POST /ovirt-engine/api/clusters/456/glustervolumes/123/startprofile
表6.309 パラメーターの概要
名前タイプ方向概要

async

Boolean

In

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

6.104.10. stop POST

gluster ボリュームを停止します。

ボリュームを停止すると、そのデータにはアクセスできなくなります。

たとえば、クラスター 456 で識別子 123 の gluster ボリュームを停止するには、以下のように要求を送信します。

POST /ovirt-engine/api/clusters/456/glustervolumes/123/stop
表6.310 パラメーターの概要
名前タイプ方向概要

async

Boolean

In

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

force

Boolean

In

 

6.104.11. stopprofile POST

gluster ボリュームのプロファイリングを停止します。

たとえば、クラスター 456 で識別子 123 の gluster ボリュームのプロファイリングを停止するには、以下のように要求を送信します。

POST /ovirt-engine/api/clusters/456/glustervolumes/123/stopprofile
表6.311 パラメーターの概要
名前タイプ方向概要

async

Boolean

In

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

6.104.12. stoprebalance POST

gluster ボリュームのリバランスを停止します。

たとえば、クラスター 456 で識別子 123 の gluster ボリュームの再調整を停止するには、以下のように要求を送信します。

POST /ovirt-engine/api/clusters/456/glustervolumes/123/stoprebalance
表6.312 パラメーターの概要
名前タイプ方向概要

async

Boolean

In

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

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

© 2024 Red Hat, Inc.