cfn-get-metadata - Amazon CloudFormation
语法选项
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

这是新的《Amazon CloudFormation 模板参考指南》。请更新您的书签和链接。有关开始使用 CloudFormation 的帮助，请参阅《Amazon CloudFormation 用户指南》https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/Welcome.html。

cfn-get-metadata

您可以使用 cfn-get-metadata 帮助程序脚本从 CloudFormation 中提取元数据块，并将其打印进行标准输出。如果您指定了密钥，则还可以打印元数据块的子树。但是，仅支持具有最高级别的密钥。

语法

cfn-get-metadata --access-key access.key \
                 --secret-key secret.key \
                 --credential-file|f credential.file \
                 --key|k key \
                 --stack|-s stack.name.or.id \
                 --resource|-r logical.resource.id \
                 --role IAM.role.name \
                 --url|-u service.url \
                 --region region
注意

cfn-get-metadata 不需要凭证，因此您不需要使用 --access-key、--secret-key、--role 或 --credential-file 选项。但是，如果不指定证书，则 CloudFormation 会检查堆栈成员并将调用范围限制为实例所属的堆栈。有关更多信息，请参阅 帮助程序脚本的权限。

选项

名称 描述 必填

-k, --key

对于键值对，返回指定的值所对应的键的名称。

类型：字符串

示例：对于 { "Key1": "SampleKey1", "Key2": "SampleKey2" }，cfn-get-metadata -k Key2 返回 SampleKey2。

否

-s, --stack

堆栈名称。

类型：字符串

默认值：无

示例：-s { "Ref" : "AWS::StackName" },

是

-r, --resource

包含元数据的资源的逻辑资源 ID。

类型：字符串

示例：-r WebServerHost

是

--role (仅适用于向资源发送信号)

与实例关联的 IAM 角色的名称。

类型：字符串

条件：凭证文件参数替代该参数。

否

--region

从中推导 CloudFormation URL 的区域。

类型：字符串

默认值：无

示例：--region ", { "Ref" : "AWS::Region" },

否

--access-key

针对有权对 CloudFormation 调用 DescribeStackResource 的账户的 Amazon 访问密钥。

类型：字符串

条件：凭证文件参数替代该参数。

条件

--secret-key

Amazon 密钥对应于指定的 Amazon 访问密钥。

类型：字符串

条件：凭证文件参数替代该参数。

条件

-f, --credential-file

同时包含密钥和访问密钥的文件。

类型：字符串

条件：凭证文件参数替代 --access-key 和 --secret-key 参数。

条件