更新用户（组）与IAM委托的映射-UpdateAgencyMapping

功能介绍

更新用户（组）与IAM委托之间的映射关系。

接口约束

无

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和受限项。

如果使用身份策略授权，需具备如下身份策略权限。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
mrs:cluster:updateAgencyMapping	Write	cluster *	g:ResourceTag/<tag-key> g:EnterpriseProjectId	mrs:cluster:syncUser	iam:agencies:pass bms:servers:updateMetadata ecs:cloudServers:updateMetadata

URI

URI格式
 PUT /v2/{project_id}/clusters/{cluster_id}/agency-mapping

参数说明

表1 参数说明
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目编号。获取方法，请参见获取项目ID。约束限制：不涉及取值范围：只能由英文字母和数字组成，且长度为[1-64]个字符。默认取值：不涉及
cluster_id	是	String	参数解释：集群ID。获取方法，请参见获取集群ID。约束限制：不涉及取值范围：只能由英文字母、数字以及“_”和“-”组成，且长度为[1-64]个字符。默认取值：不涉及

请求参数

表2 请求参数说明
参数名	是否必选	参数类型	说明
agency_mappings	是	Array of AgencyMapping objects	参数解释：用户（组）与委托之间的映射关系详细信息，请参见表3。约束限制：不涉及取值范围：不涉及默认取值：不涉及

表3 agency_mappings参数说明
参数名	是否必选	参数类型	说明
agency	是	String	参数解释：该映射绑定的IAM委托名称。约束限制：不涉及取值范围：不涉及默认取值：不涉及
identifier_type	是	String	参数解释：委托类型，分为“User”和“Group”两种。约束限制：不涉及取值范围： User：表示该映射关系为针对用户的映射，identifiers中填写用户名称列表。 Group：表示该映射关系为针对用户组的映射，identifiers中填写用户组名称列表。默认取值：不涉及
identifiers	是	Array of String	参数解释： IAM委托映射的用户（组）名称列表。请前往IAM，单击“用户（组）”按钮，获取用户（组）名称列表。约束限制：不涉及取值范围：不涉及默认取值：不涉及
agency_id	是	String	参数解释：该映射关系绑定的委托的唯一标识码。请前往IAM，单击“委托”按钮，进入委托页面，将鼠标放置委托名称上，在弹窗中获取委托唯一标识码。约束限制：不涉及取值范围：不涉及默认取值：不涉及

响应参数

状态码：200

表4 响应Body参数
参数名	参数类型	说明
result	String	参数解释：更新映射请求操作结果。约束限制：不涉及取值范围： succeeded：操作成功 failed：操作失败默认取值：不涉及

状态码：400

表5 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。约束限制：不涉及取值范围：不涉及默认取值：不涉及
error_msg	String	参数解释：错误描述。约束限制：不涉及取值范围：不涉及默认取值：不涉及

请求示例

更新用户（组）与IAM委托的映射关系示例

PUT https://{endpoint}/v2/{project_id}/clusters/{cluster_id}/agency-mapping

{
  "agency_mappings" : [ {
    "agency" : "agency01",
    "identifier_type" : "User",
    "identifiers" : [ "test" ],
    "agency_id" : "xxxx"
  } ]
}