AWS CloudFormation
User Guide (API Version 2010-05-15)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

集成的 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 编辑器 中自动突出显示此资源。

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

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

将模板转换为 YAML 或 JSON

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