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

get 方法（group 对象）

说明

显示组信息。 显示的信息包括：组名称、ID、范围、说明以及主要组成员。

语法

/api/v2/group/get?group=group&vdc=controller-name 

参数

group

组名称

vdc

目标虚拟数据中心的名称

事务类型

同步

请求类型

GET

示例

创建名为 mygroup 的本地组

GET
http://192.168.123.200/api/v2/group/create?group=mygroup&vdc=mygrid

获取组 mygroup 的组信息

GET
http://192.168.123.200/api/v2/group/get?group=mygroup&vdc=mygrid

样例输出

JSON：

{
   "group" : {
      "can_own" : "0",
      "name" : "mygroup",
      "id" : "1c534f9d-e26d-41e8-922f-4649743b9e98",
      "description" : "",
      "scope" : "local"
   }
}

XML：

<group>
  <can_own>0</can_own>
  <description></description>
  <id>1c534f9d-e26d-41e8-922f-4649743b9e98</id>
  <name>mygroup</name>
  <scope>local</scope>
</group>

HTTP 错误代码

400

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

400.4

缺少必需参数 (app)。
－缺少参数 group=group。

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