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à. # CloudFormation Metadatasintassi del modello `Metadata` archivia informazioni aggiuntive utilizzando oggetti JSON o YAML. I tipi di metadati a livello di modello che puoi utilizzare nel modello includono: Metadati personalizzati Coppie chiave-valore definite dall’utente di archivi Ad esempio, puoi fornire informazioni aggiuntive che non influiscono sulla creazione di risorse ma offrono un contesto aggiuntivo sulle specifiche dell’infrastruttura, del team o dell’implementazione. `AWS::CloudFormation::Interface` Definisce il raggruppamento e l'ordine dei parametri di input quando vengono visualizzati nella console. CloudFormation Per impostazione predefinita, la CloudFormation console ordina alfabeticamente i parametri in base al relativo ID logico. `AWS::CloudFormation::Designer` CloudFormation Designer (Designer) ha raggiunto la fine del ciclo di vita il 5 febbraio 2025. **Importante** Durante l’aggiornamento di uno stack non puoi aggiornare solo la sezione `Metadata`. Puoi aggiornarla solo quando includi modifiche che prevedono l’aggiunta, la modifica o l’eliminazione di risorse. CloudFormation non trasforma, modifica o oscura le informazioni incluse nella `Metadata` sezione. Per questo motivo, si consiglia vivamente di non utilizzare questa sezione per archiviare informazioni riservate, ad esempio password o segreti. ## Sintassi Per dichiarare metadati personalizzati nel CloudFormation modello, utilizzate la seguente sintassi: ### JSON ``` "Metadata" : { "Instances" : {"Description" : "Information about the instances"}, "Databases" : {"Description" : "Information about the databases"} } ``` ### YAML ``` Metadata: Instances: Description: "Information about the instances" Databases: Description: "Information about the databases" ``` Per la sintassi di `AWS::CloudFormation::Interface`, consulta [Organizzazione CloudFormation dei parametri con `AWS::CloudFormation::Interface` metadati](aws-cloudformation-interface.md). # Organizzazione CloudFormation dei parametri con `AWS::CloudFormation::Interface` metadati `AWS::CloudFormation::Interface`è una chiave di metadati che definisce il modo in cui i parametri vengono raggruppati e ordinati nella console. CloudFormation Per impostazione predefinita, la console elenca i parametri di input in ordine alfabetico in base ai relativi ID logici quando crei o aggiorni stack nella stessa. Utilizzando questa chiave, è possibile definire il raggruppamento e l’ordine dei parametri in modo che gli utenti possano specificare i valori dei parametri in modo efficace. Ad esempio, è possibile raggruppare tutti i parametri relativi a EC2 in un gruppo e tutti i parametri relativi a VPC in un altro gruppo. Nel chiave di metadati puoi specificare i gruppi da creare, i parametri da includere in ciascun gruppo e l’ordine in base al quale la console mostra ciascun parametro all’interno del relativo gruppo. Puoi anche definire le etichette dei parametri. Un’etichetta è un nome semplice o una descrizione che la console visualizza invece di visualizzare un ID logico del parametro. Le etichette sono utili per aiutare gli utenti a comprendere i valori da specificare per ciascun parametro. Ad esempio, è possibile creare un’etichetta per un parametro `KeyPair` `Select an EC2 key pair`. Tutti i parametri a cui fai riferimento nella chiave di metadati devono essere dichiarati nella sezione `Parameters` del modello. **Nota** Solo la CloudFormation console utilizza la chiave dei metadati. `AWS::CloudFormation::Interface` AWS CLI e le chiamate API non utilizzano questa chiave. ## Sintassi Per dichiarare questa entità nel tuo CloudFormation modello, usa la seguente sintassi: ### JSON ``` "Metadata" : { "AWS::CloudFormation::Interface" : { "ParameterGroups": [ { "Label": { "default": "Group Label" }, "Parameters": [ "Parameter1", "Parameter2" ] } ], "ParameterLabels": { "Parameter1": { "default": "Friendly Name for Parameter1" } } } } ``` ### YAML ``` Metadata: AWS::CloudFormation::Interface: ParameterGroups: - Label: default: Group Label Parameters: - Parameter1 - Parameter2 ParameterLabels: Parameter1: default: Friendly Name for Parameter1 ``` ## Properties `ParameterGroups` Un elenco dei tipi di gruppo di parametri dove è possibile specificare i nomi di gruppo, i parametri di ciascun gruppo e l’ordine in cui i parametri sono visualizzati. *Obbligatorio:* no `Label` Un nome per il gruppo di parametri. *Obbligatorio:* no `default` L'etichetta predefinita utilizzata dalla CloudFormation console per denominare un gruppo di parametri. *Required*: No ▬*Tipo:* stringa `Parameters` Un elenco di parametri logici con distinzione tra maiuscole e minuscole IDs da includere nel gruppo. I parametri devono essere stati già definiti nella sezione `Parameters` del modello. Un parametro può essere incluso in un solo gruppo di parametri. La console elenca i parametri che non puoi associare a un gruppo di parametri in ordine alfabetico nel gruppo `Other parameters`. *Obbligatorio:* no *Tipo*: elenco di valori stringa `ParameterLabels` Una mappatura dei parametri e dei relativi nomi descrittivi che la CloudFormation console mostra quando uno stack viene creato o aggiornato. *Obbligatorio:* no Etichetta del parametro Un’etichetta per un parametro. L'etichetta definisce un nome o una descrizione descrittiva che la CloudFormation console mostra nella pagina **Specificare i parametri** quando uno stack viene creato o aggiornato. L’etichetta del parametro deve essere l’ID logico, che distingue tra maiuscole e minuscole, di un parametro valido dichiarato nella sezione `Parameters` del modello. *Obbligatorio:* no `default` L'etichetta predefinita utilizzata dalla CloudFormation console per denominare un parametro. *Required*: No ▬*Tipo:* stringa ## Esempio L’esempio seguente definisce due gruppi di parametri: `Network Configuration` e `Amazon EC2 Configuration`. Il gruppo `Network Configuration` include i parametri `VPCID`, `SubnetId` e `SecurityGroupID`, che sono definiti nella sezione `Parameters` del modello (non mostrato). L’ordine in cui la console mostra questi parametri viene definito dall’ordine in cui i parametri sono elencati, a partire dal parametro `VPCID`. L’esempio analogamente raggruppa e ordina i parametri `Amazon EC2 Configuration`. L’esempio definisce anche un’etichetta per il parametro `VPCID`. La console mostrerà **Which VPC should this be deployed to? (In quali VPC deve essere distribuito?)** anziché l’ID logico del parametro (`VPCID`). ### JSON ``` "Metadata" : { "AWS::CloudFormation::Interface" : { "ParameterGroups" : [ { "Label" : { "default" : "Network Configuration" }, "Parameters" : [ "VPCID", "SubnetId", "SecurityGroupID" ] }, { "Label" : { "default":"Amazon EC2 Configuration" }, "Parameters" : [ "InstanceType", "KeyName" ] } ], "ParameterLabels" : { "VPCID" : { "default" : "Which VPC should this be deployed to?" } } } } ``` ### YAML ``` Metadata: AWS::CloudFormation::Interface: ParameterGroups: - Label: default: "Network Configuration" Parameters: - VPCID - SubnetId - SecurityGroupID - Label: default: "Amazon EC2 Configuration" Parameters: - InstanceType - KeyName ParameterLabels: VPCID: default: "Which VPC should this be deployed to?" ``` ### Gruppi di parametri nella console Utilizzando la chiave di metadati di questo esempio, la figura riportata di seguito mostra il modo in cui la console visualizza i gruppi di parametri al momento della creazione o dell’aggiornamento di uno stack: **i gruppi di parametri nella console** ![\[La console mostra i gruppi di parametri per questo esempio.\]](http://docs.aws.amazon.com/it_it/AWSCloudFormation/latest/UserGuide/images/console-create-stack-parameter-groups.png)