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

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

功能介绍

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

接口约束

调试

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

URI

  • URI格式

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

  • 参数说明
    表1 参数说明

    参数

    是否必选

    参数类型

    描述

    project_id

    String

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

    cluster_id

    String

    集群ID。获取方法,请参见获取集群ID

请求参数

无。

响应参数

状态码:200

表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,单击“委托”按钮,进入委托页面,将鼠标放置委托名称上,在弹窗中获取委托唯一标识码。

状态码:400

表4 响应参数说明

参数名

参数类型

描述

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"
  } ]
}

状态码

状态码请参见状态码

错误码

请参见错误码