All Products
Document Center

Delete a stack

Last Updated: May 21, 2018

Call /stacks/{StackName}/{StackId} by DELETE to delete a stack along with all associated resources.

Request parameters

Name Location Type Required Description
StackName URI String Yes Name of the stack, which must comply with the regular expression ^[a-zA-Z][a-zA-Z0-9_.-]*$. It can contain up to 255 characters.
StackId URI String Yes Stack ID.
RegionId Query String Yes The ID of the region specified during stack creation.

Returned parameters


Error codes

Error code Description HTTP status code Meaning
InternalError Server error. 500 Server-side unknown exception.
StackNotFound The Stack (%(stack_name)s) could not be found. 404 The stack does not exist.
ActionInProgress Stack %(stack_name)s already has an action (%(action)s) in progress. 409 Processing. Try again later.
StopActionFailed Failed to stop stack (%(stack_name)s) on other engine (%(engine_id)s). 404 A process is operating on the stack and cannot be stopped. The deletion has failed.


Request example

  1. DELETE HTTP/1.1
  2. x-acs-signature-method: HMAC-SHA1
  3. Authorization: acs ACSTQDkNtSMrZtwL:3TCZAbfoSw8bpVeg/X5Uag1KgM8=
  4. Date: Fri, 11 Sep 2015 05:30:02 GMT
  5. x-acs-signature-version: 1.0
  6. x-sdk-client: Java/2.0.0
  7. Accept: application/octet-stream
  8. x-acs-version: 2015-09-01
  9. Cache-Control: no-cache
  10. Pragma: no-cache
  11. User-Agent: Java/1.6.0_27
  12. Host:
  13. Connection: keep-alive

Response example

  1. HTTP/1.1 204 No Content
  2. Date: Fri, 11 Sep 2015 05:29:18 GMT
  3. Content-Type: application/json; charset=UTF-8
  4. Content-Length: 521
  5. Connection: close
  6. Access-Control-Allow-Origin: *
  7. Access-Control-Allow-Methods: POST, GET, OPTIONS
  8. Access-Control-Allow-Headers: X-Requested-With, X-Sequence, _aop_secret, _aop_signature
  9. Access-Control-Max-Age: 172800
  10. X-Acs-Request-Id: 8E3F90A8-2F10-443E-9F54-4895CFEFD342
  11. Server: Jetty(7.2.2.v20101205)