6.104. GlusterVolume
このサービスは単一の gluster ボリュームを管理します。
| 名前 | Summary |
|---|---|
|
| gluster ボリュームの詳細を取得します。 |
|
| gluster ボリュームプロファイルの統計を取得します。 |
|
| gluster ボリュームをリバランスします。 |
|
| gluster ボリュームを削除します。 |
|
| gluster ボリュームに設定されたすべてのオプションをリセットします。 |
|
| gluster ボリュームで特定のオプションをリセットします。 |
|
| gluster ボリュームに特定のオプションを設定します。 |
|
| gluster ボリュームを起動します。 |
|
| gluster ボリュームのプロファイリングを開始します。 |
|
| gluster ボリュームを停止します。 |
|
| gluster ボリュームのプロファイリングを停止します。 |
|
| 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>| 名前 | 型 | 方向 | Summary |
|---|---|---|---|
|
| In | たどる 必要のある内部リンクを指定します。 | |
|
| 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
| 名前 | 型 | 方向 | Summary |
|---|---|---|---|
|
| Out | アクションから返される Gluster ボリュームのプロファイリング情報。 |
6.104.3. rebalance POST
gluster ボリュームをリバランスします。
gluster ボリュームのリバランスは、すべてのブリックにデータを均等に分散するのに役立ちます。(データの移行なし) gluster ボリュームを拡張または縮小した後、ブリック間でデータのリバランスを行う必要があります。複製されていないボリュームでは、リバランス操作を実行するために、すべてのブリックをオンラインにする必要があります。複製されたボリュームでは、レプリカ内の少なくとも 1 つのブリックがオンラインである必要があります。
たとえば、クラスター 456 で識別子 123 の gluster ボリュームをリバランスするには、以下のように要求を送信します。
POST /ovirt-engine/api/clusters/456/glustervolumes/123/rebalance
| 名前 | 型 | 方向 | Summary |
|---|---|---|---|
|
| In | リバランスを非同期的に実行するかどうかを指定します。 | |
|
| In | true に設定すると、リバランスによってレイアウトが修正され、ボリュームに追加された新規データがすべてのホストに分散されます。 | |
|
| 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
| 名前 | 型 | 方向 | Summary |
|---|---|---|---|
|
| In | 削除を非同期的に実行するかどうかを指定します。 |
6.104.5. resetalloptions POST
gluster ボリュームに設定されたすべてのオプションをリセットします。
たとえば、クラスター 456 で識別子 123 を使用して gluster ボリューム内のすべてのオプションをリセットするには、以下のように要求を送信します。
POST /ovirt-engine/api/clusters/456/glustervolumes/123/resetalloptions
| 名前 | 型 | 方向 | Summary |
|---|---|---|---|
|
| 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>
| 名前 | 型 | 方向 | Summary |
|---|---|---|---|
|
| In | リセットを非同期で実行する必要があるかどうかを示します。 | |
|
| In | ||
|
| 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>
| 名前 | 型 | 方向 | Summary |
|---|---|---|---|
|
| In | アクションを非同期で実行する必要があるかどうかを示します。 | |
|
| In | 設定するオプション。 |
6.104.8. start POST
gluster ボリュームを起動します。
Gluster ボリュームは、データの読み取り/書き込みを開始する必要があります。たとえば、クラスター 456 で識別子 123 で gluster ボリュームを起動するには、以下のように要求を送信します。
POST /ovirt-engine/api/clusters/456/glustervolumes/123/start
| 名前 | 型 | 方向 | Summary |
|---|---|---|---|
|
| In | アクションを非同期で実行する必要があるかどうかを示します。 | |
|
| 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
| 名前 | 型 | 方向 | Summary |
|---|---|---|---|
|
| In | アクションを非同期で実行する必要があるかどうかを示します。 |
6.104.10. stop POST
gluster ボリュームを停止します。
ボリュームを停止すると、そのデータにはアクセスできなくなります。
たとえば、クラスター 456 で識別子 123 の gluster ボリュームを停止するには、以下のように要求を送信します。
POST /ovirt-engine/api/clusters/456/glustervolumes/123/stop
| 名前 | 型 | 方向 | Summary |
|---|---|---|---|
|
| In | アクションを非同期で実行する必要があるかどうかを示します。 | |
|
| In |
6.104.11. stopprofile POST
gluster ボリュームのプロファイリングを停止します。
たとえば、クラスター 456 で識別子 123 の gluster ボリュームのプロファイリングを停止するには、以下のように要求を送信します。
POST /ovirt-engine/api/clusters/456/glustervolumes/123/stopprofile
| 名前 | 型 | 方向 | Summary |
|---|---|---|---|
|
| In | アクションを非同期で実行する必要があるかどうかを示します。 |
6.104.12. stoprebalance POST
gluster ボリュームのリバランスを停止します。
たとえば、クラスター 456 で識別子 123 の gluster ボリュームの再調整を停止するには、以下のように要求を送信します。
POST /ovirt-engine/api/clusters/456/glustervolumes/123/stoprebalance
| 名前 | 型 | 方向 | Summary |
|---|---|---|---|
|
| In | アクションを非同期で実行する必要があるかどうかを示します。 |
