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

list 方法（cat 对象）

说明

检索全局目录的列表

语法

/api/v2/cat/list?vdc=controller-name 

参数

vdc

目标虚拟数据中心的名称

事务类型

同步

请求类型

GET

示例

检索目录的列表。

GET http://192.168.123.200/api/v2/cat/list?vdc=mygrid 

样例输出

XML：

<catalogs>
  <catalog>
    <description></description>
    <name>system_ms</name>
  </catalog>
  <catalog>
    <description></description>
    <name>system</name>
  </catalog>
  <catalog>
    <description></description>
    <name>dynamic</name>
  </catalog>
  <catalog>
    <description></description>
    <name>user</name>
  </catalog>
  <catalog>
    <description></description>
    <name>OUT_6492</name>
  </catalog>
  <catalog>
    <description></description>
    <name>filer</name>
  </catalog>
</catalogs>

JSON：

{
   "catalog" : [
      {
         "name" : "system_ms",
         "description" : ""
      },
      {
         "name" : "system",
         "description" : ""
      },
      {
         "name" : "dynamic",
         "description" : ""
      },
      {
         "name" : "user",
         "description" : ""
      },
      {
         "name" : "OUT_6492",
         "description" : ""
      },
      {
         "name" : "filer",
         "description" : ""
      }
   ]
}

HTTP 错误代码

404

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