文档首页/ MapReduce服务 MRS/ API参考/ API V2/ 委托管理/ 查询用户(组)与IAM委托的映射关系
更新时间:2024-08-16 GMT+08:00
分享

查询用户(组)与IAM委托的映射关系

功能介绍

获取用户(组)与IAM委托之间的映射关系的详细信息。

接口约束

调用方法

请参见如何调用API

URI

GET /v2/{project_id}/clusters/{cluster_id}/agency-mapping

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目编号。获取方法,请参见获取项目ID

约束限制:

不涉及

取值范围:

只能由英文字母和数字组成,且长度为[1-64]个字符。

默认取值:

不涉及

cluster_id

String

参数解释:

集群ID。如果指定集群ID,则获取该集群做过补丁更新的最新版本元数据。获取方法,请参见获取集群ID

约束限制:

不涉及

取值范围:

只能由英文字母、数字以及“_”和“-”组成,且长度为[1-64]个字符。

默认取值:

不涉及

请求参数

响应参数

状态码: 200

表2 响应Body参数

参数

参数类型

描述

agency_mappings

Array of AgencyMapping objects

参数解释:

用户(组)与委托之间的映射关系详细信息。

约束限制:

不涉及

表3 AgencyMapping

参数

参数类型

描述

agency

String

参数解释:

该映射绑定的IAM委托名称。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

identifier_type

String

参数解释:

委托类型,分为“User”和“Group”两种。

约束限制:

不涉及

取值范围:

  • User:表示该映射关系为针对用户的映射,identifiers中填写用户名称列表。

  • Group:表示该映射关系为针对用户组的映射,identifiers中填写用户组名称列表。

默认取值:

不涉及

identifiers

Array of strings

参数解释:

IAM委托映射的用户(组)名称列表。请前往IAM,单击“用户(组)”按钮,获取用户(组)名称列表。获取方法,请参见获取委托用户组名称

约束限制:

不涉及

agency_id

String

参数解释:

该映射关系绑定的委托的唯一标识码。请前往IAM,单击“委托”按钮,进入委托页面,将鼠标放置委托名称上,在弹窗中获取委托唯一标识码。获取方法,请参见获取委托名称和ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

状态码: 400

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

不涉及

error_msg

String

参数解释:

错误描述。

取值范围:

不涉及

请求示例

响应示例

状态码: 200

查询用户(组)与IAM委托的映射关系成功

{
  "agency_mappings" : [ {
    "agency" : "agency01",
    "identifier_type" : "User",
    "identifiers" : [ "user01" ],
    "agency_id" : "092adc623c00d2ea4fdac01d4b637f0b"
  }, {
    "agency" : "agency02",
    "identifier_type" : "User",
    "identifiers" : [ "user02" ],
    "agency_id" : "065239307e00d3ae4f80c01d4bdafdfd"
  }, {
    "agency" : "groupAgency",
    "identifier_type" : "Group",
    "identifiers" : [ "group01", "group02", "group03" ],
    "agency_id" : "08467a446200d5ac4ff9c01d56670c3b"
  } ]
}

状态码

状态码

描述

200

查询用户(组)与IAM委托的映射关系成功

400

查询用户(组)与IAM委托的映射关系失败

错误码

请参见错误码

相关文档