响应参数 表9 响应Body参数 参数 参数类型 描述 credential Object 认证结果信息。 表10 credential 参数 参数类型 描述 expires_at String AK/SK和securitytoken的过期时间。响应参数为UTC时间格式，北京时间为UTC+8小时。 如返回： "expires_at": "2020-01-08T02:56:19.587000Z" 北京时间：2020-01-08 10:56:19.587 access String 获取的AK。 secret String 获取的SK。 securitytoken String securitytoken是将所获的AK、SK等信息进行加密后的字符串。

请求示例 填写"session_user"参数，即委托方对应的企业用户信息，包含委托方对应的企业用户名。 POST https://iam.myhuaweicloud.com/v3.0/OS-CREDENTIAL/securitytokens { "auth": { "identity": { "methods": [ "assume_role" ], "assume_role": { "domain_name": " IAM DomainA", "agency_name": "IAMAgency", "duration_seconds": 3600, "session_user": { "name": "SessionUserName" } } } } } 填写"policy"参数，即用户自定义策略的信息，用于限制获取到的临时访问密钥和securitytoken的权限（当前仅适用限制OBS服务的权限）。如果填写此参数，则临时访问密钥和securitytoken的权限为：委托具有的权限和policy参数限制的权限交集。 POST https://iam.myhuaweicloud.com/v3.0/OS-CREDENTIAL/securitytokens { "auth": { "identity": { "methods": [ "assume_role" ], "policy": { "Version": "1.1", "Statement": [{ "Effect": "allow", "Action": [ "obs:object:*" ], "Resource": ["obs:*:*:object:*"], "Condition": { "StringEquals": { "obs:prefix": ["public"] } } }] }, "assume_role": { "domain_name": "IAMDomainA", "agency_name": "IAMAgency", "duration_seconds": 3600 } } } } 不填写"session_user"和policy参数。 POST https://iam.myhuaweicloud.com/v3.0/OS-CREDENTIAL/securitytokens { "auth": { "identity": { "methods": [ "assume_role" ], "assume_role": { "domain_name": "IAMDomainA", "agency_name": "IAMAgency", "duration_seconds": 3600 } } } }

响应示例 状态码为 201 时: 创建成功。 无论session_user填写与否，返回都是相同的。若填写了session_user，则在securitytoken中包含了所填写的session_user信息。 { "credential": { "access": "E6DX0TF2ZREQ4Z...", "expires_at": "2020-01-08T02:56:19.587000Z", "secret": "w9ePum0qdfac39ErLD0UdjofYkqort6Iw....", "securitytoken": "gQpjbi1ub3J0aC0..." } }

功能介绍 该接口可以用于通过委托来获取临时访问密钥（临时AK/SK）和securitytoken。 临时AK/SK和securitytoken是系统颁发给IAM用户的临时访问令牌，有效期可在15分钟至24小时范围内设置，过期后需要重新获取。临时AK/SK和securitytoken遵循权限最小化原则。鉴权时，临时AK/SK和securitytoken必须同时使用，请求头中需要添加“x-security-token”字段，使用方法详情请参考：使用临时AK/SK做签名 该接口可以使用全局区域的Endpoint和其他区域的Endpoint调用。IAM的Endpoint请参见：地区和终端节点。

请求示例 填写"token"参数。包含tokenId（即token）和临时访问密钥和securitytoken的有效期。 POST https://iam.myhuaweicloud.com/v3.0/OS-CREDENTIAL/securitytokens { "auth": { "identity": { "methods": [ "token" ], "token": { "id": "MIIEIgYJKoZIhvc...", "duration_seconds": "900" } } } } 不填写“token”参数（请求头中需要X-Auth-Token）。 POST https://iam.myhuaweicloud.com/v3.0/OS-CREDENTIAL/securitytokens { "auth": { "identity": { "methods": [ "token" ] } } } 填写“policy”参数。即用户自定义策略的信息，用于限制获取到的临时访问密钥和securitytoken的权限（当前仅适用限制OBS服务的权限）。如果填写此参数，则临时访问密钥和securitytoken的权限为：原token具有的权限和policy参数限制的权限交集。 POST https://iam.myhuaweicloud.com/v3.0/OS-CREDENTIAL/securitytokens { "auth": { "identity": { "methods": [ "token" ], "policy": { "Version": "1.1", "Statement": [ { "Effect": "Allow", "Action": [ "obs:object:GetObject" ], "Resource": [ "OBS:*:*:object:*" ], "Condition": { "StringEquals": { "g:DomainName": [ "DomainNameExample" //示例，表示限制条件值，根据实际情况填写 ] } } } ] }, "token": { "duration_seconds": 900 } } } }

