513      阿里云

GetRole__角色管理接口_RAM API文档_访问控制-阿里云

接口描述

　获取角色信息

请求参数

Action

• 类型：String
• 必须：是
• 描述：操作接口名，系统规定参数，取值：GetRole

RoleName

• 类型：String
• 必须：是
• 描述：指定角色名，最多包含64个字符
• 格式：^[a-zA-Z0-9.@-]+$

需要的权限

Action

ram:GetRole

Resource

acs:ram:*:${AccountId}:role/*

返回参数

Role

• 类型：Role Type
• 描述：角色信息

错误信息

InvalidParameter.RoleName.InvalidChars

• HTTP Status：400
• Error Message：The parameter - "RoleName" contains invalid chars.

InvalidParameter.RoleName.Length

• HTTP Status：400
• Error Message：The parameter - "RoleName" beyond the length limit.

EntityNotExist.Role

• HTTP Status：404
• Error Message：The role does not exist.

操作示例

请求示例

https://ram.aliyuncs.com/?Action=GetRole
&RoleName=ECSAdmin
&<公共请求参数>

返回示例

XML格式

<GetRoleResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
    <Role>
        <RoleId>901234567890123</RoleId>
        <RoleName>ECSAdmin</RoleName>
        <Arn>acs:ram::1234567890123456:role/ECSAdmin</Arn>
        <Description>ECS管理角色</Description>
        <AssumeRolePolicyDocument>{ "Statement": [ { "Action": "sts:AssumeRole", "Effect": "Allow", "Principal": { "RAM": "acs:ram::123456789012345678:root" } } ], "Version": "1" }</AssumeRolePolicyDocument>
        <CreateDate>2015-01-23T12:33:18Z</CreateDate>
        <UpdateDate>2015-01-23T12:33:18Z</UpdateDate>
    </Role>
</GetRoleResponse>

JSON格式

{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
    "Role": {
        "RoleId": "901234567890123",
        "RoleName": "ECSAdmin",
        "Arn": "acs:ram::1234567890123456:role/ECSAdmin",
        "Description": "ECS管理角色",
        "AssumeRolePolicyDocument": "{ "Statement": [ { "Action": "sts:AssumeRole", "Effect": "Allow", "Principal": { "RAM": "acs:ram::123456789012345678:root" } } ], "Version": "1" }",
        "CreateDate": "2015-01-23T12:33:18Z",
        "UpdateDate": "2015-01-23T12:33:18Z"
    }
}

最后更新：2016-11-23 17:16:05

  上一篇： CreateRole__角色管理接口_RAM API文档_访问控制-阿里云

  下一篇： UpdateRole__角色管理接口_RAM API文档_访问控制-阿里云