統合ガイド › Web サービス API リファレンス ガイド › 有効なオブジェクト › vol オブジェクト › move メソッド（vol オブジェクト）

move メソッド（vol オブジェクト）

説明

ボリュームを別の場所に移動します。

構文

/api/v2/vol/move?app=application&vol=volume&volnew=new-volume-location&vdc=controller-name

引数

app

ソース アプリケーションの名前

vol

ボリュームの名前

volnew

<application>:<volume_name> 形式の新しいボリュームの場所

vdc

ターゲットの仮想データ センターの名前

トランザクション タイプ

非同期

リクエスト タイプ

GET

例

ボリューム atest:vol1 を btest:vol2 に移動します。

GET http://192.168.123.200/api/v2/vol/move?app=atest&vol=vol1&volnew=btest:vol2&vdc=mygrid

サンプル出力

XML：

<job>be805915-76b2-48c8-b8a0-b881cca66da6</job>

JSON：

{

"job" : "be805915-76b2-48c8-b8a0-b881cca66da6"

}

HTTP エラー コード

404

エンティティ vdc mygrid が見つかりません。WS_API アプリケーションに設定されていない VDC 名が指定されました。

400.4

必要な引数（app）がありません。 リクエストに引数 app=app がありません。

400.4

必要な引数（vol）がありません。 リクエストに引数 vol=vol がありません。

400.4

必要な引数（volnew）がありません。 リクエストに引数 volnew=new_vol がありません。

注： ジョブのステータスを取得するには、/api/v2/job/info? リクエストを発行し、上で返された job_id を引数に指定します。 ジョブ ステータスの取得方法の詳細については、「job オブジェクト」（308 ページ）を参照してください。

relocate メソッド（vol オブジェクト）

説明

別のボリューム ストア（ローカルまたは SAN）または有効なサーバに、ボリュームを再配置します。

構文

/api/v2/vol/relocate?app=application&name=app-or-volume&vdc=controller-name

引数

名前

再配置するボリュームの名前

vdc

ターゲットの仮想データ センターの名前

オプション

store

ボリュームを再配置するボリューム ストアを指定します。 値は san または local です。

n

同時に再配置するボリュームの数を指定します。 デフォルト：1 回に 1 つのボリューム

&all

再配置を必要とするすべてのボリュームを再配置します。

&status

再配置が必要なボリューム、または特定のボリュームの再配置ステータスをリストします。

&suspend

進行中のボリューム再配置を一時停止します。

トランザクション タイプ

非同期

リクエスト タイプ

GET

例

アプリケーション ボリューム MYAPP:data をローカル ストアに再配置します。

GET http://aux/api/v2/vol/relocate?name=MYAPP:data&store=local&vdc=mygrid

アプリケーション MYAPP のすべてのボリュームを SAN に再配置します。

GET http://aux/api/v2/vol/relocate?name=MYAPP&store=san&vdc=mygrid

無効になったサーバからすべてのボリュームを 1 回に 3 つずつ再配置します。

GET http://aux/api/v2/vol/relocate?&all&n=3&vdc=mygrid

サンプル出力

XML：

 <job>b88969ea-9264-40b2-ba08-29b7ecbcc150</job>

JSON：

{
   "job": "b88969ea-9264-40b2-ba08-29b7ecbcc150"
}

HTTP エラー コード

404

エンティティ vdc mygrid が見つかりません。WS_API アプリケーションに設定されていない VDC 名が指定されました。

注： ジョブのステータスを取得するには、/api/v2/job/info? リクエストを発行し、上で返された job_id を引数に指定します。 ジョブ ステータスを取得する方法の詳細については、job オブジェクトを参照してください。

relocate_status メソッド（vol オブジェクト）

説明

グリッド上で進行中のボリューム再配置の状態をレポートします。

構文

/api/v2/vol/relocate_status?&vdc=controller-name 

引数

vdc

ターゲットの仮想データ センターの名前

トランザクション タイプ

非同期

リクエスト タイプ

GET

例

グリッド mygrid 上のボリューム再配置の進捗状況を確認します。

GET http://aux/api/v2/vol/relocate_status?&vdc=mygrid 

サンプル出力

XML：

<opt></opt>

JSON：

{
   "message" : ""
}

HTTP エラー コード

404

エンティティ vdc mygrid が見つかりません。WS_API アプリケーションに設定されていない VDC 名が指定されました。