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

list 方法（group 对象）

说明

列出网格控制器的本地目录服务数据库中的组以及全局目录服务数据库中的组（如果该网格已配置为使用此类服务）。

语法

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

参数

vdc（可选）

目标虚拟数据中心的名称

事务类型

同步

请求类型

GET

示例

列出组

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

列出本地组

GET
http://192.168.123.200/api/v2/group/list?local&vdc=mygrid

列出全局组

GET
http://192.168.123.200/api/v2/group/list?global&vdc=mygrid

样例输出

JSON：

{
   "group" : [
      {
         "can_own" : "0",
         "name" : "local:admin",
         "description" : "",
         "scope" : "local"
      },
      {
         "can_own" : "0",
         "name" : "local:all",
         "description" : "implicitly contains all users as members",
         "scope" : "local"
      }
   ]
}

XML：

<groups>
  <group>
    <can_own>0</can_own>
    <description></description>
    <name>local:admin</name>
    <scope>local</scope>
  </group>
  <group>
    <can_own>0</can_own>
    <description>implicitly contains all users as members</description>
    <name>local:all</name>
    <scope>local</scope>
  </group>
</groups>

HTTP 错误代码

400

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

注意：此 API 可用于 WS_API_r6-1.0.6-1 及更高版本。