统一身份认证服务 IAM-创建委托自定义策略:请求参数

时间:2024-08-21 15:43:13

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

该字段内容填为“application/json;charset=utf8”。

X-Auth-Token

String

访问令牌,承载用户的身份、权限等信息。

token所需权限请参见授权项

表2 请求Body参数

参数

是否必选

参数类型

描述

role

Object

自定义策略信息。

表3 role

参数

是否必选

参数类型

描述

display_name

String

自定义策略展示名,长度1~128字符之间。

type

String

自定义策略的显示模式。

说明:
  • AX:全局服务。
  • XA:区域级项目。
  • 自定义策略的显示模式只能为AX或者XA,不能同时在全局服务和区域级项目生效(AA),或者在全局服务和区域级项目都不生效(XX)。

description

String

自定义策略的描述信息。

description_cn

String

自定义策略的中文描述信息。

policy

Object

自定义策略的具体内容。

表4 role.policy

参数

是否必选

参数类型

描述

Version

String

权限版本号,创建自定义策略时,该字段值填为“1.1”。

说明:
  • 1.0:系统预置的角色。以服务为粒度,提供有限的服务相关角色用于授权。
  • 1.1:策略。 IAM 最新提供的一种细粒度授权的能力,可以精确到具体服务的操作、资源以及请求条件等。

Statement

Array of objects

授权语句,描述自定义策略的具体内容。

表5 role.policy.Statement

参数

是否必选

参数类型

描述

Action

Array of strings

授权项,指对资源的具体操作权限。支持的授权项请参考各云服务《API参考》中“权限和授权项”章节。

说明:
  • 当自定义策略为委托自定义策略时,该字段值为: "Action": ["iam:agencies:assume"]

取值范围:

  • iam:agencies:assume

Effect

String

作用。包含两种:允许(Allow)和拒绝(Deny),既有Allow又有Deny的授权语句时,遵循Deny优先的原则。

取值范围:

  • Allow
  • Deny

Resource

Object

委托资源。在有其他账号与您创建了多个委托关系,即您是被委托方,需要将委托中的权限授权给不同的用户组,这些用户组中的IAM用户进行角色切换时,仅能切换到被授权的委托中,不能切换其他委托。例:

"Resource": {"uri": ["/iam/agencies/07805acaba800fdd4fbdc00b8f888c7c"]}
表6 role.policy.Statement.Resource

参数

是否必选

参数类型

描述

uri

Array of strings

委托资源的URI,长度不超过128。格式为:/iam/agencies/委托ID。例:

"uri": ["/iam/agencies/07805acaba800fdd4fbdc00b8f888c7c"]
support.huaweicloud.com/api-iam/iam_02_0016.html