检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
调用说明 IAM身份中心云服务提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 父主题: 使用前必读
如何调用API 构造请求 认证鉴权 返回结果
认证鉴权 调用接口支持使用AK/SK认证,通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。 AK/SK认证 AK/SK签名认证方式仅支持消息体大小12M以内。 AK/SK认证就是使用AK/SK对请求进行签名,在请求时将签名信息添加到消息头,从而通过身份认证。
用户/用户组绑定关系管理 绑定用户和组 列出组中的用户 列出用户加入的组 解绑用户和组 查询绑定关系详情 查询绑定关系ID 查询用户是否为用户组成员 父主题: API
构造请求 本节介绍REST API请求的组成,以调用列出实例接口说明如何调用API,该API获取账号下开通的实例信息。 您还可以通过这个视频教程了解如何构造请求调用API:https://bbs.huaweicloud.com/videos/102987 。 请求URI 请求URI由如下部分组成。
息体。 状态码 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于列出实例接口,如果调用后返回状态码为“200”,则表示请求成功。 响应消息头 对应请求消息头,响应同样也有消息头,如“Content-type”。 详细的公共响应消息头字段请参见下表。
exists. 用户和组的关联关系已经存在。 请检查是否已经将用户添加到组中了。 404 IIC.1371 The association between users and group does not exist. 找不到此关联关系ID对应的关联关系。 请检查关联关系标识符是否正确。 400
"membership_exists" : true } ] } 状态码 请参见状态码。 错误码 请参见错误码。 父主题: 用户/用户组绑定关系管理
用户管理 包括用户的增删改查、查询用户ID等接口。 用户组管理 包括用户组的增删改查、查询用户组ID等接口。 用户/用户组绑定关系管理 包括绑定关系的增删查、查询绑定关系ID、列举组中的用户、列举用户加入的组、查询用户是否为组的成员等接口。 SCIM用户管理 包括SCIM协议的用户增删改查等接口。
String 身份源的全局唯一标识符(ID)。 最小长度:1 最大长度:36 membership_id String 身份源中用户和组关联关系的全局唯一标识符(ID)。 最小长度:1 最大长度:47 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_code
查询绑定关系详情 功能介绍 根据关联关系ID,查询此关联关系的详情信息。 URI GET /v1/identity-stores/{identity_store_id}/group-memberships/{membership_id} 表1 路径参数 参数 是否必选 参数类型 描述
解绑用户和组 功能介绍 根据关联关系ID解绑用户和用户组,也就是将用户移出用户组。 URI DELETE /v1/identity-stores/{identity_store_id}/group-memberships/{membership_id} 表1 路径参数 参数 是否必选
200 表4 响应Body参数 参数 参数类型 描述 group_memberships Array of objects 满足查询条件的关联关系对象列表。 page_info Object 包含分页信息的对象。 表5 group_memberships 参数 参数类型 描述 group_id
使用前必读 概述 调用说明 终端节点(Endpoint) 约束与限制 基本概念
查询绑定关系ID 功能介绍 根据用户ID和用户组ID,查询对应的关联关系ID。 URI POST /v1/identity-stores/{identity_store_id}/group-memberships/retrieve-group-membership-id 表1 路径参数
终端节点(Endpoint) 终端节点(Endpoint)即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询所有服务的终端节点。 父主题: 使用前必读
IAM身份中心只读权限,拥有该权限的用户仅能查看IAM身份中心数据。 系统策略 无 表2列出了IAM身份中心常用操作与系统权限的授权关系,您可以参照该表选择合适的系统权限。 表2 常用操作与系统权限的关系 操作 IdentityCenter FullAccess IdentityCenter ReadOnlyAccess
200 表4 响应Body参数 参数 参数类型 描述 group_memberships Array of objects 满足查询条件的关联关系对象列表。 page_info Object 包含分页信息的对象。 表5 group_memberships 参数 参数类型 描述 group_id
Group DeleteGroup 更新用户组 Group UpdateGroup 创建用户组关联关系 GroupMembership CreateGroupMembership 删除用户组关联关系 GroupMembership DeleteGroupMembership 批量绑定用户和组
管理证书 IAM身份中心使用证书在IAM身份中心和外部身份提供商之间建立SAML信任关系。在切换身份源为外部身份提供商时,必须从外部身份提供商获得至少一个SAML 2.0证书。该证书通常包含在SAML元数据文件中,在切换身份源上传IdP SAML元数据时自动安装。 您可能需要定期