為一台或多台 ECS 執行個體授予 執行個體 RAM 角色。如果執行個體已有 RAM 角色，則報錯提示您不能附加新的角色。

請求參數

名稱 類型 是否必需 描述
Action String 是 系統規定參數。取值：AttachInstanceRamRole
RegionId String 是 地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
InstanceIds Array 是 執行個體 ID 的集合，最多 100 台執行個體，[“instanceId1”, “instanceId2”, “instanceId3”…]。
RamRoleName String 是 執行個體 RAM 角色名稱稱。您可以使用 RAM API 查詢執行個體RAM角色名稱稱。參考相關 API。

返回參數

全是公共返回參數。詳見公共參數

樣本

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

XML 格式

<AttachInstanceRamRoleResponse>
    <RequestId>E6352369-5C2B-41CD-AB50-471550C8F674</RequestId>
    <AttachInstanceRamRoleResults>
        <AttachInstanceRamRoleResult>
             <InstanceId>i-instance1</InstanceId>
             <Code>200</Code>
             <Message>success</Message>
        </AttachInstanceRamRoleResult>
    </AttachInstanceRamRoleResults>
    <TotalCount>1</TotalCount>
    <FailCount>0</FailCount>
    <RamRoleName>RamRoleTest</RamRoleName>
</AttachInstanceRamRoleResponse>
JSON 格式 
{
    "RequestId": "D9553E4C-6C3A-4D66-AE79-9835AF705639",
    "AttachInstanceRamRoleResults": {
        "AttachInstanceRamRoleResult": [
            {
                "Message": "success",
                "InstanceId": "i-instance1",
                "Code": "200"
            }
        ]
    },
    "TotalCount": 1,
    "FailCount": 0,
    "RamRoleName": "RamRoleTest"
}

錯誤碼

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

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
InvalidInstanceIds.Malformed The specified InstanceIds is not valid. 400 指定的 InstanceIds 不合法。
MissingParameter.InstanceIds The input parameter InstanceIds that is mandatory for processing this request is missing. 400 缺少必需參數 InstanceIds。
MissingParameter.RamRoleName The input parameter RamRoleName that is mandatory for processing this request is missing. 400 缺少必填參數 RamRoleName。
MissingParameter.RegionId The input parameter RegionId that is mandatory for processing this request is missing. 400 缺少必填參數 RegionId。
InvalidNetworkType.MismatchRamRole Ram role cannot be attached to instances of Classic network type. 403 執行個體 RAM 角色功能不能被用於經典網路執行個體。
InvalidUser.PassRoleForbidden The RAM user does not have the privilege to pass a role. 403 您使用的 RAM 使用者帳號暫不具有 PassRole 的許可權，請聯繫主帳號擁有者 授權 PassRole 許可權。
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的執行個體 ID 不存在。
InvalidRamRole.NotFound The specified RamRoleName does not exist. 404 指定的 RamRoleName 不存在。