Fn::ToJsonString - AWS CloudFormation
DeclaraciónParámetrosValor devueltoEjemplosFunciones compatibles

Esta es la nueva Guía de referencia de plantillas de AWS CloudFormation. Actualice sus marcadores y enlaces. Para obtener ayuda sobre cómo empezar a usar CloudFormation, consulte la Guía del usuario de AWS CloudFormation.

Fn::ToJsonString

La función Fn::ToJsonString intrínseca convierte un objeto o una matriz en su cadena JSON correspondiente.

importante

Debe usar la Transformación AWS::LanguageExtensions para usar la función intrínseca Fn::ToJsonString.

Declaración

JSON

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

YAML

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

Parámetros

Object

El objeto que quiera convertir en una cadena JSON.

Array

La matriz que quiera convertir en una cadena JSON.

Valor devuelto

El objeto o la matriz convertidos en una cadena JSON.

Ejemplos

Conversión de un objeto en una cadena JSON

En este fragmento de código de ejemplo se convierte el objeto que se pasó a la función intrínseca en una cadena JSON.

JSON

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

YAML

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

En ambos ejemplos, si de Ref a ParameterName resulta ser resolvedValue, la función se resuelve en la siguiente cadena JSON:

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

Conversión de una matriz en una cadena JSON

En este fragmento de código de ejemplo convierte la matriz que se pasó a la función intrínseca en una cadena JSON.

JSON

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

YAML

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

En ambos ejemplos, si de Ref a ParameterName resulta ser resolvedValue, la función se resuelve en la siguiente cadena JSON:

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

Funciones compatibles

Puede usar las siguientes funciones en la función Fn::ToJsonString intrínseca o la matriz:

  • 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