Function

This API is used to delete a fleet. A fleet can only be deleted when there are no clusters in it. To delete a fleet, remove the clusters from the fleet first. The cluster IDs must comply with the Kubernetes UUID format rules, and you must have operation permissions on the clusters. Otherwise, the authentication fails.

URI

DELETE /v1/clustergroups/{clustergroupid}

**Table 1** Path parameter
Parameter	Mandatory	Type	Description
clustergroupid	Yes	String	Fleet ID

Request Parameters

**Table 2** Parameters in the request header
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Identity authentication information. Requests for calling an API can be authenticated using either a token or AK/SK. If token-based authentication is used, this parameter is mandatory and must be set to a user token.
Content-Type	Yes	String	Message body type (format). Only application/json is supported.

Response Parameters

None

Example Requests

None

Example Responses

Status code: 200

The fleet has been deleted.

{ }

Status Codes

Status Code	Description
200	The fleet has been deleted.
400	Client request error. The server could not execute the request.
403	The server refused the request.
404	Resources not found.
500	Internal server error.

Error Codes

See Error Codes.

Deleting a Fleet