CA 3Tera AppLogic API の有効なオブジェクト › vol オブジェクト › rename メソッド（vol オブジェクト）

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

説明

ボリュームの名前を変更します。

構文

/api/v1/vol/rename?app=application&vol=volume&volnew=new-volume&vdc=controller-name 

引数

application

アプリケーションの名前

volume

ボリュームの名前

new-vol

新しいボリュームの名前

controller-name

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

トランザクション タイプ

非同期

リクエスト タイプ

GET

例

ボリューム test:vol1 の名前を test:vol2 に変更します。

GET http://192.168.123.200/api/v1/vol/rename?app=test&vol=vol1&volnew=vol2&vdc=mygrid 

サンプル出力

XML

<opt></opt>

JSON

{} 

メモ

JSON の出力はすべて UTF8 にエンコードされています。 UTF8 デコードを使用して UTF8 にエンコードされた出力をデコードします。

UTF8 にエンコードされた JSON 出力をデコードするシンプルな PHP スクリプトの例を以下に示します。

<? 
$json = '{"a": "¥u00e3¥u0081¥u0082" }'; 
$j = json_decode($json); 
echo utf8_decode($j->{'a'}); 
?>

HTTP エラー コード

404

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

400.4

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

400.4

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

400.4

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

404

ボリューム test:data が存在しません。 リクエストのアプリケーションが無効です。

404

ボリューム test:data の名前を変更できませんでした。 リクエストで指定されたボリュームは使用中です。

404

ボリューム test:data2 が存在しません。 リクエストで無効なボリュームが指定されています。