You need to enable JavaScript to run this app.
Elastic Compute Service

Elastic Compute Service

Copy page
Download PDF
Deployment sets
DeleteDeploymentSet - Deletes a deployment sets
Copy page
Download PDF
DeleteDeploymentSet - Deletes a deployment sets
Call the DeleteDeploymentSet operation to delete a deployment set.​
Usage notes​
A deployment set can be deleted only when there are no instances in the deployment set.​
Debugging​
API Explorer
You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.
​
Request parameters​
Only the request parameters specific to this operation and some common parameters are listed below. For more information, refer to Common parameters.​
Action string required Sample value: DeleteDeploymentSet​
The action that you want to perform. Value: DeleteDeploymentSet.​
​
Version string required Sample value: 2020-04-01​
The version of the API. Valid value: 2020-04-01.​
​
ClientToken string Optional Sample value: 333456899ff****​
The ClientToken is used to ensure the request idempotency. You can use the client to automatically generate a token, but you must make sure that the token is unique among different requests. This prevents repeated actions due to multiple client retries when the call of the API action times out or an internal server error occurs.​
Value: Only ASCII characters are supported. The length is no more than 64 ASCII characters.​
​
DeploymentSetId string required Sample value: dps-yc1o9aahks5m57nk****​
The ID of the deployment set.​
You can call DescribeDeploymentSets to query deployment set IDs.​
​
​
​
Response parameters​
This operation has no specific response parameters. For more information, refer to Response structure.​
Sample request​
​
GET /?Action=DeleteDeploymentSet&Version=2020-04-01&DeploymentSetId=dps-yc1o9aahks5m57nk**** HTTP/1.1​
Host: ecs.cn-beijing.volcengineapi.com​
Region: cn-beijing​
ServiceName: ecs​
​
Sample response​
​
{​
"ResponseMetadata": {​
"RequestId": "2021062415303301022514515207C4****",​
"Action": "DeleteDeploymentSet",​
"Version": "2020-04-01",​
"Service": "ecs",​
"Region": "cn-beijing"​
},​
"Result": {}​
}​
​
Error codes​
The table below lists the business-related error codes of the operation. For more information, refer to Common error codes.​
​
Status code​
Error code​
Error message​
Description​
400​
IdempotentParameterMismatch​
The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.​
The idempotent parameters are inconsistent.​
400​
MissingParameter.DeploymentSetId​
The required parameter DeploymentSetId is not supplied.​
The deployment set ID cannot be empty.​
400​
InvalidClientToken.Malformed​
The specified ClientToken is malformed.​
The specified ClientToken is invalid.​
404​
InvalidDeploymentSet.NotFound​
The specified DeploymentSet does not exist.​
The specified deployment set does not exist.​
412​
InvalidDeploymentSet.InUse​
The specified DeploymentSet is in use.​
An instance in the specified deployment set is being used.​
412​
IdempotentProcessing​
The request uses the same client token as a previous one that is still in process.​
The previous idempotent request is still in process. Please try again later.​
500​
InternalError​
An internal error has occurred.​
An internal error occurred. Please try again. If multiple attempts fail, submit a ticket.​
​
​
Last updated: 2026.06.18 17:48:25