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

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

説明

ボリュームの詳細情報のリストを取得します。

構文

/api/v1/vol/info?app=application&vol=volume&vdc=controller-name 

引数

app

アプリケーションの名前

vol

ボリュームの名前

vdc

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

トランザクション タイプ

同期

リクエスト タイプ

GET

例

test:vol1 の詳細情報のリストを取得します。

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

サンプル出力

XML：

<volume> 
   <name>vol1</name> 
   <comment></comment> 
   <filesystem>ext3</filesystem> 
   <link></link> 
   <mirror srv1.v-f13f4c46-b84a-496b-9288-188be464ab56> 
      <server>srv1</server> 
      <state>ok</state> 
   </mirror srv1.v-f13f4c46-b84a-496b-9288-188be464ab56> 
   <mount_path>none</mount_path> 
   <mount_state>available</mount_state> 
   <n_mirrors>1</n_mirrors> 
   <n_users>0</n_users> 
   <size>1073741824</size> 
   <state>ok</state> 
   <time_accessed>1272052234</time_accessed> 
   <time_created>1272052031</time_created> 
   <time_written>1272052032</time_written> 
   <uuid>cf432100-63fc-450d-8eb7-2da6deca8627</uuid> 
</volume> 

JSON：

{ 
   "link" : "", 
   "time_created" : "1272052031", 
   "time_accessed" : "1272052240", 
   "name" : "vol1", 
   "uuid" : "cf432100-63fc-450d-8eb7-2da6deca8627", 
   "mount_state" : "available", 
   "mirror srv1.v-f13f4c46-b84a-496b-9288-188be464ab56" : { 
      "server" : "srv1", 
      "state" : "ok" 
   }, 
   "size" : "1073741824", 
   "state" : "ok", 
   "n_users" : "0", 
   "time_written" : "1272052032", 
   "mount_path" : "none", 
   "comment" : "", 
   "filesystem" : "ext3", 
   "n_mirrors" : "1" 
} 

HTTP エラー コード

404

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

400.4

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

400.4

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

404.1

ボリューム test:data が存在しません。 リクエストに無効なアプリケーションまたはボリュームが指定されています。