調用GetRole獲取角色信息。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String 是 GetRole

要執行的操作。取值：GetRole。
RoleName String 是 ECSAdmin

角色名稱。

長度為1~64個字符，可包含英文字母、數字、點號（.）和短橫線（-）。
Language String 否 zh-CN

語言類型。角色描述將以此語言返回。

  • en：英文。
  • zh-CN：中文。
  • ja：日文。

返回數據

名稱 類型 示例值 描述
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::12345678901234****:root\" } } ], \"Version\": \"1\" }

扮演角色的權限策略內容。
CreateDate String 2015-01-23T12:33:18Z

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

角色描述。
IsServiceLinkedRole Boolean true

是否為服務關聯角色。
LatestDeletionTask Struct

最近一次刪除任務信息。
CreateDate String 2018-10-23T12:33:18Z

刪除任務創建時間。
DeletionTaskId String ECSAdmin/cc61514b-26eb-4453-ab53-b142eb702a3d

刪除任務ID。
MaxSessionDuration Long 3600

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

角色ID。
RoleName String ECSAdmin

角色名稱。
RolePrincipalName String ECSAdmin@role.123456.onaliyunservice.com

被授權角色名稱。
UpdateDate String 2016-01-23T12:33:18Z

角色更新時間。

示例

請求示例

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

正常返回示例

XML 格式 

<GetRoleResponse>
	  <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
	  <Role>
		    <RoleId>90123456789****</RoleId>
		    <RoleName>ECSAdmin</RoleName>
		    <RolePrincipalName>ECSAdmin@role.123456.onaliyunservice.com</RolePrincipalName>
		    <Arn>acs:ram::123456789012****:role/ECSAdmin</Arn>
		    <IsServiceLinkedRole>true</IsServiceLinkedRole>
		    <LatestDeletionTask>
			      <CreateDate>2018-10-23T12:33:18Z</CreateDate>
			      <DeletionTaskId>ECSAdmin/cc61514b-26eb-4453-ab53-b142eb702a3d</DeletionTaskId>
		    </LatestDeletionTask>
		    <Description>ECS管理角色</Description>
            <MaxSessionDuration>3600</MaxSessionDuration>
		    <AssumeRolePolicyDocument>{ "Statement": [ { "Action": "sts:AssumeRole", "Effect": "Allow", "Principal": { "RAM": "acs:ram::12345678901234****:root" } } ], "Version": "1" }</AssumeRolePolicyDocument>
		    <CreateDate>2015-01-23T12:33:18Z</CreateDate>
		    <UpdateDate>2016-01-23T12:33:18Z</UpdateDate>
	  </Role>
</GetRoleResponse>

JSON 格式 

{
	"RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
	"Role": {
		"RoleId": "90123456789****",
		"RoleName": "ECSAdmin",
		"RolePrincipalName": "ECSAdmin@role.123456.onaliyunservice.com",
		"Arn": "acs:ram::123456789012****:role/ECSAdmin",
		"IsServiceLinkedRole": true,
		"LatestDeletionTask": {
			"CreateDate": "2018-10-23T12:33:18Z",
			"DeletionTaskId": "ECSAdmin/cc61514b-26eb-4453-ab53-b142eb702a3d"
		},
		"Description": "ECS管理角色",
        "MaxSessionDuration": 3600,
		"AssumeRolePolicyDocument": "{ \"Statement\": [ { \"Action\": \"sts:AssumeRole\", \"Effect\": \"Allow\", \"Principal\": { \"RAM\": \"acs:ram::12345678901234****:root\" } } ], \"Version\": \"1\" }",
		"CreateDate": "2015-01-23T12:33:18Z",
		"UpdateDate": "2016-01-23T12:33:18Z"
	}
}

錯誤碼

HttpCode 錯誤碼 錯誤信息 描述
400 InvalidParameter.RoleName.InvalidChars The specified role name contains invalid characters. 角色名稱包含無效字符。
400 InvalidParameter.RoleName.Length The maximum length of the role name is exceeded. 角色名稱長度超出限制。
404 EntityNotExist.Role The role does not exist. 角色不存在。

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