收回一台或多台 ECS 实例的实例 RAM 角色。

请求参数

名称 类型 是否必需 描述
Action String 系统规定参数。取值:DetachInstanceRamRole
RegionId String 地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。
InstanceIds String 指定收回的实例 ID 的集合。最多支持一次查询 100 台实例,格式为 ["instanceId1", "instanceId2", "instanceId3"…]。
RamRoleName String 收回赋予了某一实例 RAM 角色的所有 ECS 实例。您可以使用 RAM API ListRoles 查询实例RAM角色名称。参考相关 API CreateRoleListRoles

返回参数

名称 类型 描述
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 不存在。