-
操作步骤 管理员登录
IAM 控制台。 在用户组列表中，单击新建用户组右侧的“授权”。 在授权页面进行授权时，管理员在权限列表的搜索框中搜索需要的角色。 选择角色，系统将自动勾选依赖角色。 图1 选择角色 单击勾选权限下方的，查看角色的依赖关系。 图2 查看角色的依赖关系 例如“DNS Administrator”，角色内容中存在“Depends”字段，表示存在依赖关系。给用户组授予“DNS Administrator”角色时，还需要在同项目同时授予“Tenant Guest”和“VPC Administrator”角色，“DNS Administrator”才能生效。 单击“确定”，完成依赖角色的授权。
-
响应示例 状态码为 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"
}
}
-
响应参数 表3 响应Body参数 参数 参数类型 描述 groups Array of objects 用户组信息列表。 links Object 资源链接信息。 表4 groups 参数 参数类型 描述 description String 用户组描述信息。 id String 用户组ID。 domain_id String 用户组所属账号ID。 name String 用户组名。 links Object 用户组的资源链接信息。 create_time Long 用户组创建时间。 表5 groups.links 参数 参数类型 描述 self String 资源链接地址。 previous String 前一邻接资源链接地址，不存在时为null。 next String 后一邻接资源链接地址，不存在时为null。 表6 links 参数 参数类型 描述 self String 资源链接地址。 previous String 前一邻接资源链接地址，不存在时为null。 next String 后一邻接资源链接地址，不存在时为null。
-
更多操作 关于用户组类型、用户组，您还可以执行如表1的操作。 表1 相关操作 操作 说明 编辑用户组类型 单击用户组类型后的，在下拉框中选择“编辑类型”。 删除用户组类型 单击用户组类型后的，在下拉框中选择“删除类型”。 说明： 如果用户组类型中包含用户组，需要先删除用户组才能删除该用户组类型。 编辑用户组 在用户组列表中，单击“操作”列的“编辑”。 删除用户组 在用户组列表中，单击“操作”列的“删除”。 删除用户组不会删除用户，但会影响用户的应用权限，应用的授权请参考设置应用可见范围。 查询用户组成员 在用户组列表中，单击“操作”列的“设置”。 在人员管理页面，输入“人员姓名”、“手机号码”或选择组织，单击“查询”进行搜索。 查看人员详情 在用户组列表中，单击“操作”列的“设置”。 在人员列表中，单击“操作”列的“详情”。 移除用户组成员 在用户组列表中，单击“操作”列的“设置”。 在人员列表中，单击“操作”列的“移除”。
-
响应参数 返回状态码为200：添加成功，响应体参考CommonUsergroupOutputDto。 表4 CommonUsergroupOutputDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息描述。 "" 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。
-
请求参数 表2 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 body 是 REFERENCE 详细请参见表3。 用户组结构，响应体参考UpdateUsergroupInputDto。 - 表3 UpdateUsergroupInputDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 name 是 string 1~128个字符。 - 用户组名。 "family" description 否 string 0~256个字符。 - 用户组描述信息。 "family member group"
-
响应示例 返回状态码为200：添加成功，响应体参考CommonUsergroupOutputDto。 HTTP/1.1 200 OK
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
{
"errcode" : "0",
"errmsg" : ""
} 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
返回状态码为500：内部错误。 HTTP/1.1 500 Internal Server Error
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
-
请求示例 HTTP的示例 PUT /controller/campus/v1/accountservice/usergroups/a91e1696-02a2-4a68-bad4-aa639359c8cf HTTP/1.1
Host: 192.168.1.125:18002
Content-Type: application/json
Accept: application/json
Accept-Language: en-US
X-AC
CES S-TOKEN: x-yyyyyy
{
"name" : "family",
"description" : "family member group"
}
-
请求示例 HTTP的示例 DELETE /controller/campus/v1/accountservice/usergroups/a91e1696-02a2-4a68-bad4-aa639359c8cf HTTP/1.1
Host: 192.168.1.125:18002
Content-Type: application/json
Accept: application/json
Accept-Language: en-US
X-ACCESS-TOKEN: x-yyyyyy
-
响应示例 返回状态码为200：删除成功，响应体参考DeleteUsergroupOutputDto。 HTTP/1.1 200 OK
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
{
"errcode" : "0308001017",
"errmsg" : "The user group to be queried does not exist",
"success" : [
""
],
"fail" : [
{
"errcode" : "0308001017",
"errmsg" : "The user group to be queried does not exist",
"data" : "a91e1696-02a2-4a68-bad4-aa639359c8cf"
}
]
} 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
返回状态码为500：内部错误。 HTTP/1.1 500 Internal Server Error
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
-
响应示例 状态码：200 OK {
"user_group" : [ {
"group_name" : "group-name",
"group_source" : "IAM"
} ],
"page_info" : {
"current_count" : 1
}
} 状态码：400 Bad Request {
"error_code" : "common.01000001",
"error_msg" : "failed to read http request, please check your input, code: 400, reason: Type mismatch., cause: TypeMismatchException"
} 状态码：401 Unauthorized {
"error_code": 'APIG.1002',
"error_msg": 'Incorrect token or token resolution failed'
} 状态码：403 Forbidden {
"error" : {
"code" : "403",
"message" : "X-Auth-Token is invalid in the request",
"error_code" : null,
"error_msg" : null,
"title" : "Forbidden"
},
"error_code" : "403",
"error_msg" : "X-Auth-Token is invalid in the request",
"title" : "Forbidden"
} 状态码：404 Not Found {
"error_code" : "common.01000001",
"error_msg" : "response status exception, code: 404"
} 状态码：408 Request Timeout {
"error_code" : "common.00000408",
"error_msg" : "timeout exception occurred"
} 状态码：500 Internal Server Error {
"error_code" : "common.00000500",
"error_msg" : "internal error"
}
-
URI GET /v1/{project_id}/instances/{instance_id}/groups 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目编号。获取方法，请参见获取项目ID。 instance_id 是 String LakeFormation实例ID。创建实例时自动生成。例如：2180518f-42b8-4947-b20b-adfc53981a25。 表2 Query参数 参数 是否必选 参数类型 描述 group_source 否 String 查询的用户组来源：IAM-云用户、SAML-联邦、LDAP-ld用户、LOCAL-本地用户、AGENTTENANT-委托、 OTHER-其它。 limit 否 Integer 查询返回条数。默认值为1000。最小值为1，最大值为2000。 marker 否 String 查询的起始记录ID。最小长度为0，最大长度为256。 reverse_page 否 Boolean 是否倒序查询。
-
响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 user_group Array of UserGroup objects 用户组。 page_info PagedInfo object 分页信息。 表5 UserGroup 参数 参数类型 描述 group_name String 用户组名称。 group_source String 用户组类型：IAM-云、SAML-联邦、LDAP-权限策略、LOCAL-本地、AGENTTENANT-委托、OTHER-其它。 group_id String 用户组ID。 表6 PagedInfo 参数 参数类型 描述 current_count Integer 本次返回的对象个数。最小值为0，最大值为2000。 next_marker String 下一页查询地址。当不存在下一页，则值为null，当值为null时，响应Body无该参数。 previous_marker String 上一页查询地址。当不存在上一页，则值为null，当值为null时，响应Body无该参数。 状态码：400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 solution_msg String 解决方案描述。 状态码：401 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 solution_msg String 解决方案描述。 状态码：403 表9 响应Body参数 参数 参数类型 描述 error Error object 错误信息。 error_code String 错误码。 error_msg String 错误描述。 title String 标题。 表10 Error 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 title String 标题。 message String 错误信息。 code String 状态码。 状态码：404 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 solution_msg String 解决方案描述。 状态码：408 表12 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 solution_msg String 解决方案描述。 状态码：500 表13 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 solution_msg String 解决方案描述。
-
URI GET /v2/{project_id}/groups/{group_id}/users 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id。 group_id 是 String 用户组ID。 表2 Query参数 参数 是否必选 参数类型 描述 user_name 否 String 用户名支持模糊查询。 description 否 String 用户描述支持模糊查询。 active_type 否 String 激活类型。 USER_ACTIVATE：用户激活 ADMIN_ACTIVATE：管理员激活 limit 否 String 用于分页查询，返回桌面数量限制。如果不指定或为0，默认2000，最大2000。 offset 否 String 用于分页查询，查询的起始记录序号，从0开始。
-
响应示例 状态码：200 组关联的用户列表响应。 {
"total_count" : 2,
"users" : [ {
"user_name" : "user1",
"user_email" : "xx1@mail.com",
"user_phone" : "18818008887",
"id" : "8357fd328c62447d94e452bf49xxxx"
}, {
"user_name" : "user2",
"user_email" : "xx2@mail.com",
"user_phone" : "18818008888",
"id" : "8357fd328c62447d94e452bf495xxxx"
} ]
}
