調用GetRole介面擷取角色資訊。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

請求參數

名稱 類型 是否必選 樣本值 描述
Action String 是 GetRole

系統規定參數。取值：GetRole。
RoleName String 是 ECSAdmin

指定角色名稱。

長度為1~64個字元，可包含英文字母、數字、點號（.）和虛線（-）。

返回資料

名稱 類型 樣本值 描述
RequestId String 04F0F334-1335-436C-A1D7-6C044FE73368

請求ID。
Role Struct

角色資訊。
Arn String acs:ram::123456789012****:role/ECSAdmin

角色的資源描述符。
AssumeRolePolicyDocument String { "Statement": [ { "Action": "sts:AssumeRole", "Effect": "Allow", "Principal": { "RAM": "acs:ram::123456789012****:root" } } ], "Version": "1" }

扮演角色的權限原則。
CreateDate String 2015-01-23T12:33:18Z

建立時間。
Description String ECS管理角色

角色描述。
MaxSessionDuration Long 3600

角色最大會話時間。
RoleId String 901234567890****

角色ID。
RoleName String ECSAdmin

角色名稱。
UpdateDate String 2015-01-23T12:33:18Z

更新時間。

樣本

請求樣本

https://ram.aliyuncs.com/?Action=GetRole
&RoleName=ECSAdmin
&<公用請求參數>

正常返回樣本

XML 格式 

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

錯誤碼

訪問錯誤中心查看更多錯誤碼。