上一主题: list 方法（vol 对象）下一主题: create 方法（vol 对象）

集成指南 › Web 服务 API 参考指南 › 有效对象 › vol 对象 › info 方法（vol 对象）

info 方法（vol 对象）
说明

检索卷的详细信息列表

语法
/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 不存在。 －请求中指定的应用或卷无效。