nav-img
Advanced

Deleting a Server Group

Function

This API is used to delete a server group.

URI

DELETE /v5/{project_id}/host-management/groups

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID.

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

enterprise_project_id

No

String

Enterprise project ID. To query all enterprise projects, set this parameter to all_granted_eps.

group_id

Yes

String

Server group ID

Request Parameters

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token.

It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token.

region

Yes

String

Region ID

Response Parameters

None

Example Requests

Delete the server group whose ID is 34fcf861-402b-45c6-9b6a-13087791aae3.

DELETE https://{endpoint}/v5/{project_id}/host-management/groups
{
"group_id" : "34fcf861-402b-45c6-9b6a-13087791aae3"
}

Example Responses

None

Status Codes

Status Code

Description

200

Request succeeded.

Error Codes