更新时间：2024-11-18 GMT+08:00
查询用户组列表
调试
您可以在API Explorer中调试该接口。
URI
GET /v3/groups
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
domain_id |
否 |
String |
用户组所属账号ID，获取方式请参见：获取账号、IAM用户、项目、用户组、区域、委托的名称和ID。 |
|
name |
否 |
String |
用户组名，长度1~128字符之间，获取方式请参见：获取账号、IAM用户、项目、用户组、区域、委托的名称和ID。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Content-Type |
是 |
String |
该字段内容填为“application/json;charset=utf8” |
|
X-Auth-Token |
是 |
String |
访问令牌，承载用户的身份、权限等信息。 token所需权限请参见授权项。 |
响应参数
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
description |
String |
用户组描述信息。 |
|
id |
String |
用户组ID。 |
|
domain_id |
String |
用户组所属账号ID。 |
|
name |
String |
用户组名。 |
|
Object |
用户组的资源链接信息。 |
|
|
create_time |
Long |
用户组创建时间。 |
请求示例
查询用户组列表。
GET https://iam.myhuaweicloud.com/v3/groups
响应示例
状态码为 200 时:
请求成功。
{
"groups": [
{
"domain_id": "d78cbac186b744899480f25bd02...",
"create_time": 1536293929624,
"name": "IAMGroupA",
"description": "IAMDescription",
"links": {
"next": null,
"previous": null,
"self": "https://iam.myhuaweicloud.com/v3/groups/5b050baea9db472c88cbae67..."
},
"id": "5b050baea9db472c88cbae6..."
},
{
"domain_id": "d78cbac186b744899480f25...",
"create_time": 1578107542861,
"name": "IAMGroupB",
"description": "IAMDescription",
"links": {
"next": null,
"previous": null,
"self": "https://iam.myhuaweicloud.com/v3/groups/07609e7eb200250a3f7dc003cb7a4e2d"
},
"id": "07609e7eb200250a3f7dc003cb..."
}
],
"links": {
"next": null,
"previous": null,
"self": "https://iam.myhuaweicloud.com/v3/groups"
}
}
返回值
|
返回值 |
描述 |
|---|---|
|
200 |
请求成功。 |
|
400 |
参数无效。 |
|
401 |
认证失败。 |
|
403 |
没有操作权限。 |
错误码
无
父主题： 用户组管理
