DeleteStackSet
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.
- CallAs
-
[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. UseSELF
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
Valid Values:
SELF | DELEGATED_ADMIN
Required: No
-
- 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
Examples
DeleteStackSet
This example illustrates one usage of 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: