Questa è la nuova *Guida di riferimento ai modelli CloudFormation *. Aggiorna i segnalibri e i link. Per informazioni su come iniziare CloudFormation, consulta la [Guida AWS CloudFormation per l'utente](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

La funzione intrinseca `Fn::ToJsonString` converte un oggetto o una matrice nella stringa JSON corrispondente.

**Importante**  
È necessario utilizzare [Trasformazione `AWS::LanguageExtensions`](transform-aws-languageextensions.md) per utilizzare la funzione intrinseca `Fn::ToJsonString`.

## Dichiarazione
<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'oggetto che desideri convertire in una stringa JSON.

`Array`  
La matrice da convertire in una stringa JSON.

## Valore restituito
<a name="intrinsic-function-reference-tojsonstring-return"></a>

L'oggetto o la matrice convertito in una stringa JSON. 

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

### Conversione di un oggetto in una stringa JSON
<a name="intrinsic-function-reference-tojsonstring-example-subsection"></a>

Questo frammento di esempio converte l'oggetto passato alla funzione intrinseca in una stringa 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
#...
```

In entrambi questi esempi, se `Ref` per `ParameterName` restituisce `resolvedValue`, la funzione restituisce la seguente stringa JSON:

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

### Conversione di una matrice in una stringa JSON
<a name="intrinsic-function-reference-tojsonstring-example2"></a>

Questo frammento di esempio converte la matrice passata alla funzione intrinseca in una stringa 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
#...
```

In entrambi questi esempi, se `Ref` per `ParameterName` restituisce `resolvedValue`, la funzione restituisce la seguente stringa JSON:

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

## Funzioni supportate
<a name="tojsonstring-supported-functions"></a>

Nella matrice o funzione intrinseca `Fn::ToJsonString` puoi utilizzare le funzioni seguenti:
+ `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`