Help Center/ Elastic Cloud Server/ API Reference/ APIs (Recommended)/ ECS Group Management/ Deleting an ECS Group
Updated on 2026-03-18 GMT+08:00
View PDF

Deleting an ECS Group

Function

This API is used to delete an ECS group.

URI

DELETE /v1/{project_id}/cloudservers/os-server-groups/{server_group_id}

Table 1 describes the parameters in the URI.
Table 1 Parameter description

Parameter

Mandatory

Description

project_id

Yes

Definition

Specifies the project ID.

For details about how to obtain the ID, see Obtaining a Project ID.

Constraints

N/A

Range

N/A

Default Value

N/A

server_group_id

Yes

Definition

Specifies the ECS group UUID.

Constraints

N/A

Range

N/A

Default Value

N/A

Request Parameters

None

Response parameters

None

Example Request

Delete a specified ECS group.

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

Example Response

None

Returned Values

See Returned Values for General Requests.

Error Codes

See Error Codes.

Parent topic: ECS Group Management