元数据

您可以使用可选的 Metadata 部分包括任意 JSON 或 YAML 对象，用于提供模板详细信息。例如，可以包括有关特定资源的模板实现详细信息，如以下代码段所示：

重要

堆栈更新期间，您无法更新 Metadata 部分本身。您只能在包括添加、修改或删除资源的更改时更新它。

重要

CloudFormation 不会转换、修改或编辑您在 Metadata 部分中包含的任何信息。因此，我们强烈建议您不要使用此部分存储敏感信息，例如密码或密钥。

JSON

"Metadata" : {
  "Instances" : {"Description" : "Information about the instances"},
  "Databases" : {"Description" : "Information about the databases"}
}

YAML

Metadata:
  Instances:
    Description: "Information about the instances"
  Databases: 
    Description: "Information about the databases"

元数据键

某些 AWS CloudFormation 功能可在 Metadata 部分中检索您定义的设置或配置信息。您可在以下特定于 AWS CloudFormation 的元数据键中定义此信息：

AWS::CloudFormation::Init

为 cfn-init 帮助程序脚本定义配置任务。要在 EC2 实例上配置和安装应用程序，此脚本很有用。有关更多信息，请参阅AWS::CloudFormation::Init。

AWS::CloudFormation::Interface

定义在 AWS CloudFormation 控制台中显示输入参数时的分组和排序。默认情况下，AWS CloudFormation 控制台根据参数的逻辑 ID 按照字母顺序排序。有关更多信息，请参阅AWS::CloudFormation::Interface。

AWS::CloudFormation::Designer

描述您的资源在 AWS CloudFormation Designer（Designer）中如何排列。当您使用它创建和更新模板时，Designer 会自动添加此信息。有关更多信息，请参阅什么是 AWS CloudFormation Designer？。