Il s’agit du nouveau *Guide de référence des modèles CloudFormation *. Veuillez mettre à jour vos favoris et vos liens. Pour obtenir de l'aide pour démarrer CloudFormation, consultez le [guide de AWS CloudFormation l'utilisateur](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

La fonction intrinsèque `Fn::ToJsonString` convertit un objet ou un tableau en sa chaîne JSON correspondante.

**Important**  
Vous devez utiliser la transformation [Transformation `AWS::LanguageExtensions`](transform-aws-languageextensions.md) pour utiliser la fonction intrinsèque `Fn::ToJsonString`.

## Déclaration
<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`  
L'objet que vous voulez convertir en chaîne JSON.

`Array`  
Le tableau que vous voulez convertir en chaîne JSON.

## Valeur renvoyée
<a name="intrinsic-function-reference-tojsonstring-return"></a>

L'objet ou le tableau converti en chaîne JSON. 

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

### Conversion d'un objet en chaîne JSON
<a name="intrinsic-function-reference-tojsonstring-example-subsection"></a>

Cet exemple d'extrait convertit l'objet transmis à la fonction intrinsèque en chaîne JSON.

#### 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
#...
```

Dans ces deux exemples, si la `Ref` à `ParameterName` se résout en `resolvedValue`, la fonction se résout dans la chaîne JSON suivante :

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

### Conversion d'un tableau en chaîne JSON
<a name="intrinsic-function-reference-tojsonstring-example2"></a>

Cet exemple d'extrait convertit le tableau transmis à la fonction intrinsèque en chaîne JSON.

#### 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
#...
```

Dans ces deux exemples, si la `Ref` à `ParameterName` se résout en `resolvedValue`, la fonction se résout dans la chaîne JSON suivante :

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

## Fonctions prises en charge
<a name="tojsonstring-supported-functions"></a>

Vous pouvez utiliser les fonctions suivantes dans la fonction intrinsèque `Fn::ToJsonString` ou le tableau :
+ `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`