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à.
# Informazioni di riferimento sui tipi di proprietà condivisi
Questa sezione contiene informazioni di riferimento dettagliate per i tipi di proprietà che CloudFormation supportano l'uso in più tipi di risorse.
**Topics**
+ [CloudFormation denominazione personalizzata delle risorse](aws-properties-name.md)
+ [CloudFormation etichettatura delle risorse](aws-properties-resource-tags.md)
# CloudFormation denominazione personalizzata delle risorse
Puoi assegnare nomi personalizzati ai tipi di risorse supportati nel tuo CloudFormation modello per renderli più significativi e facilmente identificabili. Per impostazione predefinita, CloudFormation genera un ID fisico univoco per denominare una risorsa. Ad esempio, CloudFormation potrebbe assegnare un nome a un bucket Amazon S3 con il seguente ID fisico. `MyStack-MyBucket-abcdefghijk1` Con i nomi personalizzati, puoi specificare un nome più facile da leggere e identificare, ad esempio `production-app-logs` o `business-metrics`.
Non tutte le risorse supportano i nomi personalizzati. Ogni AWS servizio determina in modo indipendente quali tipi di risorse supportano i nomi personalizzati.
I nomi delle risorse devono essere univoci in tutti gli stack attivi. Se riutilizzi i modelli per creare più stack, è necessario modificare o rimuovere i nomi personalizzati dal modello. Se non specifichi un nome, CloudFormation genera un ID fisico univoco per denominare la risorsa. I nomi devono iniziare con una lettera, devono contenere solo caratteri ASCII, cifre e trattini e non devono terminare con un trattino o contenere due trattini consecutivi.
Inoltre, non gestite le risorse dello stack al di fuori di CloudFormation. Ad esempio, se rinomini una risorsa che fa parte di uno stack senza utilizzarla CloudFormation, potresti ricevere un errore ogni volta che tenti di aggiornare o eliminare quello stack.
**Importante**
Non è possibile eseguire un aggiornamento che provoca la sostituzione di una risorsa con nome personalizzato. Se devi sostituire la risorsa, specifica un nuovo nome.
## Esempio
Se si desidera utilizzare un nome personalizzato, specificare una proprietà di nome per la risorsa nel proprio modello CloudFormation . Ogni risorsa che supporta i nomi personalizzati ha una sua proprietà che va specificata. Ad esempio, per denominare una tabella DynamoDB puoi utilizzare la proprietà `TableName`, come mostrato nell'esempio seguente:
### JSON
```
"myDynamoDBTable" : {
"Type" : "AWS::DynamoDB::Table",
"Properties" : {
"KeySchema" : {
"HashKeyElement": {
"AttributeName" : "AttributeName1",
"AttributeType" : "S"
},
"RangeKeyElement" : {
"AttributeName" : "AttributeName2",
"AttributeType" : "N"
}
},
"ProvisionedThroughput" : {
"ReadCapacityUnits" : "5",
"WriteCapacityUnits" : "10"
},
"TableName" : "SampleTable"
}
}
```
### YAML
```
myDynamoDBTable:
Type: AWS::DynamoDB::Table
Properties:
KeySchema:
HashKeyElement:
AttributeName: "AttributeName1"
AttributeType: "S"
RangeKeyElement:
AttributeName: "AttributeName2"
AttributeType: "N"
ProvisionedThroughput:
ReadCapacityUnits: "5"
WriteCapacityUnits: "10"
TableName: "SampleTable"
```
# CloudFormation etichettatura delle risorse
Puoi applicare tag alle risorse utilizzando la `Tags` proprietà nel CloudFormation modello, che può aiutarti a identificare e classificare tali risorse.
Per informazioni sulle risorse che supportano la proprietà `Tags`, consulta le singole risorse nel [riferimento ai tipi di risorse e proprietà di AWS](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-template-resource-type-ref.html). Se una risorsa non supporta ancora la proprietà `Tags`, il servizio della risorsa potrebbe supportare l’applicazione di tag utilizzando le proprie operazioni API. Per ulteriori informazioni, consulta la documentazione relativa al servizio in questione.
Oltre ai tag che definisci, crea CloudFormation automaticamente i seguenti tag a livello di pila con il prefisso: `aws:`
+ `aws:cloudformation:logical-id`
+ `aws:cloudformation:stack-id`
+ `aws:cloudformation:stack-name`
Il `aws:` prefisso è riservato all'uso. AWS Questo prefisso non fa distinzione tra maiuscole e minuscole. Se si utilizza questo prefisso nella proprietà `Key` o `Value`, non è possibile aggiornare o eliminare il tag. I tag con questo prefisso non contano ai fini del numero di tag per risorsa.
La propagazione dei tag a livello di stack alle risorse, inclusi i tag con il prefisso `aws:`, varia in base al tipo di risorsa. Ad esempio, i tag non sono propagati ai volumi Amazon EBS creati da una mappatura dei dispositivi a blocchi.
**Nota**
Alcune risorse richiedono impostazioni esplicite di propagazione dei tag. Ad esempio, la risorsa `AWS::AutoScaling::AutoScalingGroup` deve avere la proprietà `PropagateAtLaunch` impostata su `true` per propagare i tag alle sue istanze EC2. Tuttavia, i tag a livello di stack vengono applicati automaticamente alle istanze EC2 indipendentemente dall’impostazione `PropagateAtLaunch`.
## Sintassi
### JSON
```
{
"Key" : String,
"Value" : String
}
```
### YAML
```
Key: String
Value: String
```
## Properties
`Key`
Nome chiave del tag. È possibile specificare un valore composto da 1 a 128 caratteri Unicode, che non può avere il prefisso `aws:`. Puoi utilizzare uno qualsiasi dei seguenti caratteri: l'insieme delle lettere Unicode, cifre, spazi, `_`, `.`, `:`, `/`, `=`, `+`, `@`, `-` e `"`.
*Obbligatorio:* sì
▬*Tipo:* stringa
`Value`
Valore per il tag. È possibile specificare un valore di lunghezza compreso tra 1 e 256 caratteri. Puoi utilizzare uno qualsiasi dei seguenti caratteri: l'insieme delle lettere Unicode, cifre, spazi, `_`, `.`, `/`, `=`, `+` e `-`.
*Obbligatorio:* sì
▬*Tipo:* stringa
## Esempio
Questo esempio illustra una proprietà `Tags`. Devi specificare questa proprietà all'interno della sezione `Properties` di una risorsa che la supporta. Quando la risorsa viene creata, il tag `Environment` viene configurato dinamicamente utilizzando un parametro e il tag `Owner` viene impostato staticamente su `MyName`.
### JSON
```
1. "Tags" : [
2. {
3. "Key" : "Environment",
4. "Value" : { "Ref": "Environment" }
5. },
6. {
7. "Key" : "Owner",
8. "Value" : "MyName"
9. }
10. ]
```
### YAML
```
1. Tags:
2. - Key: Environment
3. Value: !Ref Environment
4. - Key: Owner
5. Value: MyName
```
## Consulta anche
+ [Configurazione delle opzioni dello stack](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html#configure-stack-options) nella *Guida per l’utente di AWS CloudFormation *
+ [Visualizzazione dei dati e delle risorse CloudFormation dello stack Console di gestione AWS nella Guida](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-view-stack-data-resources.html) *per l'AWS CloudFormation utente*