Menu
AWS CloudFormation
API Reference (API Version 2010-05-15)

DeleteStackSet

Deletes a stack set. Before you can delete a stack set, all of its member stack instances must be deleted. For more information about how to do this, see DeleteStackInstances.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

StackSetName

The name or unique ID of the stack set that you're deleting. You can obtain this value by running ListStackSets.

Type: String

Required: Yes

Errors

For information about the errors that are common to all actions, see Common Errors.

OperationInProgress

Another operation is currently in progress for this stack set. Only one operation can be performed for a stack set at a given time.

HTTP Status Code: 409

StackSetNotEmpty

You can't yet delete this stack set, because it still contains one or more stack instances. Delete all stack instances from the stack set before deleting the stack set.

HTTP Status Code: 409

Example

DeleteStackSet

Sample Request


https://cloudformation.us-east-1.amazonaws.com/
 ?Action=DeleteStackSet
 &Version=2010-05-15
 &StackSetName=stack-set-example
 &X-Amz-Algorithm=AWS4-HMAC-SHA256
 &X-Amz-Credential=[Access key ID and scope]
 &X-Amz-Date=20170810T233349Z
 &X-Amz-SignedHeaders=content-type;host
 &X-Amz-Signature=[Signature]
         

Sample Response


<DeleteStackSetResponse xmlns="http://internal.amazon.com/coral/com.amazonaws.maestro.service.v20160713/">
  <DeleteStackSetResult/>
  <ResponseMetadata>
    <RequestId>792b1f2b-7946-11e7-a7db-afc00fexample</RequestId>
  </ResponseMetadata>
</DeleteStackSetResponse>
         

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: