) o));
} else {
retFragment.add(o);
}
});
return retFragment;
}
private String iterateAndReplace(final String replacement, final String target, final String fragment) {
System.out.println(replacement + " == " + target + " == " + fragment );
if (fragment != null AND_AND fragment.equals(target))
return replacement;
return fragment;
}
}
```
## Lambda 函数响应
以下是 Lambda 函数返回到 CloudFormation 进行处理的映射。
+ `requestId` : `5dba79b5-f117-4de0-9ce4-d40363bfb6ab`
+ `status` : `SUCCESS`
+ `fragment` :
```
{
"Type": "AWS::CloudFormation::WaitConditionHandle"
}
```
从 CloudFormation 发送的 `requestId` 匹配项，以及 `SUCCESS` 的 `status` 值表示 Lambda 函数成功处理了请求中包含的模板片段。在此响应中，`fragment` 包含 JSON，表示要插入到已处理模板中的内容，而不是原始模板代码段。
## 生成的已处理模板
在 CloudFormation 从 Lambda 函数收到成功响应后，它将返回的模板片段插入到已处理模板中。
下面是我们示例的生成的已处理模板。不再包括引用 `JavaMacroFunc` 宏的 `Fn::Transform` 内置函数调用。Lambda 函数返回的模板片段包含在适当的位置，结果是内容 `"Type": "$$REPLACEMENT$$"` 已替换为 `"Type": "AWS::CloudFormation::WaitConditionHandle"`。
```
{
"Parameters": {
"ExampleParameter": {
"Default": "SampleMacro",
"Type": "String"
}
},
"Resources": {
"2a": {
"Type": "AWS::CloudFormation::WaitConditionHandle"
}
}
}
```
# 对所处理的模板进行故障排除
对所处理的模板进行故障排除
使用宏时，可以在 CloudFormation 控制台中找到所处理的模板。
模板的阶段指示其处理状态：
+ `Original`：用户最初提交的用于创建或更新堆栈或堆栈集的模板。
+ `Processed`：CloudFormation 在处理任何引用的宏之后，用于创建或更新堆栈或堆栈集的模板。即使原始模板格式化为 YAML，已处理模板也会格式化为 JSON。
要排除故障，可使用所处理的模板。如果模板不引用宏，则原始模板和已处理模板是相同的。
有关更多信息，请参阅 [从 CloudFormation 控制台查看堆栈信息](cfn-console-view-stack-data-resources.md)。
要使用 Amazon CLI 获取所处理的模板，应使用 [get-template](service_code_examples.md#get-template-sdk) 命令。
## 大小限制
当处理的堆栈模板直接传递到 `CreateStack`、`UpdateStack` 或 `ValidateTemplate` 请求时，其最大大小为 51200 字节；或者当使用 Amazon S3 模板 URL 作为 S3 对象传递时，为 1MB。但是，在处理期间，CloudFormation 会更新模板的临时状态，因为它连续处理模板中包含的宏。因此，在处理期间，模板的大小可能会临时超出完全处理的模板所允许的大小。CloudFormation 允许为这些处理中的模板留出一些缓冲。但是，在设计模板和宏时，要始终考虑处理的堆栈模板所允许的最大大小。
如果在处理模板期间 CloudFormation 返回一个 `Transformation data limit exceeded` 错误，则说明您的模板超出了 CloudFormation 所允许的处理期间模板的最大大小。
要解决这一问题，可执行下列操作：
+ 将您的模板分成多个模板，以避免超出为处理中的模板规定的最大大小。例如：
+ 使用嵌套堆栈模板来封装模板的不同部分。有关更多信息，请参阅 [使用嵌套堆栈将模板拆分为可重复使用的部分](using-cfn-nested-stacks.md)。
+ 创建多个堆栈，并使用跨堆栈引用来相互交换信息。有关更多信息，请参阅 [引用其他 CloudFormation 堆栈中的资源输出](walkthrough-crossstackref.md)。
+ 减小给定宏返回的模板片段大小。CloudFormation 不会篡改宏返回的片段内容。
# 使用嵌套堆栈将模板拆分为可重复使用的部分
嵌套堆栈
随着基础设施的发展，您可能会发现自己在多个模板中反复创建相同的资源配置。为避免这种冗余，您可以将这些常用配置分成专用模板。然后，您可以使用其他模板中的 [https://docs.amazonaws.cn/AWSCloudFormation/latest/TemplateReference/aws-resource-cloudformation-stack.html](https://docs.amazonaws.cn/AWSCloudFormation/latest/TemplateReference/aws-resource-cloudformation-stack.html) 资源来引用这些专用模板，创建嵌套堆栈。
例如，假如您拥有用于大多数堆栈的负载均衡器配置。您可以为负载均衡器创建专用模板，而不是将相同的配置复制并粘贴到您的模板中。然后，您可以从需要相同负载均衡器配置的其他模板中引用此模板。
嵌套堆栈本身可以包含其他嵌套堆栈，构成一个堆栈层次结构，如下图所示。*根堆栈*是所有嵌套堆栈最终归属的顶级堆栈。每个嵌套堆栈都有一个直属父堆栈。对于第一级的嵌套堆栈而言，根堆栈也是父堆栈。
+ 堆栈 A 是该层次结构中所有其他嵌套堆栈的根堆栈。
+ 对于堆栈 B 来说，堆栈 A 既是父堆栈，也是根堆栈。
+ 对于堆栈 D，堆栈 C 是父堆栈；而对于堆栈 C 来说，堆栈 B 是父堆栈。
![\[作为另一个堆栈的一部分而创建的嵌套堆栈具有一个直属父堆栈，同时也具有顶级根堆栈。\]](http://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/images/cfn-console-nested-stacks.png)
**Topics**
+ [
## 拆分模板之前和之后的示例
](#create-nested-stack-template)
+ [
## 嵌套堆栈架构的示例
](#nested-stack-examples)
+ [
## 在嵌套堆栈上执行堆栈操作
](#perform-stack-operations-on-nested-stacks)
+ [
## 相关信息
](#nested-stacks-related-information)
## 拆分模板之前和之后的示例
此示例演示如何提取单个大型 CloudFormation 模板，然后使用嵌套模板将其重组为结构化程度更高、可重复使用的设计。最初，“嵌套堆栈前”模板显示在一个文件中定义了所有资源。随着资源数量不断增长，该文件可能会变得混乱且难以管理。“嵌套堆栈后”模板将资源拆分为若干较小的独立模板。每个嵌套堆栈都处理一组特定的相关资源，从而使整体结构更有条理，更易于维护。
| 嵌套堆栈前 | 嵌套堆栈后 |
| --- | --- |
| AWSTemplateFormatVersion: 2010-09-09
Parameters:
InstanceType:
Type: String
Default: t2.micro
Description: The EC2 instance type
Environment:
Type: String
Default: Production
Description: The deployment environment
Resources:
MyEC2Instance:
Type: AWS::EC2::Instance
Properties:
ImageId: ami-1234567890abcdef0
InstanceType: !Ref InstanceType
MyS3Bucket:
Type: AWS::S3::Bucket
| AWSTemplateFormatVersion: 2010-09-09
Resources:
MyFirstNestedStack:
Type: AWS::CloudFormation::Stack
Properties:
TemplateURL: https://s3.amazonaws.com/amzn-s3-demo-bucket/first-nested-stack.yaml
Parameters:
# Pass parameters to the nested stack if needed
InstanceType: t3.micro
MySecondNestedStack:
Type: AWS::CloudFormation::Stack
Properties:
TemplateURL: https://s3.amazonaws.com/amzn-s3-demo-bucket/second-nested-stack.yaml
Parameters:
# Pass parameters to the nested stack if needed
Environment: Testing
DependsOn: MyFirstNestedStack
|
## 嵌套堆栈架构的示例
本部分演示了一种嵌套堆栈架构，该架构由引用嵌套堆栈的顶级堆栈组成。嵌套堆栈部署 Node.js Lambda 函数，从顶级堆栈接收参数值，并返回通过顶级堆栈公开的输出。
**Topics**
+ [
### 步骤 1：在本地系统上为嵌套堆栈创建模板
](#create-a-nested-stack-template)
+ [
### 步骤 2：在本地系统上为顶级堆栈创建模板
](#create-a-nested-stack-parent-template)
+ [
### 步骤 3：打包并部署模板
](#create-a-nested-stack-parent-template)
### 步骤 1：在本地系统上为嵌套堆栈创建模板
以下示例显示嵌套堆栈模板的格式。
#### YAML
```
1. AWSTemplateFormatVersion: 2010-09-09
2. Description: Nested stack template for Lambda function deployment
3. Parameters:
4. MemorySize:
5. Type: Number
6. Default: 128
7. MinValue: 128
8. MaxValue: 10240
9. Description: Lambda function memory allocation (128-10240 MB)
10. Resources:
11. LambdaFunction:
12. Type: AWS::Lambda::Function
13. Properties:
14. FunctionName: !Sub "${AWS::StackName}-Function"
15. Runtime: nodejs18.x
16. Handler: index.handler
17. Role: !GetAtt LambdaExecutionRole.Arn
18. Code:
19. ZipFile: |
20. exports.handler = async (event) => {
21. return {
22. statusCode: 200,
23. body: JSON.stringify('Hello from Lambda!')
24. };
25. };
26. MemorySize: !Ref MemorySize
27. LambdaExecutionRole:
28. Type: AWS::IAM::Role
29. Properties:
30. AssumeRolePolicyDocument:
31. Version: '2012-10-17'
32. Statement:
33. - Effect: Allow
34. Principal:
35. Service: lambda.amazonaws.com
36. Action: sts:AssumeRole
37. ManagedPolicyArns:
38. - 'arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole'
39. Outputs:
40. LambdaArn:
41. Description: ARN of the created Lambda function
42. Value: !GetAtt LambdaFunction.Arn
```
### 步骤 2：在本地系统上为顶级堆栈创建模板
以下示例显示了顶层堆栈模板的格式以及引用您在上一步中所创建堆栈的 [https://docs.amazonaws.cn/AWSCloudFormation/latest/TemplateReference/aws-resource-cloudformation-stack.html](https://docs.amazonaws.cn/AWSCloudFormation/latest/TemplateReference/aws-resource-cloudformation-stack.html) 资源。
#### YAML
```
1. AWSTemplateFormatVersion: 2010-09-09
2. Description: Top-level stack template that deploys a nested stack
3. Resources:
4. NestedStack:
5. Type: AWS::CloudFormation::Stack
6. Properties:
7. TemplateURL: /path_to_template/nested-template.yaml
8. Parameters:
9. MemorySize: 256
10. Outputs:
11. NestedStackLambdaArn:
12. Description: ARN of the Lambda function from nested stack
13. Value: !GetAtt NestedStack.Outputs.LambdaArn
```
### 步骤 3：打包并部署模板
**注意**
在本地使用模板时，Amazon CLI **package** 命令可以帮助您准备部署模板。它会自动处理将本地构件上传到 Amazon S3（包括 `TemplateURL`），并生成一个新的模板文件，其中包含对这些 S3 位置的更新引用。有关更多信息，请参阅 [使用 Amazon CLI 将本地构件上传到 S3 存储桶](using-cfn-cli-package.md)。
接下来，您可以使用 [https://docs.amazonaws.cn/cli/latest/reference/cloudformation/package.html](https://docs.amazonaws.cn/cli/latest/reference/cloudformation/package.html) 命令将嵌套模板上传到 Amazon S3 存储桶。
```
aws cloudformation package \
--s3-bucket amzn-s3-demo-bucket \
--template /path_to_template/top-level-template.yaml \
--output-template-file packaged-template.yaml \
--output json
```
该命令在 `--output-template-file` 指定的路径上生成一个新模板。它将 `TemplateURL` 引用替换为 Amazon S3 位置，如下图所示。
**结果模板**
```
AWSTemplateFormatVersion: 2010-09-09
Description: Top-level stack template that deploys a nested stack
Resources:
NestedStack:
Type: AWS::CloudFormation::Stack
Properties:
TemplateURL: https://s3.us-west-2.amazonaws.com/amzn-s3-demo-bucket/8b3bb7aa7abfc6e37e2d06b869484bed.template
Parameters:
MemorySize: 256
Outputs:
NestedStackLambdaArn:
Description: ARN of the Lambda function from nested stack
Value:
Fn::GetAtt:
- NestedStack
- Outputs.LambdaArn
```
运行 **package** 命令后，您可以使用 [https://docs.amazonaws.cn/cli/latest/reference/cloudformation/deploy/](https://docs.amazonaws.cn/cli/latest/reference/cloudformation/deploy/) 命令部署已处理的模板。对于包含 IAM 资源的嵌套堆栈，您必须通过包含 `--capabilities` 选项来确认 IAM 功能。
```
aws cloudformation deploy \
--template-file packaged-template.yaml \
--stack-name stack-name \
--capabilities CAPABILITY_NAMED_IAM
```
## 在嵌套堆栈上执行堆栈操作
使用嵌套堆栈时，在操作过程中必须谨慎处理。某些堆栈操作（如堆栈更新等）应从根堆栈启动，而不是直接在嵌套堆栈上执行。更新根堆栈时，只有包含模板更改的嵌套堆栈才会更新。
此外，嵌套堆栈的存在可能会影响根堆栈上的操作。例如，如果一个嵌套堆栈卡在 `UPDATE_ROLLBACK_IN_PROGRESS` 状态，则根堆栈将等待该嵌套堆栈完成其回滚后再继续。在继续更新操作之前，请确保您拥有 IAM 权限，以在其回滚时取消堆栈更新。有关更多信息，请参阅 [使用 Amazon Identity and Access Management 控制 CloudFormation 访问权限](control-access-with-iam.md)。
按照以下过程查找根堆栈和嵌套堆栈。
**查看嵌套堆栈的根堆栈**
1. 登录到 Amazon Web Services 管理控制台 并打开 Amazon CloudFormation 控制台 [https://console.aws.amazon.com/cloudformation](https://console.amazonaws.cn/cloudformation/)。
1. 在**堆栈**页面上，选择您要查看其根堆栈的嵌套堆栈的名称。
嵌套堆栈的堆栈名称上方会显示 **NESTED**。
1. 在**堆栈信息**选项卡的**概述**部分中，选择列为**根堆栈**的堆栈名称。
**查看属于根堆栈的嵌套堆栈**
1. 从要查看其嵌套堆栈的根堆栈中，选择**资源**选项卡。
1. 在**类型**列中，查找类型为 **AWS::CloudFormation::Stack** 的资源。
## 相关信息
+ [嵌套现有的堆栈](resource-import-nested-stacks.md)
+ [理解堆栈资源的更新行为](using-cfn-updating-stacks-update-behaviors.md)
+ [继续回滚失败的嵌套堆栈更新](using-cfn-updating-stacks-continueupdaterollback.md#nested-stacks)
+ [嵌套堆栈回滚失败](troubleshooting.md#troubleshooting-errors-nested-stacks-are-stuck)
# 在 CloudFormation 模板中创建等待条件
等待条件
本主题介绍了如何在模板中创建等待条件以协调堆栈资源的创建或跟踪配置过程的进度。例如，您可以在应用程序配置部分完成后开始另一个资源的创建，或者也可以在安装和配置过程中发送信号以跟踪其进度。
当 CloudFormation 创建含有等待条件的堆栈时：
+ 它会跟其他任何资源一样创建等待条件，并将等待条件的状态设置为 `CREATE_IN_PROGRESS`。
+ CloudFormation 等待至收到必要数量的成功信号或等待条件的超时时段到期。
+ 如果在超时时段到期之前收到了必要数量的成功信号：
+ 等待条件的状态更改为 `CREATE_COMPLETE`
+ 堆栈创建继续
+ 如果超时到期或收到了故障信号：
+ 等待条件的状态更改为 `CREATE_FAILED`
+ 堆栈回滚
**重要**
对于 Amazon EC2 和 Auto Scaling 资源，我们建议您使用 CreationPolicy 属性而非等待条件。当实例创建过程成功完成后，将“CreationPolicy”属性添加到这些资源，并使用 cfn-signal 帮助程序脚本发送信号。
有关更多信息，请参阅 [CreationPolicy 属性](https://docs.amazonaws.cn/AWSCloudFormation/latest/TemplateReference/aws-attribute-creationpolicy.html)。
**注意**
如果使用 Amazon PrivateLink，则响应等待条件的 VPC 中的资源必须能够访问 CloudFormation 特定的 Amazon Simple Storage Service (Amazon S3) 存储桶。资源必须将等待条件响应发送到预签名 Amazon S3 URL。如果这些资源不能向 Amazon S3 发送响应，则 CloudFormation 将不会收到响应，并且堆栈操作会失败。有关更多信息，请参阅[使用接口端点 (Amazon PrivateLink) 访问 Amazon CloudFormation](vpc-interface-endpoints.md)以及[使用存储桶策略控制从 VPC 端点的访问](https://docs.amazonaws.cn/AmazonS3/latest/userguide/example-bucket-policies-vpc-endpoint.html)。
**Topics**
+ [
## 在模板中创建等待条件
](#creating-wait-condition)
+ [
## 等待条件信号语法
](#wait-condition-signal-syntax)
+ [
## 访问信号数据
](#wait-condition-access-signal-data)
## 在模板中创建等待条件
**1. 等待条件句柄**
首先在堆栈模板中定义 [https://docs.amazonaws.cn/AWSCloudFormation/latest/TemplateReference/aws-resource-cloudformation-waitconditionhandle.html](https://docs.amazonaws.cn/AWSCloudFormation/latest/TemplateReference/aws-resource-cloudformation-waitconditionhandle.html) 资源。该资源会生成发送信号所需的预签名 URL。这样您就可以发送信号，而无需提供 Amazon 凭证。例如：
```
Resources:
MyWaitHandle:
Type: AWS::CloudFormation::WaitConditionHandle
```
**2. 等待条件**
接下来，在堆栈模板中定义 [https://docs.amazonaws.cn/AWSCloudFormation/latest/TemplateReference/aws-resource-cloudformation-waitcondition.html](https://docs.amazonaws.cn/AWSCloudFormation/latest/TemplateReference/aws-resource-cloudformation-waitcondition.html) 资源。`AWS::CloudFormation::WaitCondition` 的基本结构如下所示：
```
MyWaitCondition:
Type: AWS::CloudFormation::WaitCondition
Properties:
Handle: String
Timeout: String
Count: Integer
```
`AWS::CloudFormation::WaitCondition` 资源有两个必要属性和一个可选属性。
+ `Handle`（必要）：对模板中声明的 `WaitConditionHandle` 的引用。
+ `Timeout`（必要）：CloudFormation 在收到必要数量的信号之前等待的秒数。`Timeout` 是一种最低时限属性，表示超时不会早于您指定的时间发生，但可能在指定时间后不久发生。您可指定的最长时间为 43200 秒 (12 小时)。
+ `Count`（可选）：CloudFormation 在将等待条件状态设置为 `CREATE_COMPLETE` 并继续创建堆栈前之前必须收到的成功信号数量。如果未指定，则默认值为 1。
通常，您想要等待条件在特定资源创建后立即开始。可以通过为等待条件添加 `DependsOn` 属性来完成此操作。向等待条件添加 `DependsOn` 属性时，CloudFormation 先在 `DependsOn` 属性中创建资源，然后创建等待条件。有关更多信息，请参阅 [DependsOn 属性](https://docs.amazonaws.cn/AWSCloudFormation/latest/TemplateReference/aws-attribute-dependson.html)。
以下示例展示等待条件：
+ 在成功创建 `MyEC2Instance` 资源后开始
+ 将 `MyWaitHandle` 资源用作 `WaitConditionHandle`
+ 超时为 4500 秒
+ 默认 `Count` 为 1（因为未指定任何 `Count` 属性）
```
MyWaitCondition:
Type: AWS::CloudFormation::WaitCondition
DependsOn: MyEC2Instance
Properties:
Handle: !Ref MyWaitHandle
Timeout: '4500'
```
**3. 发送信号**
为向 CloudFormation 发出成功或失败的信号，通常需要运行一些代码或脚本。例如，在 EC2 实例上运行的应用程序可能会执行一些额外的配置工作，然后向 CloudFormation 发出信号指示已完成。
信号必须发送至由等待条件句柄生成的预签名 URL。使用预签名 URL 发送成功或失败信号。
**发送信号**
1. 要检索模板中的预签名 URL，需使用带有等待条件句柄逻辑名称的 `Ref` 内置函数。
如下例所示，您的模板可声明一个 Amazon EC2 实例，并使用 Amazon EC2 `UserData` 属性将预签名 URL 传递到该 EC2 实例。这样在这些实例上运行的脚本或应用程序就可以向 CloudFormation 发出成功或失败的信号。
```
MyEC2Instance:
Type: AWS::EC2::Instance
Properties:
InstanceType: t2.micro # Example instance type
ImageId: ami-055e3d4f0bbeb5878 # Change this as needed (Amazon Linux 2023 in us-west-2)
UserData:
Fn::Base64:
Fn::Join:
- ""
- - "SignalURL="
- { "Ref": "MyWaitHandle" }
```
这会产生类似于下述信息的 `UserData` 输出：
```
SignalURL=https://amzn-s3-demo-bucket.s3.amazonaws.com/....
```
注意：在 Amazon Web Services 管理控制台和命令行工具中，预签名 URL 显示为等待条件句柄资源的物理 ID。
1. （可选）要检测堆栈进入等待条件的时间，可以使用以下方法之一：
+ 如果您通过启用的通知创建堆栈，那么 CloudFormation 将向指定主题发布针对每项堆栈事件的通知。如果您或您的应用程序订阅了该主题，您可以监测针对等待条件句柄创建事件的通知，并通过通知消息来检索预签名 URL。
+ 您还可以使用 Amazon Web Services 管理控制台、Amazon CLI 或 SDK 来监控堆栈事件。
1. 您需要通过预签名 URL 发送 HTTP 请求消息之后，才能发送信号。请求方法必须为 `PUT`，并且 `Content-Type` 标题必须为空字符串或省略。请求消息必须为 [等待条件信号语法](#wait-condition-signal-syntax) 指定表单的 JSON 结构。
您必须发送由 `Count` 属性指定的成功信号数，以便 CloudFormation 继续创建堆栈。如果您的 `Count` 超过 1，则在发送到特定等待条件的所有信号中，每个信号的 `UniqueId` 值必须是唯一的。`UniqueId` 是随机的字母数字字符串。
`curl` 命令是发送信号的一种方式。以下示例显示了向等待条件发送成功信号的 `curl` 命令行。
```
$ curl -T /tmp/a \
"https://amzn-s3-demo-bucket.s3.amazonaws.com/arn%3Aaws%3Acloudformation%3Aus-west-2%3A034017226601%3Astack%2Fstack-gosar-20110427004224-test-stack-with-WaitCondition--VEYW%2Fe498ce60-70a1-11e0-81a7-5081d0136786%2FmyWaitConditionHandle?Expires=1303976584&AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE&Signature=ik1twT6hpS4cgNAw7wyOoRejVoo%3D"
```
其中文件 *`/tmp/a`* 包含以下 JSON 结构：
```
{
"Status" : "SUCCESS",
"Reason" : "Configuration Complete",
"UniqueId" : "ID1234",
"Data" : "Application has completed configuration."
}
```
此示例显示发送同一成功信号的 `curl` 命令行，不同的是，它将 JSON 结构作为命令行参数发送。
```
$ curl -X PUT \
-H 'Content-Type:' --data-binary '{"Status" : "SUCCESS","Reason" : "Configuration Complete","UniqueId" : "ID1234","Data" : "Application has completed configuration."}' \
"https://amzn-s3-demo-bucket.s3.amazonaws.com/arn%3Aaws%3Acloudformation%3Aus-west-2%3A034017226601%3Astack%2Fstack-gosar-20110427004224-test-stack-with-WaitCondition--VEYW%2Fe498ce60-70a1-11e0-81a7-5081d0136786%2FmyWaitConditionHandle?Expires=1303976584&AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE&Signature=ik1twT6hpS4cgNAw7wyOoRejVoo%3D"
```
## 等待条件信号语法
在向等待条件句柄生成的 URL 发送信号时，您必须使用以下 JSON 格式：
```
{
"Status" : "StatusValue",
"UniqueId" : "Some UniqueId",
"Data" : "Some Data",
"Reason" : "Some Reason"
}
```
### 属性
`Status` 字段必须是以下任一值：
+ `SUCCESS`
+ `FAILURE`
`UniqueId` 字段标识发送至 CloudFormation 的信号。如果等待条件的 `Count` 属性大于 1，那么在针对特定等待条件发送的所有信号中，`UniqueId` 值必须唯一；否则，CloudFormation 会将该信号视为对先前已发送的具有相同 `UniqueId` 的信号的重传，并将其忽略。
`Data` 字段可包含要通过信号发回的任何信息。可以通过使用模板中的 [Fn::GetAtt ](resources-section-structure.md#resource-properties-getatt)函数来访问 `Data` 值。
`Reason` 字段为字符串，除与 JSON 格式相一致外，其内容中无任何其他限制。
## 访问信号数据
要访问由有效信号发送的数据，可以在 CloudFormation 模板中为等待条件创建输出值。例如：
```
Outputs:
WaitConditionData:
Description: The data passed back as part of signalling the WaitCondition
Value: !GetAtt MyWaitCondition.Data
```
然后可以使用 [https://docs.amazonaws.cn/cli/latest/reference/cloudformation/describe-stacks.html](https://docs.amazonaws.cn/cli/latest/reference/cloudformation/describe-stacks.html) 命令或 CloudFormation 控制台的**输出**选项卡来查看该数据。
`Fn::GetAtt` 函数将返回 `UniqueId` 和 `Data` 作为 JSON 结构中的名称/值对。例如：
```
{"Signal1":"Application has completed configuration."}
```