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

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

説明

ボリュームを作成します。

構文

/api/v1/vol/create?app=application&vol=volume&fs=filesystem&size=size&mirrored=mirrored&vdc=controller-name 

引数

application

アプリケーションの名前

volume

ボリュームの名前

filesystem

作成されるボリュームのファイルシステム

size

ボリュームのサイズ

mirrored

1： ボリュームはミラー化されます。
0： ボリュームはミラー化されません。

controller-name

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

トランザクション タイプ

非同期

リクエスト タイプ

GET

例

test:vol1 という名前の 1 GB のミラー化されたボリューム（ファイルシステム etc3）を作成します。

GET http://192.168.123.200/api/v1/vol/create?app=test&vol=vol1&fs=ext3&size=1G&mirrored=1&vdc=mygrid 

サンプル出力

XML

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

JSON

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

メモ

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

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

400.4

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

400.4

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

メモ

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