Deletes a stack and all of its resources.


OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DeleteStack

The operation that you want to perform. Set the value to DeleteStack.

StackId String Yes 4a6c9851-3b0f-4f5f-b4ca-a14bf691****

The ID of the stack.

RetainAllResources Boolean No false

Specifies whether to retain all resources in the stack.

Default value: false. Valid values:

  • true
  • false
RegionId String Yes cn-hangzhou

The region ID of the stack. You can call the DescribeRegions operation to query the most recent region list.

RamRoleName String No test-role

The name of the RAM role. Resource Orchestration Service (ROS) assumes the RAM role to create the stack and uses credentials of the role to call the APIs of Alibaba Cloud services.

ROS assumes the RAM role to perform operations on the stack. If you have permissions to perform operations on the stack but do not have permissions to use the RAM role, ROS still assumes the RAM role. You must make sure that the least privileges are granted to the role.

If you leave this parameter empty when you call the DeleteStack operation, ROS cannot assume the existing RAM role that is associated with the stack. If you want ROS to assume a RAM role, you must specify this parameter. If no role is available for ROS to assume, ROS uses a temporary credential that is generated from the credentials of your account.

The name of the RAM role can be up to 64 bytes in length.

RetainResources.N String No my_disk

The name of resource N that you want to retain.

Response parameters

Parameter Type Example Description
RequestId String B288A0BE-D927-4888-B0F7-B35EF84B6E6F

The ID of the request.


Sample requests

http(s):// Action=DeleteStack
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK

<?xml version='1.0' encoding='UTF-8' ?>


JSON format

HTTP/1.1 200 OK

  "RequestId" : "B288A0BE-D927-4888-B0F7-B35EF84B6E6F"

Error codes

For a list of error codes, see Service error codes.

For more information about errors common to all operations, see Common errors.

HTTP status code

Error code

Error message




Fail to delete stack {ID}, as deletion protection is enabled.

The error message returned because deletion protection prevented the stack from being deleted. ID indicates the stack ID.



The Stack ({name}) could not be found.

The error message returned because the stack does not exist. name indicates the name or ID of the stack.



Stack {name} already has an action ({action}) in progress.

The error message returned because the stack has a change operation in progress. name indicates the stack name or ID. action indicates the change operation.