响应参数 表8 响应Body参数 参数 参数类型 描述 credential Object 认证结果信息。 表9 credential 参数 参数类型 描述 expires_at String AK/SK和securitytoken的过期时间。响应参数为UTC时间格式，北京时间为UTC+8小时。 如返回： "expires_at": "2020-01-08T02:56:19.587000Z" 北京时间：2020-01-08 10:56:19.587 access String 获取的AK。 secret String 获取的SK。 securitytoken String securitytoken是将所获的AK、SK等信息进行加密后的字符串。

功能介绍 该接口可以用于通过token来获取临时AK/SK和securitytoken。临时AK/SK和securitytoken是系统颁发给IAM用户的临时访问令牌，有效期可在15分钟至24小时范围内设置，过期后需要重新获取。临时AK/SK和securitytoken遵循权限最小化原则。 该接口可以使用全局区域的Endpoint和其他区域的Endpoint调用。IAM的Endpoint请参见：地区和终端节点。 使用获取到的临时AK/SK和securitytoken作为凭证访问云服务，临时AK/SK和securitytoken两者必须同时使用，请求头中需要添加“x-security-token”字段，使用方法详情请参考：使用临时AK/SK做签名。

响应示例 状态码为 201 时: 创建成功。 { "credential": { "access": "NZFAT5VNWEJDGZ4PZ...", "expires_at": "2020-01-08T03:50:07.574000Z", "secret": "riEoWsy3qO0BvgwfkoLVgCUvzgpjBBcvdq...", "securitytoken": "gQpjbi1ub3J0aC00jD4Ej..." } }

响应示例 状态码为 201 时: 创建成功。 { "credential": { "access": "NZFAT5VNWEJDGZ4PZ...", "expires_at": "2020-01-08T03:50:07.574000Z", "secret": "riEoWsy3qO0BvgwfkoLVgCUvzgpjBBcvdq...", "securitytoken": "gQpjbi1ub3J0aC00jD4Ej..." } }

请求示例 填写"token"参数。包含tokenId（即token）和临时访问密钥和securitytoken的有效期。 POST https://iam.myhuaweicloud.com/v3.0/OS-CREDENTIAL/securitytokens { "auth": { "identity": { "methods": [ "token" ], "token": { "id": "MIIEIgYJKoZIhvc...", "duration_seconds": "900" } } } } 不填写“token”参数（请求头中需要X-Auth-Token）。 POST https://iam.myhuaweicloud.com/v3.0/OS-CREDENTIAL/securitytokens { "auth": { "identity": { "methods": [ "token" ] } } } 填写“policy”参数。即用户自定义策略的信息，用于限制获取到的临时访问密钥和securitytoken的权限（当前仅适用限制OBS服务的权限）。如果填写此参数，则临时访问密钥和securitytoken的权限为：原token具有的权限和policy参数限制的权限交集。 POST https://iam.myhuaweicloud.com/v3.0/OS-CREDENTIAL/securitytokens { "auth": { "identity": { "methods": [ "token" ], "policy": { "Version": "1.1", "Statement": [ { "Effect": "Allow", "Action": [ "obs:object:GetObject" ], "Resource": [ "OBS:*:*:object:*" ], "Condition": { "StringEquals": { "g:DomainName": [ "DomainNameExample" //示例，表示限制条件值，根据实际情况填写 ] } } } ] }, "token": { "duration_seconds": 900 } } } }

功能介绍 该接口可以用于通过token来获取临时AK/SK和securitytoken。临时AK/SK和securitytoken是系统颁发给IAM用户的临时访问令牌，有效期可在15分钟至24小时范围内设置，过期后需要重新获取。临时AK/SK和securitytoken遵循权限最小化原则。 该接口可以使用全局区域的Endpoint和其他区域的Endpoint调用。IAM的Endpoint请参见：地区和终端节点。 使用获取到的临时AK/SK和securitytoken作为凭证访问云服务，临时AK/SK和securitytoken两者必须同时使用，请求头中需要添加“x-security-token”字段，使用方法详情请参考：使用临时AK/SK做签名。

