Fn::ToJsonString - 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。

Fn::ToJsonString

Fn::ToJsonString 内部函数将对象或数组转换为其对应的 JSON 字符串。

重要

必须使用 AWS::LanguageExtensions 转换 才能使用 Fn::ToJsonString 内置函数。

声明

JSON

{ "Fn::ToJsonString": Object }
{ "Fn::ToJsonString": Array }

YAML

Fn::ToJsonString: Object
Fn::ToJsonString: Array

参数

Object

您想转换为 JSON 字符串的对象。

Array

您想转换为 JSON 字符串的数组。

返回值

转换为 JSON 字符串的对象或数组。

示例

将对象转换为 JSON 字符串

此示例代码段将传递给内部函数的对象转换为 JSON 字符串。

JSON

{
//...
    "Transform": "AWS::LanguageExtensions"
    //...
        "Fn::ToJsonString": {
            "key1": "value1",
            "key2": { 
                "Ref": "ParameterName"
            }
        }
//...
}

YAML

Transform: 'AWS::LanguageExtensions'
#...
  Fn::ToJsonString: 
    key1: value1
    key2: !Ref ParameterName
#...

在这两个例子中，如果 Ref 到 ParameterName 解析为 resolvedValue，则该函数解析为以下 JSON 字符串：

"{\"key1\":\"value1\",\"key2\":\"resolvedValue\"}"

将数组转换为 JSON 字符串

此示例代码段将传递给内部函数的数组转换为 JSON 字符串。

JSON

{
//...
    "Transform": "AWS::LanguageExtensions"
    //...
        "Fn::ToJsonString": [{
            "key1": "value1",
            "key2": { 
                "Ref": "ParameterName" 
            }
        }]
//...
}

YAML

Transform: 'AWS::LanguageExtensions'
#...
  Fn::ToJsonString: 
    - key1: value1
      key2: !Ref ParameterName
#...

在这两个例子中，如果 Ref 到 ParameterName 解析为 resolvedValue，则该函数解析为以下 JSON 字符串：

"[{\"key1\":\"value1\"},{\"key2\":\"resolvedValue\"}]"

支持的函数

您可以在 Fn::ToJsonString 内部函数或数组中使用以下函数：

  • Fn::Base64

  • Fn::FindInMap

  • Fn::GetAtt

  • Fn::GetAZs

  • Fn::If

  • Fn::ImportValue

  • Fn::Join

  • Fn::Length

  • Fn::Select

  • Fn::Split

  • Fn::Sub

  • Fn::ToJsonString

  • Ref