帮助与文档

    搜索
    • 云服务器
    • 弹性IP
    • VPC
    • CDN
    • IAM

    文档中心

    访问控制

    金山云 > 文档中心 > 访问控制 > API文档 > 角色管理

    查询角色基本信息

    最近更新时间：2017-12-21 21:18:02

    查询角色基本信息(GetRole)

    概述

    查询角色基本信息。金山云账号或被授权的子用户可以调用该接口。

    openAPI接口

    请求参数
    名称 类型 必须 长度限制(字符) 参数格式 描述
    Action String 是 GetRole action名称
    RoleName String 是 最短1,最长64 [\w+=,[email protected]]+
    返回元素（调用成功）
    名称 类型 描述
    Role 新创建的角色基本信息

    错误码（调用不成功）

    错误代码 描述 HTTP 状态码 语义
    InvalidParameterValue An invalid or out-of-range value was supplied for the input parameter. 400 参数格式/取值范围不对，具体参数名在错误消息中说明
    NoSuchEntity The request was rejected because it referenced a resource that does not exist 404 实体不存在，具体实体名称在错误消息中说明
    示例（调用成功）
    请求示例
    https://iam.cn-beijing-6.api.ksyun.com/?Action=GetRole
&RoleName=roleTest
&Version=2015-11-01
&AUTHPARAMS
    返回示例
    • XML示例
    <GetRoleResponse>
  <GetRoleResult>
    <Role>
      <Path>/ksc/iam/</Path>
      <Krn>krn:kcs:iam::213:role/ksc/iam/roleTest</Krn>
      <RoleName>roleTest</RoleName>
      <Description>这个一个测试使用的Role</Description>
      <TrustAccounts>123123,456456,789679</TrustAccounts>
      <CreateDate>2017-02-08T23:34:01.495Z</CreateDate>
      <RoleId>AROADBQP57FF2AEXAMPLE</RoleId>
    </Role>
  </GetRoleResult>
  <ResponseMetadata>
    <RequestId>4a93ceee-9966-11e1-b624-b1aEXAMPLE7c</RequestId>
  </ResponseMetadata>
</GetRoleResponse>

    返回角色管理一览表

    金山云，开启您的云计算之旅

    免费注册