Removing an ECS from an ECS Group
Function
This API is used to remove an ECS from an ECS group. After being removed, the anti-affinity policy will not take effect on this ECS and other ECSs in the same ECS group.
Constraints
Only the anti-affinity policy is supported. ECSs in the same ECS group are deployed on different hosts, improving service reliability.
This API supports checking fine-grained permissions for enterprise projects. For details, see ecs:cloudServers:delete.
URI
POST /v1/{project_id}/cloudservers/os-server-groups/{server_group_id}/action
Table 1 describes the parameters in the URI.
Parameter | Mandatory | Description |
---|---|---|
project_id | Yes | Specifies the project ID. For details about how to obtain the ID, see Obtaining a Project ID. |
server_group_id | Yes | Specifies the ECS group ID. |
Request
Table 2 describes the request parameters.
Parameter | Mandatory | Type | Description |
---|---|---|---|
remove_member | Yes | Object | Specifies the information of the ECS to be removed from an ECS group. |
Parameter | Mandatory | Type | Description |
---|---|---|---|
instance_uuid | Yes | String | Specifies the ECS UUID. |
Response
None
Example Request
POST https://{endpoint}/v1/{project_id}/cloudservers/os-server-groups/{server_group_id}/action
{"remove_member": {"instance_uuid": "34dac9a0-c4a7-457b-bab2-e2c696e0e401"}}
Example Response
Status code 200, indicating that the operation is successful
Returned Values
Error Codes
See Error Codes.
- Function
- Constraints
- URI
- Request
- Response
- Example Request
- Example Response
- Returned Values
- Error Codes