基本信息

Action

DescribeUserGroups

Path

/iaas

Method

GET

请求参数

此接口除公共参数外，还包含以下参数。关于公共参数的更多信息，请参见前文内容。

参数名 类型 描述 是否必须

user_groups.n

String

用户组 ID

否

status.n

String

过滤状态

否

search_word

String

搜索关键词, 支持云服务器 ID, 云服务器名称

否

verbose

Integer

是否返回冗长的信息, 若为 1, 则返回云服务器相关其他资源的详细数据

否

sort_key

String

排序字段，默认为 create_time

否

reverse

Integer

0 为增序排列；1 为降序排列

否

请求示例

https://api.<your_domain>/iaas/?action=DescribeUserGroups
&user_groups.1=ug-9u38mu0g
&user_groups.2=ug-tvj8mhxc
&COMMON_PARAMS

返回示例

{
  "action":"DescribeUserGroupsResponse",
  "total_count":2,
  "user_group_set":[
    {
      "status":"enabled",
      "description":"",
      "user_group_name":"",
      "create_time":"2016-01-21T09:31:05Z",
      "status_time":"2016-01-21T09:31:05Z",
      "user_group_id":"ug-9u38mu0g"
    },
    {
      "status":"enabled",
      "description":"",
      "user_group_name":"U2",
      "create_time":"2016-01-21T05:42:48Z",
      "status_time":"2016-01-22T15:35:20Z",
      "user_group_id":"ug-tvj8mhxc"
    }
  ],
  "ret_code":0
}