集成的 JSON 和 YAML 编辑器 - Amazon CloudFormation
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

集成的 JSON 和 YAML 编辑器

可以使用 Designer 的集成的 JSON 和 YAML 编辑器查看和编辑模板详细信息。例如,可以使用 集成编辑器 定义资源的属性或更改模板参数。集成编辑器具有两个视图:Components (组件) 视图和 Template (模板) 视图。

要对模板的特定部分进行次要变更,可以使用 Components 视图。在 Components 视图中,可编辑的组件划分到了各个选项卡中。这些选项卡根据您是否选择了资源而变化。

例如,如果您选择了某个资源,则 Designer 提供编辑此资源属性的选项卡,如更新策略或创建策略。如果尚未选择任何元素,则 Designer 提供编辑模板参数、映射、条件、元数据和输出的选项卡。在 Components 视图中所做的任意更改都必须是有效的 JSON 或 YAML 标记。如果引入无效的 JSON 或 YAML,在退出 Components (组件) 视图时,Designer 将无效的标记恢复为有效的标记。

要对模板执行广泛的变更,可以使用 Template 视图。在 Template (模板) 视图中,集成的 JSON 和 YAML 编辑器显示整个模板的原始 JSON 或 YAML。如果要更改资源,请在画布窗格中选择该资源。Designer 在集成的 JSON 和 YAML 编辑器中自动突出显示该资源。

Amazon CloudFormation Designer 集成的 JSON 和 YAML 编辑器


          具有原始 JSON 的集成的 JSON 和 YAML 编辑器屏幕截图。

将模板转换为 YAML 或 JSON

通过在 Choose template language(选择模板语言)中选择相应的单选按钮可将有效的模板在 JSON 和 YAML 之间来回转换。Designer 只能转换有效的 YAML 或有效的 JSON 模板。如果转换成功,Messages(消息)窗格会显示类似下面的消息:Successfully converted the template to YAML(成功将模板转换为 YAML)。

重要

我们建议您不要在 Designer 中将 # YAML 注释添加到模板中。如果 YAML 模板具有 # 注释,Designer 在编辑 YAML 或转换为 JSON 时不会保留这些注释。在 Designer 中编辑或修改模板 (例如,在画布上拖动资源) 时,注释将丢失。

选择模板语言后,拖动到画布上的任何新资源都将以所选语言创建。要切换成另一种语言,请确保模板有效,然后在提示 Choose template language 时选择 YAMLJSON

注意

在将模板转换为 YAML 时,Designer 使用函数的短格式表示法。例如,- !GetAtt。此外,在 YAML 模式下,绘制的任何视觉链接也将使用短格式表示法。有关内部函数的更多信息,请参阅Ref

自动完成

集成的 JSON 和 YAML 编辑器 包含自动补全功能,可帮助您指定资源属性,因此,您不必记住属性名称。要查看 JSON 模板中的有效属性列表,请在 Properties 大括号 ({}) 中按 Ctrl+Space,如以下示例所示:


            JSON 示例中的自动完成选项。

对于 YAML 模板,您可以先删除左/右大括号,然后按 Enter 以转到新行。要查看有效的属性列表,请在 Properties 后面的新行上按 Ctrl+Space,如以下示例所示:


            YAML 示例中的自动完成选项。

键盘快捷键

Designer 的集成的 JSON 和 YAML 编辑器提供以下键盘快捷键:

Ctrl+Space

在资源的 Properties 键中,列出该资源的所有可用属性。

Ctrl+F

搜索特定的值。

要突出显示与指定值匹配的所有内容,请按 Alt+Enter