收回一台或多台 ECS 執行個體的 執行個體 RAM 角色

請求參數

名稱 類型 是否必需 描述
Action String 系統規定參數。取值:DetachInstanceRamRole
RegionId String 地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
InstanceIds String 指定收回的執行個體 ID 的集合。最多支援一次查詢 100 台執行個體,格式為 ["instanceId1", "instanceId2", "instanceId3"…]。
RamRoleName String 收回賦予了某一執行個體 RAM 角色的所有 ECS 執行個體。您可以使用 RAM API 查詢執行個體RAM角色名稱稱。參考相關 API 。

返回參數

名稱 類型 描述
TotalCount Integer 收回的執行個體 RAM 角色的總個數。
FailCount Integer 收回失敗的執行個體 RAM 角色的個數。
RamRoleName String 收回執行個體 RAM 角色的名稱。
DetachInstanceRamRoleResults Array 由執行個體 RAM 角色類型(DetachInstanceRamRoleResult)組成的資訊集。
資料類型 DetachInstanceRamRoleResult
名稱 類型 描述
InstanceId String 準備收回執行個體 RAM 角色的 ECS 執行個體。
Code Integer 判斷是否成功收回執行個體 RAM 角色。傳回值為 200 表示成功收回,返回其他值表示收回失敗,失敗原因參閱 錯誤碼
Message String 判斷是否成功收回執行個體 RAM 角色。傳回值為 Success 表示成功收回,返回其他值表示收回失敗,失敗原因參閱 錯誤碼

樣本

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

XML 格式

<DetachInstanceRamRoleResponse>
    <RequestId>E6352369-5C2B-41CD-AB50-471550C8F674</RequestId>
    <DetachInstanceRamRoleResults>
        <DetachInstanceRamRoleResult>
             <InstanceId>i-instance1</InstanceId>
             <Code>200</Code>
             <Message>success</Message>
        </DetachInstanceRamRoleResult>
    </DetachInstanceRamRoleResults>
    <TotalCount>1</TotalCount>
    <FailCount>0</FailCount>
    <RamRoleName>RamRoleTest</RamRoleName>
</DetachInstanceRamRoleResponse>
JSON 格式
{
    "RequestId": "E6352369-5C2B-41CD-AB50-471550C8F674",
    "DetachInstanceRamRoleResults": {
        "DetachInstanceRamRoleResult": [
            {
                "Message": "success",
                "InstanceId": "i-instance1",
                "Code": "200"
            }
        ]
    },
    "TotalCount": 1,
    "FailCount": 0,
    "RamRoleName": "RamRoleTest"
}

錯誤碼

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

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
MissingParameter.InstanceIds The input parameter InstanceIds that is mandatory for processing this request is missing. 400 缺少必填參數 InstanceIds。
MissingParameter.RegionId The input parameter RegionId that is mandatory for processing this request is missing. 400 缺少必填參數 RegionId。
InvalidInstanceIds.Malformed The specified InstanceIds is not valid. 400 指定的 InstanceIds 不合法。
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 RAM 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 不存在。