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

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

集成指南 › 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 不存在。 －请求中指定的应用或卷无效。