收回一台或多台 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)組成的資訊集。 |
樣本
請求樣本
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 不存在。 |