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à.

# cfn-get-metadata
<a name="cfn-get-metadata"></a>

È possibile utilizzare lo script di `cfn-get-metadata` supporto per recuperare un blocco di metadati CloudFormation e stamparlo sullo standard output. Puoi anche stampare una sottostruttura del blocco di metadati se specifichi una chiave. Tuttavia, solo le chiavi di primo livello sono supportate.

**Topics**
+ [Sintassi](#cfn-get-metadata-Syntax)
+ [Opzioni](#cfn-get-metadata-options)

## Sintassi
<a name="cfn-get-metadata-Syntax"></a>

```
cfn-get-metadata --access-key {{access.key}} \
                 --secret-key {{secret.key}} \
                 --credential-file|f {{credential.file}} \
                 --key|k {{key}} \
                 --stack|-s {{stack.name.or.id}} \
                 --resource|-r {{logical.resource.id}} \
                 --role {{IAM.role.name}} \
                 --url|-u {{service.url}} \
                 --region {{region}}
```

**Nota**  
`cfn-get-metadata` non richiede credenziali, pertanto non è necessario utilizzare le opzioni `--access-key`, `--secret-key`, `--role` o `--credential-file`. Tuttavia, se non viene specificata alcuna credenziale, CloudFormation verifica la sottoscrizione allo stack e limita l'ambito della chiamata allo stack a cui l'istanza appartiene. Per ulteriori informazioni, consulta [Autorizzazioni per gli script helper](cfn-helper-scripts-reference.md#cfn-helper-scripts-reference-permissions).

## Opzioni
<a name="cfn-get-metadata-options"></a>


| Nome | Description | Richiesto | 
| --- | --- | --- | 
|  `-k, --key`  | Per una coppia chiave-valore, restituisce il nome della chiave per il valore specificato.<br />▬*Tipo:* stringa<br />*Esempio*: per `{ "Key1": "SampleKey1", "Key2": "SampleKey2" }`, `cfn-get-metadata -k Key2` restituisce `SampleKey2`. | No | 
|  `-s, --stack`  | Nome dello stack.<br />▬*Tipo:* stringa<br />*Default*: nessuna<br />*Esempio*: `-s { "Ref" : "AWS::StackName" },` | Sì | 
|  `-r, --resource`  | L’ID di risorsa logica della risorsa che contiene i metadati.<br />▬*Tipo:* stringa<br />*Esempio*: `-r WebServerHost` | Sì | 
| `--role` (solo per la segnalazione della risorsa) | Il nome di un ruolo IAM associato all’istanza.<br />▬*Tipo:* stringa<br />Condizione: il parametro del file delle credenziali sostituisce questo parametro. | No | 
|  `--region`  | La regione da cui derivare l'URL. CloudFormation <br />▬*Tipo:* stringa<br />*Default*: nessuna<br />*Esempio*: `--region ", { "Ref" : "AWS::Region" },` | No | 
|  `--access-key`  | AWS Chiave di accesso per un account con autorizzazione DescribeStackResource a CloudFormation chiamare.<br />▬*Tipo:* stringa<br />Condizione: il parametro del file delle credenziali sostituisce questo parametro. | Condizionale | 
|  `--secret-key`  | AWS Chiave segreta che corrisponde alla chiave di AWS accesso specificata.<br />▬*Tipo:* stringa<br />Condizione: il parametro del file delle credenziali sostituisce questo parametro. | Condizionale | 
|  `-f, --credential-file`  | Un file che contiene sia una chiave segreta sia una chiave di accesso.<br />▬*Tipo:* stringa<br />Condizione: il parametro del file delle credenziali sostituisce i parametri di chiave di accesso e chiave segreta. | Condizionale |