查詢一台或者多台 ECS 執行個體上的已賦予的 執行個體 RAM 角色。

請求參數

名稱 類型 是否必需 描述
Action String 是 系統規定參數。取值：DescribeInstanceRamRole
InstanceIds String 是 指定查詢的執行個體 ID 的集合。最多支援一次查詢 100 台執行個體，格式為 ["instanceId1", "instanceId2", "instanceId3"…]。
RamRoleName String 否 查詢賦予了某一執行個體 RAM 角色的所有 ECS 執行個體。您可以使用 RAM API ListRoles 查詢您已建立的執行個體 RAM 角色。
PageNumber Integer 否 當前頁碼，起始值：1

預設值：1
PageSize Integer 否 分頁查詢時設定的每頁行數，最大值：50

預設值：10

返回參數

名稱 類型 描述
InstanceRamRoleSets Array 由執行個體 RAM 角色類型（InstanceRamRoleSetType）組成的資訊集

樣本

請求樣本 
https://ecs.aliyuncs.com/?Action=DescribeInstanceRamRole
&RegionId=cn-hangzhou
&InstanceIds=["i-instance1"]
&<公共請求參數>
返回樣本

XML 格式

<DescribeInstanceRamRoleResponse>
    <RequestId>8F4CAE3F-7892-4662-83A5-2C2FFD639553</RequestId>
    <InstanceRamRoleSets>
        <InstanceRamRoleSet>
             <InstanceId>i-instance1</InstanceId>
              <RamRoleName>RamRoleTest</RamRoleName>
        </InstanceRamRoleSet>
    </InstanceRamRoleSets>
    <TotalCount>1</TotalCount>
</DescribeInstanceRamRoleResponse>
JSON 格式 
{
    "RequestId": "8F4CAE3F-7892-4662-83A5-2C2FFD639553",
    "InstanceRamRoleSets": {
        "InstanceRamRoleSet": [
            {
                "InstanceId": "i-instance1",
                "RamRoleName": "RamRoleTest"
            }
        ]
    },
    "TotalCount": 1
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼，請訪問 API 錯誤中心 。

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
InvalidInstanceIds.Malformed The specified InstanceIds is not valid. 400 指定的 InstanceIds 不合法。
InvalidNetworkType.MismatchRamRole Ram role cannot be attached to instances of Classic network type. 403 您指定的參數 InstanceIds 中包含了經典網路執行個體，執行個體 RAM 角色不支援經典網路類型。
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的執行個體 ID 不存在。
InvalidRamRole.NotFound The specified RamRoleName does not exist. 404 指定的 RamRoleName 不存在。