响应参数 表8 响应Body参数 参数 参数类型 描述 credential Object 认证结果信息。 表9 credential 参数 参数类型 描述 expires_at String AK/SK和securitytoken的过期时间。响应参数为UTC时间格式，北京时间为UTC+8小时。 如返回： "expires_at": "2020-01-08T02:56:19.587000Z" 北京时间：2020-01-08 10:56:19.587 access String 获取的AK。 secret String 获取的SK。 securitytoken String securitytoken是将所获的AK、SK等信息进行加密后的字符串。

修订记录 发布时间 修改记录 2022-06-20 第四十九次正式发布。 新增章节：查询租户授权信息 2021-11-15 第四十八次正式发布。 新增如下章节： 查询企业项目直接关联用户 查询企业项目直接关联用户的权限 基于用户为企业项目授权 删除企业项目直接关联用户的权限 2021-05-15 第四十七次正式发布。 本次变更说明如下： 新增章节：企业项目管理 2021-02-01 第四十六次正式发布。 以下章节新增参数“access_mode”。 查询IAM用户详情（推荐） 管理员创建IAM用户（推荐） 管理员修改IAM用户信息（推荐） 2021-01-30 第四十五次正式发布。 获取自定义身份代理登录票据新增请求参数“duration_seconds”。 2021-01-21 第四十四次正式发布。 以下章节新增请求参数“page”、“per_page”，新增响应参数“total_number”： 查询权限列表 查询自定义策略列表 2020-11-09 第四十三次正式发布。 优化如下章节： 查询IAM用户详情（推荐） 新增如下章节： 修改IAM用户的登录保护状态信息 绑定MFA设备 解绑MFA设备 创建MFA设备 删除MFA设备 查询用户组的所有项目权限列表 查询用户组是否拥有所有项目指定权限 移除用户组的所有项目服务权限 2020-11-05 第四十二次正式发布。 新增如下章节： 创建OpenID Connect身份提供商配置 修改OpenID Connect身份提供商配置 查询OpenID Connect身份提供商配置 获取联邦认证token(OpenID Connect ID token方式) 获取联邦认证unscoped token(OpenID Connect ID token方式) 2020-08-27 第四十一次正式发布。 优化章节：授权项 2020-08-18 第四十次正式发布。 本次变更说明如下： 优化如下章节： 查询IAM用户详情（推荐） 新增如下章节： 查询项目配额 查询账号配额 查询IAM用户的MFA绑定信息列表 查询指定IAM用户的MFA绑定信息 查询IAM用户的登录保护状态信息列表 查询指定IAM用户的登录保护状态信息 查询委托下的所有项目服务权限列表 为委托授予所有项目服务权限 检查委托下是否具有所有项目服务权限 移除委托下的所有项目服务权限 安全设置 2020-07-15 第三十九次正式发布。 本次变更说明如下： 优化章节：授权项 2020-07-03 第三十八次正式发布。 本次变更说明如下： 优化章节：授权项 2020-06-19 第三十七次正式发布。 本次变更说明如下： 新增章节：错误码 2020-06-16 第三十六次正式发布。 本次变更说明如下： 优化章节：授权项 2020-06-08 第三十五次正式发布。 本次变更说明如下： 新增 API Explorer 跳转链接。 2020-05-30 第三十四次正式发布。 本次变更说明如下： 新增如下章节： 企业管理华为云上多租户的联邦认证 对IAM用户的权限进行安全审计 2020-05-21 第三十三次正式发布。 本次变更说明如下： 新增章节：密钥定期自动化轮换。 2020-02-24 第三十二次正式发布。 本次变更说明如下： 以下章节新增参数“policy”： 获取委托的临时访问密钥和securitytoken 获取用户的临时访问密钥和securitytoken 2020-02-17 第三十一次正式发布。 本次变更说明如下： 优化以下章节内容： 联邦身份认证管理 2020-02-10 第三十次正式发布。 本次变更说明如下： 优化以下章节内容： 委托管理 2020-02-06 第二十九次正式发布。 本次变更说明如下： 优化以下章节内容： 权限管理 自定义策略管理 自定义身份代理 版本信息管理 服务和终端节点 2020-01-23 第二十八次正式发布。 本次变更说明如下： 优化以下章节内容： Token管理 访问密钥管理 区域管理 项目管理 账号管理 IAM用户管理 用户组管理 2020-01-20 第二十七次正式发布。 本次变更说明如下： 新增如下章节： 为用户组授予所有项目服务权限 授权项 2019-11-01 第二十六次正式发布。 本次变更说明如下： 新增如下章节： 查询IAM用户详情 管理员创建IAM用户（推荐） 修改IAM用户信息（推荐） 管理员修改IAM用户信息（推荐） 2019-09-29 第二十五次正式发布。 本次变更说明如下： 新增如下章节： 自定义身份代理 2019-09-26 第二十四次正式发布。 本次变更说明如下： 获取账号、IAM用户、项目、用户组、区域、委托的名称和ID中新增通过调用API获取项目ID。 2019-08-15 第二十三次正式发布。 本次变更说明如下： 新增章节：自定义策略管理 调整全文内容：所有接口可以使用全局区域的 域名 和其他区域的域名调用。 2019-07-12 第二十二次正式发布。 本次变更说明如下： 新增如下章节： 创建永久访问密钥 查询所有永久访问密钥 查询指定永久访问密钥 修改指定永久访问密钥 删除指定永久访问密钥 修改获取账号、IAM用户、项目、用户组、区域、委托的名称和ID中的内容。 2019-05-07 第二十一次正式发布。 本次变更说明如下： 新增如下章节： 构造请求 认证鉴权 返回结果 2018-12-30 第二十次正式发布。 本次变更说明如下： 新增查询账号密码强度策略章节。 新增按条件查询账号密码强度策略章节。 管理员查询IAM用户列表请求体中新增“password_expires_at”查询条件。 查询IAM用户是否在用户组中请求体中新增“password_expires_at”查询条件。 2018-08-14 第十九次正式发布。 本次变更说明如下： 优化目录结构，方便用户查阅文档。 2018-06-29 第十八次正式发布。 本次变更说明如下： 将“相关参数信息获取”内容从“API说明”章节移到“环境准备”章节。 管理员查询IAM用户列表、查询IAM用户详情、查询IAM用户是否在用户组中、管理员创建IAM用户和管理员修改IAM用户信息响应体中新增“password_expires_at”（密码过期时间）字段。 2018-03-23 第十七次正式发布。 本次变更说明如下： 新增获取联邦认证unscoped token(IdP initiated)章节。 新增查询服务目录章节。 2018-02-28 第十六次正式发布。 新增获取用户的临时访问密钥和securitytoken章节。 2017-10-27 第十五次正式发布。 本次变更说明如下： 新增以下章节： 委托管理 获取委托Token 2017-09-24 第十四次正式发布。 本次变更说明如下： 删除查询终端节点列表章节中响应url中的tenant_id。 2017-08-28 第十三次正式发布。 本次变更说明如下： 新增设置项目状态章节。 2017-07-27 第十二次正式发布。 本次变更说明如下： 新增以下章节： 查询区域列表 查询区域详情 查询服务详情 查询终端节点详情 创建项目 修改项目信息 查询指定条件下的项目列表 2017-06-28 第十一次正式发布。 本次变更说明如下： 增加获取委托Token章节。 2017-06-09 第十次正式发布。 本次变更说明如下： 变更以下章节： 查询权限列表 查询权限详情 查询全局服务中的用户组权限 查询项目服务中的用户组权限 为用户组授予项目服务权限 获取IAM用户Token（使用密码） 查询身份提供商列表 查询身份提供商详情 修改SAML身份提供商配置 查询服务列表 2017-4-27 第九次正式发布。 本次变更说明如下： 增加以下章节： 管理员删除IAM用户 移除用户组中的IAM用户 查询用户组详情 查询用户组列表 创建用户组 添加IAM用户到用户组 更新用户组 删除用户组 查询IAM用户是否在用户组中 查询权限列表 查询权限详情 查询全局服务中的用户组权限 查询项目服务中的用户组权限 为用户组授予全局服务权限 为用户组授予项目服务权限 移除用户组的项目服务权限 移除用户组的全局服务权限 查询用户组是否拥有全局服务权限 查询用户组是否拥有项目服务权限 按照接口分类修改目录结构。 2017-03-28 第八次正式发布。 本次变更说明如下： 增加查询Keystone API的3.0版本信息 2017-01-20 第七次正式发布。 增加以下章节： 查询IAM用户可以访问的账号详情 查询IAM用户可以访问的项目列表 查询Keystone的Metadata文件 获取联邦认证scoped token 查询联邦用户可以访问的账号列表 2016-12-30 第六次正式发布 本次变更说明如下： GET /v3/projects接口的响应增加page字段（查询页面的数据）。 GET /v3/projects接口的响应增加per_page字段（页面数据个数）。 2016-10-29 第五次正式发布。 本次变更说明如下： 增加以下章节： 身份提供商 映射 协议 Metadata 2016-09-30 第四次正式发布。 本次变更说明如下： 增加以下章节： 管理员查询IAM用户列表 查询IAM用户详情 查询IAM用户是否在用户组中 管理员创建IAM用户 修改IAM用户密码 管理员删除IAM用户 查询项目服务中的用户组权限 2016-08-25 第三次正式发布。 本次变更说明如下： 增加token中各字段的含义。 2016-06-30 第二次正式发布。 本次变更说明如下： GET /v3/services接口的响应增加links字段（服务的链接）。 GET /v3/endpoints接口的响应增加links字段（终端地址的链接）。 2016-03-14 第一次正式发布。

