Dies ist das neue *CloudFormation Template Reference Guide*. Bitte aktualisieren Sie Ihre Lesezeichen und Links. Hilfe zu den ersten CloudFormation Schritten finden Sie im [AWS CloudFormation Benutzerhandbuch](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# `Fn::ToJsonString`
<a name="intrinsic-function-reference-ToJsonString"></a>

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

**Wichtig**  
Sie müssen die [`AWS::LanguageExtensions`-Transformation](transform-aws-languageextensions.md) verwenden, um die intrinsische Funktion `Fn::ToJsonString` nutzen zu können.

## Deklaration
<a name="tojsonstring-declaration"></a>

### JSON
<a name="intrinsic-function-reference-tojsonstring-syntax.json"></a>

```
{ "Fn::ToJsonString": Object }
```

```
{ "Fn::ToJsonString": Array }
```

### YAML
<a name="intrinsic-function-reference-tojsonstring-syntax.yaml"></a>

```
Fn::ToJsonString: Object
```

```
Fn::ToJsonString: Array
```

## Parameters
<a name="tojsonstring-parameters"></a>

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

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

## Rückgabewert
<a name="intrinsic-function-reference-tojsonstring-return"></a>

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

## Beispiele
<a name="intrinsic-function-reference-tojsonstring-examples"></a>

### Ein Objekt zu einer JSON-Zeichenfolge konvertieren.
<a name="intrinsic-function-reference-tojsonstring-example-subsection"></a>

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

#### JSON
<a name="intrinsic-function-reference-tojsonstring-example.json"></a>

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

#### YAML
<a name="intrinsic-function-reference-tojsonstring-example.yaml"></a>

```
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
<a name="intrinsic-function-reference-tojsonstring-example2"></a>

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

#### JSON
<a name="intrinsic-function-reference-tojsonstring-example2.json"></a>

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

#### YAML
<a name="intrinsic-function-reference-tojsonstring-example2.yaml"></a>

```
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
<a name="tojsonstring-supported-functions"></a>

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`