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

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

説明

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

構文

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

引数

app

アプリケーションの名前

vol

ボリュームの名前

vdc

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

トランザクション タイプ

同期

リクエスト タイプ

GET

例

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

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

サンプル出力

XML：

<volume>
  <comment></comment>
  <filesystem>ext3</filesystem>
  <link></link>
  <mirrors>
    <mirror>
      <name>srv1.v-e9937df4-28df-4e14-9f45-31d1668e7b4a</name>
      <server>srv1</server>
      <state>ok</state>
    </mirror>
    <mirror>
      <name>srv2.v-40b44d96-7a93-4edd-a13d-c320ea3d227d</name>
      <server>srv2</server>
      <state>ok</state>
    </mirror>
  </mirrors>
  <mount_attr>rw-excl</mount_attr>
  <mount_path>none</mount_path>
  <mount_state>in_use</mount_state>
  <n_mirrors>2</n_mirrors>
  <n_users>1</n_users>
  <name>conf</name>
  <size>53477376</size>
  <state>ok</state>
  <store>local</store>
  <time_accessed>1367537796</time_accessed>
  <time_created>1367449644</time_created>
  <time_written>1367449646</time_written>
  <uuid>93298b3c-d731-43b7-b7d9-2e98393f4263</uuid>
</volume>

JSON：

{
   "link" : "",
   "time_created" : "1367449644",
   "store" : "local",
   "mount_attr" : "rw-excl",
   "mirror" : [
      {
         "name" : "srv1.v-e9937df4-28df-4e14-9f45-31d1668e7b4a",
         "server" : "srv1",
         "state" : "ok"
      },
      {
         "name" : "srv2.v-40b44d96-7a93-4edd-a13d-c320ea3d227d",
         "server" : "srv2",
         "state" : "ok"
      }
   ],
   "time_accessed" : "1367537796",
   "name" : "conf",
   "uuid" : "93298b3c-d731-43b7-b7d9-2e98393f4263",
   "mount_state" : "in_use",
   "size" : "53477376",
   "state" : "ok",
   "n_users" : "1",
   "time_written" : "1367449646",
   "mount_path" : "none",
   "comment" : "",
   "filesystem" : "ext3",
   "n_mirrors" : "2"
}

HTTP エラー コード

404

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

400.4

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

400.4

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

404.1

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