安全设置 接口 说明 修改账号操作保护策略 该接口可以用于管理员修改账号操作保护策略。 查询账号操作保护策略 该接口可以用于查询账号操作保护策略。 修改账号密码策略 该接口可以用于管理员修改账号密码策略。 查询账号密码策略 该接口可以用于查询账号密码策略。 修改账号登录策略 该接口可以用于管理员修改账号登录策略。 查询账号登录策略 该接口可以用于查询账号登录策略。 修改账号控制台访问策略 该接口可以用于管理员修改账号控制台访问策略。 查询账号控制台访问策略 该接口可以用于查询账号控制台访问控制策略。 修改账号接口访问策略 该接口可以用于管理员修改账号接口访问策略。 查询账号接口访问策略 该接口可以用于查询账号接口访问控制策略。

联邦身份认证管理 接口 说明 通过联邦认证 获取Token （SP initiated方式） 通过Openstack Client和ShibbolethECP Client获取联邦认证Token。 通过联邦认证获取Token（IdP initiated方式） 以“Client4ShibbolethIdP”脚本为例，介绍IdP initiated方式获取联邦认证Token的方法。 查询身份提供商列表 该接口可以用于查询身份提供商列表。 查询身份提供商详情 该接口可以用于查询身份提供商详情。 创建身份提供商 该接口可以用于管理员注册身份提供商。 修改SAML身份提供商配置 该接口可以用于管理员更新身份提供商。 删除SAML身份提供商 该接口可以用于管理员删除身份提供商。 查询映射列表 该接口可以用于查询映射列表。 查询映射详情 该接口可以用于查询映射详情。 注册映射 该接口可以用于管理员注册映射。 更新映射 该接口可以用于管理员更新映射。 删除映射 该接口可以用于管理员删除映射。 查询协议列表 该接口可以用于查询协议列表。 查询协议详情 该接口可以用于查询协议详情。 注册协议 该接口可以用于管理员注册协议（将协议关联到某一身份提供商）。 更新协议 该接口可以用于管理员更新协议。 删除协议 该接口可以用于管理员删除协议。 查询Metadata文件 该接口可以用于管理员查询身份提供商导入到IAM中的Metadata文件。 查询Keystone的Metadata文件 该接口可以用于查询keystone的Metadata文件。 导入Metadata文件 该接口可以用于管理员导入Metadata文件。 获取联邦认证unscoped token(IdP initiated) 该接口可以用于通过IdP initiated的联邦认证方式获取unscoped token。 获取联邦认证scoped token 该接口可以用于通过联邦认证方式获取scoped token。 获取联邦认证token(OpenID Connect ID token方式) 该接口可以用于通过OpenID Connect ID token方式获取联邦认证token。 获取联邦认证unscoped token(OpenID Connect ID token方式) 该接口可以用于通过OpenID Connect ID token方式获取联邦认证unscoped token。 查询联邦用户可以访问的账号列表 该接口用于查询联邦用户可以访问的账号列表。