DeleteStackSet - AWS CloudFormation


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

Request Parameters

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


[Service-managed permissions] Specifies whether you are acting as an account administrator in the organization's management account or as a delegated administrator in a member account.

By default, SELF is specified. Use SELF for stack sets with self-managed permissions.

  • If you are signed in to the management account, specify SELF.

  • If you are signed in to a delegated administrator account, specify DELEGATED_ADMIN.

    Your AWS account must be registered as a delegated administrator in the management account. For more information, see Register a delegated administrator in the AWS CloudFormation User Guide.

Type: String


Required: No


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


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


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


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



This example illustrates one usage of DeleteStackSet.

Sample Request ?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=""> <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: