Fn::ToJsonString

Die intrinsische Funktion Fn::ToJsonString konvertiert ein Objekt oder Array zur entsprechenden JSON-Zeichenfolge.

Wichtig

Sie müssen die AWS::LanguageExtensions-Transformation verwenden, um die Fn::ToJsonString systeminterne Funktion verwenden zu können.

Deklaration

JSON

{ "Fn::ToJsonString": Object }

{ "Fn::ToJsonString": Array }

YAML

Fn::ToJsonString: Object

Fn::ToJsonString: Array

Parameter

Object

Das Objekt, das zu einer JSON-Zeichenfolge konvertiert werden soll.

Array

Das Array, das zu einer JSON-Zeichenfolge konvertiert werden soll.

Rückgabewert

Das Objekt oder Array, das zu einer JSON-Zeichenfolge konvertiert wurde.

Beispiele

Ein Objekt zu einer JSON-Zeichenfolge konvertieren.

In diesem Beispiel wird das an die intrinsische Funktion übergebene Objekt zu einer JSON-Zeichenfolge konvertiert.

JSON

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

YAML

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

In beiden Beispielen gilt: Wenn die Ref des ParameterName zu resolvedValue aufgelöst wird, wird die Funktion in die folgende JSON-Zeichenfolge aufgelöst:

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

Ein Array zu einer JSON-Zeichenfolge konvertieren

In diesem Beispiel wird das an die intrinsische Funktion übergebene Array zu einer JSON-Zeichenfolge konvertiert.

JSON

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

YAML

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

In beiden Beispielen gilt: Wenn die Ref des ParameterName zu resolvedValue aufgelöst wird, löst sich die Funktion in die folgende JSON-Zeichenfolge auf:

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

Unterstützte Funktionen

Sie können die folgenden Funktionen in der intrinsischen Funktion Fn::ToJsonString oder im Array verwenden:

• 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