前のトピック: destroy メソッド(cat オブジェクト)

次のトピック: migrate メソッド(cat オブジェクト)

rename メソッド(cat オブジェクト)

説明

グローバル カタログの名前を変更します。

構文
/api/v1/cat/rename?cat=catalog&new_name=new-catalog&vdc=controller-name 
引数
catalog

名前が変更されるカタログの名前

new-catalog

カタログの新しい名前

controller-name

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

トランザクション タイプ

同期

リクエスト タイプ

GET

/test カタログの名前を /test2 に変更します。

GET http://192.168.123.200/api/v1/cat/rename?cat=/test&new_name=/test2&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

必要な引数(cat)がありません。 リクエストに引数 cat=catalog がありません。

400.4

必要な引数(new_name)がありません。 リクエストに引数 new_name=new-catalog がありません。

404

カタログ test は存在しません。 リクエストで無効なカタログが指定されています。

404

test は有効なカタログではありません。 カタログで無効な new_name が指定されています。