aws:deleteStack – Delete an AWS CloudFormation stack - AWS Systems Manager
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

如果我们为英文版本指南提供翻译,那么如果存在任何冲突,将以英文版本指南为准。在提供翻译时使用机器翻译。

aws:deleteStack – Delete an AWS CloudFormation stack

删除 AWS CloudFormation 堆栈。

Input

YAML
name: deleteStack action: aws:deleteStack maxAttempts: 1 onFailure: Abort inputs: StackName: "{{stackName}}"
JSON
{ "name":"deleteStack", "action":"aws:deleteStack", "maxAttempts":1, "onFailure":"Abort", "inputs":{ "StackName":"{{stackName}}" } }
ClientRequestToken

DeleteStack 请求的唯一标识符。如果您计划重试请求以便 AWS CloudFormation 知道您未在尝试删除同名堆栈,请指定此令牌。您可以重试 DeleteStack 请求以验证 AWS CloudFormation 是否收到了它们。

Type :字符串

长度限制: 最小长度为 1。最大长度为 128。

模式:[a-zA-Z][-a-zA-Z0-9]*

必填 否

RetainResources.member.N

此输入仅适用于处于 DELETE_FAILED 状态的堆栈。您想要保留的资源的逻辑资源 ID 的列表。在删除时,AWS CloudFormation 删除堆栈,但不删除保留资源。

如果无法删除某个资源(例如非空 S3 存储桶),但需要删除堆栈,则保留资源会很有用。

类型:字符串数组。

必填 否

RoleARN

AWS CloudFormation 创建堆栈所担任的 IAM 角色的 Amazon 资源名称 (ARN)。AWS CloudFormation 使用该角色的凭证以您的名义进行调用。AWS CloudFormation 针对堆栈的所有未来操作始终使用此角色。只要用户有权对堆栈进行操作,AWS CloudFormation 会使用此角色,即使用户无权传递它。确保该角色授予最少的权限。

如果您不指定值,则 AWS CloudFormation 会使用之前与堆栈关联的角色。如果角色不可用,则 AWS CloudFormation 会使用您的用户凭证生成的一个临时会话。

Type :字符串

长度限制: 最小长度为 20。长度上限为 2048。

必填 否

StackName

与堆栈关联的名称或唯一堆栈 ID。

Type :字符串

必填 是

Security considerations

您必须将以下策略分配给 IAM Automation 担任角色,才可以使用 aws:deleteStack 操作。有关担任角色的更多信息,请参阅任务1: 创建服务角色 自动化

{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "sqs:*", "cloudformation:DeleteStack", "cloudformation:DescribeStacks" ], "Resource":"*" } ] }