Detaches an instance RAM role from one or more ECS instances.
Debugging
Authorization information
There is currently no authorization information disclosed in the API.
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
RegionId | string | Yes | The region ID. You can call the DescribeRegions operation to query the most recent region list. | cn-hangzhou |
RamRoleName | string | No | The name of the instance RAM role. You can call the ListRoles operation provided by RAM to query the instance RAM roles that you created. | RamRoleTest |
InstanceIds | string | Yes | The IDs of instances. The value can be a JSON array that consists of up to 100 instance IDs. Separate the IDs with commas (,). | ["i-bp67acfmxazb4p****", "i-bp67acfmxazb5p****", "i-bp67acfmxazb6p****"…] |
Response parameters
Examples
Sample success responses
JSON
format
{
"RamRoleName": "RamRoleTest",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"TotalCount": 1,
"FailCount": 0,
"DetachInstanceRamRoleResults": {
"DetachInstanceRamRoleResult": [
{
"Code": "200",
"Message": "Success",
"InstanceId": "i-bp67acfmxazb4p****",
"Success": true,
"InstanceRamRoleSets": {
"InstanceRamRoleSet": [
{
"RamRoleName": "RamRoleTest",
"InstanceId": "i-bp67acfmxazb4p****"
}
]
}
}
]
}
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | InvalidInstanceIds.Malformed | The specified instanceIds are not valid. | Multiple specified instance IDs are invalid. |
403 | InvalidNetworkType.MismatchRamRole | Ram role cannot be applied to instances of Classic network type. | Instance RAM roles can be used only for instances of the VPC type, not for instances of the classic network type. |
403 | InvalidUser.PassRoleForbidden | The RAM user does not have the privilege to pass a RAM role. | The RAM user is not authorized to pass a RAM role. |
404 | InvalidInstanceId.NotFound | The specified instanceId does not exist. | The specified instance does not exist. |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation |
---|
No change history