Removing an ECS from an ECS Group

Function

This API is used to remove an ECS from an ECS group. The anti-affinity policy will not be applied to the ECS after it is removed from the 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:deleteServerGroupMember.

Debugging

You can debug this API in API Explorer.

Authorization

Each account has all of the permissions required to call all APIs, but IAM users must have the required permissions specifically assigned.

If you are using role/policy-based authorization, see the required permissions in Permissions and Supported Actions.
If you are using identity policy-based authorization, the permissions listed below are required.

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
ecs:cloudServers:deleteServerGroupMember	write	-	-	ecs:cloudServers:delete	-

URI

POST /v1/{project_id}/cloudservers/os-server-groups/{server_group_id}/action

Table 1 describes the parameters in the URI.

**Table 1** Parameter description
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.

**Table 2** Request parameters
Parameter	Mandatory	Type	Description
remove_member	Yes	Object	Specifies the information of the ECS to be removed from an ECS group.

**Table 3** **remove_member** parameters
Parameter	Mandatory	Type	Description
instance_uuid	Yes	String	Specifies the ECS UUID.

Response

None

Example Request

Delete the ECS whose UUID is 34dac9a0-c4a7-457b-bab2-e2c696e0e401 from the specified ECS group.

POST https://{endpoint}/v1/{project_id}/cloudservers/os-server-groups/{server_group_id}/action

{
    "remove_member": {
        "instance_uuid": "34dac9a0-c4a7-457b-bab2-e2c696e0e401"
    }
}