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

list 方法（vol 对象）

说明

检索应用中卷的列表

语法

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

参数

app

应用的名称

vdc

目标虚拟数据中心的名称

事务类型

同步

请求类型

GET

示例

检索 test 的卷的列表。

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

样例输出

XML：

<volume> 
   <name>vol1</name> 
   <comment></comment> 
   <filesystem>ext3</filesystem> 
   <mount_state>available</mount_state> 
   <n_mirrors>1</n_mirrors> 
   <scope_name>test</scope_name> 
   <scope_type>application</scope_type> 
   <server>srv1</server> 
   <size>1073741824</size> 
   <state>ok</state> 
   <uuid>cf432100-63fc-450d-8eb7- 2da6deca8627</uuid> 
</volume> 

JSON：

{ 
   "scope_type" : "application", 
   "name" : "vol1", 
   "scope_name" : "test", 
   "mount_state" : "available", 
   "uuid" : "cf432100-63fc-450d-8eb7-2da6deca8627", 
   "size" : "1073741824", 
   "state" : "ok", 
   "comment" : "", 
   "filesystem" : "ext3", 
   "n_mirrors" : "1", 
   "server" : "srv1" 
} 

HTTP 错误代码

404

未找到实体 vdc mygrid－WS_API 应用中没有配置指定的 VDC 名称。

400.4

缺少必需参数 (app)。 －请求中缺少参数 app=app。

404.1

应用 test 不存在。 －请求中指定的应用无效。