調用ListRoles介面列出角色。

調試

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

請求參數

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

系統規定參數。取值：ListRoles。
Marker String 否 EXAMPLE

當請求的返回結果被截斷時，可以使用Marker擷取從當前截斷位置之後的內容。

MaxItems Integer 否 100

返回結果的條數。當返回結果達到MaxItems限制被截斷時，返回參數IsTruncated將等於true。

取值範圍：1 ~ 1000。預設值：100。

返回資料

名稱 類型 樣本值 描述
IsTruncated Boolean true

請求返回結果是否被截斷。
Marker String EXAMPLE

當IsTruncated為true時才有此欄位。當返回true時，需要繼續調用此介面，並且使用Marker擷取截斷後的內容。

RequestId String 7B8A4E7D-6CFF-471D-84DF-195A7A241ECB

請求ID。
Roles Array

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

角色的資源描述符。
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=ListRoles
&<公用請求參數>

正常返回樣本

XML 格式 

<ListRolesResponse>
	  <RequestId>7B8A4E7D-6CFF-471D-84DF-195A7A241ECB</RequestId>
	  <IsTruncated>true</IsTruncated>
	  <Marker>EXAMPLE</Marker>
	  <Roles>
		    <Role>
			      <RoleId>901234567890****</RoleId>
			      <RoleName>ECSAdmin</RoleName>
			      <Arn>acs:ram::123456789012****:role/ECSAdmin</Arn>
			      <Description>ECS管理角色</Description>
			      <MaxSessionDuration>3600</MaxSessionDuration>
			      <CreateDate>2015-01-23T12:33:18Z</CreateDate>
			      <UpdateDate>2015-01-23T12:33:18Z</UpdateDate>
		    </Role>
		    <Role>
			      <RoleId>901234567890****</RoleId>
			      <RoleName>OSSReadonlyAccess</RoleName>
			      <Arn>acs:ram::123456789012****:role/OSSReadonlyAccess</Arn>
			      <Description>OSS唯讀訪問角色</Description>
			      <MaxSessionDuration>3600</MaxSessionDuration>
			      <CreateDate>2015-01-23T12:33:18Z</CreateDate>
			      <UpdateDate>2015-01-23T12:33:18Z</UpdateDate>
		    </Role>
	  </Roles>
</ListRolesResponse>

JSON 格式 

{
    "RequestId": "7B8A4E7D-6CFF-471D-84DF-195A7A241ECB",
    "IsTruncated": true,
    "Marker": "EXAMPLE",
    "Roles": {
        "Role": [
            {
                "RoleId": "901234567890****",
                "RoleName": "ECSAdmin",
                "Arn": "acs:ram::123456789012****:role/ECSAdmin",
                "Description": "ECS管理角色",
                "MaxSessionDuration": 3600,
                "CreateDate": "2015-01-23T12:33:18Z",
                "UpdateDate": "2015-01-23T12:33:18Z"
            },
            {
                "RoleId": "901234567890****",
                "RoleName": "OSSReadonlyAccess",
                "Arn": "acs:ram::123456789012****:role/OSSReadonlyAccess",
                "Description": "OSS唯讀訪問角色",
                "MaxSessionDuration": 3600,
                "CreateDate": "2015-01-23T12:33:18Z",
                "UpdateDate": "2015-01-23T12:33:18Z"
            }
        ]
    }
}

錯誤碼

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