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à.
# Importa AWS risorse in una CloudFormation pila
Puoi importare risorse esistenti in uno stack. CloudFormation Ciò è utile se si desidera iniziare a utilizzare CloudFormation per gestire risorse create all'esterno di CloudFormation, senza doverle eliminare e ricreare.
CloudFormation offre le seguenti opzioni per importare risorse esistenti in uno stack:
+ [IaC generator](generate-IaC.md) è uno strumento che analizza automaticamente le risorse esistenti e genera un CloudFormation modello basato sul loro stato attuale. Questo modello può quindi essere utilizzato per importare tali risorse in uno stack.
+ L'[importazione delle risorse](import-resources-manually.md) è un processo manuale in cui si descrivono le risorse esistenti nel CloudFormation modello e quindi le si importa in una pila. Questo approccio richiede di specificare manualmente le proprietà e le configurazioni delle risorse nel modello.
+ L'[importazione automatica](import-resources-automatically.md) è un processo automatico in cui si descrivono le risorse esistenti nel CloudFormation modello e si CloudFormation importano quelle con nomi personalizzati corrispondenti in una pila.
+ Il [refactoring dello stack](stack-refactoring.md) è una funzionalità che semplifica la riorganizzazione delle risorse negli CloudFormation stack preservando al contempo le proprietà e i dati delle risorse esistenti. Con la rifattorizzazione degli stack, puoi spostare le risorse tra gli stack, dividere gli stack monolitici in componenti più piccoli o consolidare più stack in uno solo.
Oltre a CloudFormation gestire le risorse esistenti, la funzionalità di importazione delle risorse può essere utile nei seguenti scenari:
+ **Spostamento delle risorse tra gli stack**: puoi importare risorse da uno stack all’altro, in modo da riorganizzare l’infrastruttura in base alle esigenze.
+ **Nidificazione degli stack esistenti**: puoi importare uno stack esistente come nidificato all’interno di un altro stack, abilitando progetti di infrastruttura modulari e riutilizzabili.
CloudFormation supporta l'importazione di un'ampia gamma di risorse. Per ulteriori informazioni, consulta [Supporto del tipo di risorse](resource-import-supported-resources.md).
**Topics**
+ [Importazione manuale delle risorse AWS](import-resources-manually.md)
+ [Importazione automatica delle risorse AWS](import-resources-automatically.md)
+ [Ripristino di un'operazione di importazione](resource-import-revert.md)
# Importazione AWS manuale delle risorse in uno CloudFormation stack
Con l'importazione delle risorse, puoi importare AWS le risorse esistenti in uno stack nuovo o esistente. CloudFormation Durante un’operazione di importazione, si crea un set di modifiche che importa le risorse esistenti in uno stack o crea un nuovo stack dalle risorse esistenti. Durante l’importazione è possibile fornire quanto segue.
+ Un modello che descrive l’intero stack, incluse le risorse dello stack originali e quelle in fase di importazione. Ogni risorsa da importare deve avere un [attributo DeletionPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-attribute-deletionpolicy.html).
+ Identificatori per le risorse che stai importando che CloudFormation possono essere utilizzati per mappare la logica IDs del modello con le risorse esistenti.
**Nota**
CloudFormation supporta solo un livello di nidificazione utilizzando l'importazione di risorse. Ciò significa che non è possibile importare uno stack in uno stack figlio o importare uno stack con figli.
**Topics**
+ [Identificatori di risorse](#resource-import-identifiers-unique-ids)
+ [Convalida](#resource-import-validation)
+ [Codici di stato](#resource-import-status-codes)
+ [Considerazioni](#resource-import-considerations)
+ [Risorse aggiuntive](#resource-import-additional-resources)
+ [Creazione di uno stack da risorse esistenti](resource-import-new-stack.md)
+ [Importazione di risorse esistenti in uno stack](resource-import-existing-stack.md)
+ [Spostamento di risorse tra stack](refactor-stacks.md)
+ [Nidificazione di uno stack esistente](resource-import-nested-stacks.md)
## Identificatori di risorse
Vengono forniti due valori per identificare ogni risorsa che importi.
+ Una proprietà identificatore. Si tratta di una proprietà di risorsa che può essere utilizzata per identificare ogni tipo di risorsa. Ad esempio, una risorsa `AWS::S3::Bucket` può essere identificata utilizzando il suo `BucketName`.
La proprietà di risorsa che usi per identificare la risorsa che stai importando varia a seconda del tipo di risorsa. Puoi trovare la proprietà della risorsa nella CloudFormation console. Dopo aver creato un modello che include la risorsa da importare, puoi avviare il processo di importazione, dove troverai le proprietà identificatore per le risorse che stai importando. Per alcuni tipi di risorse, potrebbero esserci diverse modalità di identificazione ed è possibile selezionare la proprietà da utilizzare negli elenchi a discesa.
In alternativa, puoi ottenere le proprietà dell'identificatore per le risorse che stai importando chiamando il comando [get-template-summary](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/get-template-summary.html)CLI e specificando l'URL S3 del modello di stack come valore per l'opzione. `--template-url`
+ Un valore identificativo. Questo è il valore effettivo della proprietà della risorsa. Ad esempio, il valore effettivo per la proprietà `BucketName` potrebbe essere `MyS3Bucket`.
È possibile ottenere il valore della proprietà identificatore dalla console di servizio per la risorsa.
## Convalida dell’importazione delle risorse
Durante un'operazione di importazione, esegue le seguenti convalide. CloudFormation
+ La risorsa da importare esiste.
+ Le proprietà e i valori di configurazione per ogni risorsa da importare aderiscono allo schema del tipo di risorsa, che definisce le proprietà accettate, le proprietà richieste e i valori delle proprietà supportate.
+ Le proprietà richieste sono specificate nel modello. Le proprietà richieste per ogni tipo di risorsa sono descritte nell’argomento relativo alle [informazioni di riferimento sulle proprietà e le risorse di AWS](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-template-resource-type-ref.html).
+ La risorsa da importare non appartiene a un altro stack nella stessa Regione.
CloudFormation non verifica che la configurazione del modello corrisponda alla configurazione effettiva delle proprietà delle risorse.
**Importante**
Verifica che le risorse e le rispettive proprietà definite nel modello corrispondano alla configurazione prevista per l’importazione delle risorse per evitare modifiche impreviste.
## Codici di stato dell’importazione delle risorse
Questa tabella descrive i vari tipi di stato utilizzati con la funzionalità di importazione delle risorse.
| Stato dell’operazione di importazione | Description |
| --- | --- |
| `IMPORT_IN_PROGRESS` | L’operazione di importazione è in corso. |
| `IMPORT_COMPLETE` | L’operazione di importazione è stata completata per tutte le risorse nello stack. |
| `IMPORT_ROLLBACK_IN_PROGRESS` | L’operazione di importazione di rollback sta eseguendo il rollback della configurazione del modello precedente. |
| `IMPORT_ROLLBACK_FAILED` | L’operazione di rollback dell’importazione ha avuto esito negativo. |
| `IMPORT_ROLLBACK_COMPLETE` | È stato eseguito il rollback dell’importazione alla configurazione del modello precedente. |
## Considerazioni durante un’operazione di importazione
+ Al termine dell’importazione e prima di eseguire operazioni di stack successive, ti consigliamo di eseguire il rilevamento della deviazione sulle risorse importate. Il rilevamento della deviazione garantisce che la configurazione del modello corrisponda alla configurazione effettiva. Per ulteriori informazioni, consulta [Rileva la deriva su un'intera CloudFormation pila](detect-drift-stack.md).
+ Le operazioni di importazione non consentono nuove creazioni di risorse, eliminazioni di risorse o modifiche alle configurazioni di proprietà.
+ Ogni risorsa da importare deve avere un attributo `DeletionPolicy` affinché l’operazione di importazione abbia esito positivo. È possibile impostare `DeletionPolicy` su qualsiasi valore possibile. Solo le risorse che stai importando necessitano di una `DeletionPolicy`. Le risorse che fanno già parte dello stack non richiedono una `DeletionPolicy`.
+ Non è possibile importare la stessa risorsa in più stack.
+ È possibile utilizzare la condizione della policy IAM `cloudformation:ImportResourceTypes` per controllare i tipi di risorse con cui gli utenti possono lavorare durante un’operazione di importazione. Per ulteriori informazioni, consulta [Chiavi relative alle condizioni politiche per CloudFormation](control-access-with-iam.md#using-iam-conditions).
+ I limiti CloudFormation dello stack si applicano all'importazione di risorse. Per ulteriori informazioni sui limiti, consulta [Comprendi le CloudFormation quote](cloudformation-limits.md).
## Risorse aggiuntive
Per risolvere la deriva dello stack con l’importazione di risorse, consulta [Risoluzione della deviazione con un’operazione di importazione](resource-import-resolve-drift.md).
# Creazione di uno stack da risorse esistenti
Questo argomento mostra come creare uno stack a partire da AWS risorse esistenti descrivendole in un modello. Per cercare invece le risorse esistenti e generare automaticamente un modello da utilizzare per importare risorse esistenti CloudFormation o replicare le risorse in un nuovo account, consulta. [Generazione di modelli da risorse esistenti con il generatore IaC](generate-IaC.md)
**Prerequisiti**
Prima di iniziare, devi:
+ disporre di un modello che descrive tutte le risorse che desideri nel nuovo stack; salvare il modello in locale o in un bucket Amazon S3.
+ Per ogni risorsa che desideri importare, includi:
+ le proprietà e i valori delle proprietà che definiscono la configurazione corrente della risorsa;
+ l’identificativo univoco per la risorsa, ad esempio il nome della risorsa. Per ulteriori informazioni, consulta [Identificatori di risorse](import-resources-manually.md#resource-import-identifiers-unique-ids).
+ gli [Attributi della DeletionPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-attribute-deletionpolicy.html).
**Topics**
+ [Modello di esempio](#resource-import-new-stack-example-template)
+ [Crea uno stack dalle risorse esistenti utilizzando il Console di gestione AWS](#resource-import-new-stack-console)
+ [Crea uno stack dalle risorse esistenti utilizzando il AWS CLI](#resource-import-new-stack-cli)
## Modello di esempio
In questa procedura dettagliata, supponiamo che tu stia utilizzando il seguente modello di esempio, chiamato`TemplateToImport.json`, che specifica due tabelle DynamoDB che sono state create all'esterno di. CloudFormation `ServiceTable`e `GamesTable` sono gli obiettivi dell'importazione.
**Nota**
Questo modello è inteso solo come esempio. Per utilizzarlo per scopi di test, sostituisci le risorse di esempio con le risorse del tuo account.
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Description": "Import test",
"Resources": {
"ServiceTable": {
"Type": "AWS::DynamoDB::Table",
"DeletionPolicy": "Retain",
"Properties": {
"TableName": "Service",
"AttributeDefinitions": [
{
"AttributeName": "key",
"AttributeType": "S"
}
],
"KeySchema": [
{
"AttributeName": "key",
"KeyType": "HASH"
}
],
"ProvisionedThroughput": {
"ReadCapacityUnits": 5,
"WriteCapacityUnits": 1
}
}
},
"GamesTable": {
"Type": "AWS::DynamoDB::Table",
"DeletionPolicy": "Retain",
"Properties": {
"TableName": "Games",
"AttributeDefinitions": [
{
"AttributeName": "key",
"AttributeType": "S"
}
],
"KeySchema": [
{
"AttributeName": "key",
"KeyType": "HASH"
}
],
"ProvisionedThroughput": {
"ReadCapacityUnits": 5,
"WriteCapacityUnits": 1
}
}
}
}
}
```
## Crea uno stack dalle risorse esistenti utilizzando il Console di gestione AWS
1. Accedi Console di gestione AWS e apri la CloudFormation console all'indirizzo [https://console.aws.amazon.com/cloudformazione.](https://console.aws.amazon.com/cloudformation/)
1. Nella pagina **Stack**, scegli **Crea stack**, quindi scegli **Con risorse esistenti (risorse di importazione)**.
![\[L’opzione Crea stack da risorse esistenti nella console.\]](http://docs.aws.amazon.com/it_it/AWSCloudFormation/latest/UserGuide/images/create-stack-with-existing-resources.png)
1. Leggi la pagina **Panoramica importazione** per un elenco di elementi da fornire durante questa operazione. Quindi, seleziona **Successivo**.
1. Nella pagina **Specifica modello**, fornisci il modello utilizzando uno dei metodi descritti di seguito, quindi scegli **Successivo**.
+ Scegli **URL Amazon S3**, quindi specificare l’URL per il tuo modello nella casella di testo.
+ Scegli **Carica un file modello**, quindi cercare il modello.
1. Nella pagina **Identifica risorse**, identifica ogni risorsa di destinazione. Per ulteriori informazioni, consulta [Identificatori di risorse](import-resources-manually.md#resource-import-identifiers-unique-ids).
1. In **Proprietà identificatore**, scegli il tipo di identificatore di risorsa. Ad esempio, la risorsa `AWS::DynamoDB::Table` può essere identificata utilizzando la proprietà `TableName`.
1. In **Valore identificatore**, digita il valore effettivo della proprietà. Ad esempio, il `TableName` per la risorsa `GamesTable` nel modello di esempio è `Games`.
1. Scegli **Successivo**.
1. Nella pagina **Specifica dettagli stack**, modifica i parametri, quindi scegli **Successivo**. Questo crea automaticamente un set di modifiche.
**Importante**
L’operazione di importazione ha esito negativo se si modificano i parametri esistenti che iniziano un’operazione di creazione, aggiornamento o eliminazione.
1. **Nella *stack-name* pagina **Revisione**, conferma che vengano importate le risorse corrette, quindi scegli Importa risorse.** In questo modo si esegue automaticamente il set di modifiche creato nell’ultimo passaggio.
Per il nuovo stack viene visualizzato il riquadro **Eventi** della pagina **Dettagli stack**.
![\[La scheda Eventi nella console.\]](http://docs.aws.amazon.com/it_it/AWSCloudFormation/latest/UserGuide/images/import-events.png)
1. (Facoltativo) Esegui il rilevamento della deviazione nello stack per assicurarti che il modello e la configurazione effettiva delle risorse importate corrispondano. Per ulteriori informazioni sul rilevamento delle deviazioni, consulta [Rileva la deriva su un'intera CloudFormation pila](detect-drift-stack.md).
1. (Facoltativo) Se le risorse importate non corrispondono alle configurazioni dei modelli previste, correggi le configurazioni dei modelli o aggiorna direttamente le risorse. In questa spiegazione passo per passo, vengono corrette le configurazioni dei modelli in modo che corrispondano alle configurazioni effettive.
1. [Ripristina l’operazione di importazione](resource-import-revert.md#resource-import-revert-console) per le risorse interessate.
1. Aggiungi nuovamente le destinazioni di importazione al modello, assicurandoti che le configurazioni del modello corrispondano alle configurazioni effettive.
1. Ripeti i passaggi 2-8 utilizzando il modello modificato per importare nuovamente le risorse.
## Crea uno stack a partire da risorse esistenti utilizzando il AWS CLI
1. Per scoprire quali proprietà identificano ogni tipo di risorsa nel modello, esegui il comando **get-template-summary**, specificando l’URL S3 del modello. Ad esempio, la risorsa `AWS::DynamoDB::Table` può essere identificata utilizzando la proprietà `TableName`. Per la risorsa `GamesTable` nel modello di esempio, il valore di `TableName` è `Games`. Queste informazioni ti serviranno nella fase successiva.
```
aws cloudformation get-template-summary \
--template-url https://amzn-s3-demo-bucket.s3.us-west-2.amazonaws.com/TemplateToImport.json
```
Per ulteriori informazioni, consulta [Identificatori di risorse](import-resources-manually.md#resource-import-identifiers-unique-ids).
1. Componi un elenco delle risorse attuali del modello e dei relativi identificatori univoci nel seguente formato della stringa JSON.
```
[{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"GamesTable","ResourceIdentifier":{"TableName":"Games"}},{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"ServiceTable","ResourceIdentifier":{"TableName":"Service"}}]
```
In alternativa, puoi specificare i parametri formattati JSON in un file di configurazione.
Ad esempio, per importare `ServiceTable` e`GamesTable`, è possibile creare un *ResourcesToImport.txt* file che contenga la seguente configurazione.
```
[
{
"ResourceType":"AWS::DynamoDB::Table",
"LogicalResourceId":"GamesTable",
"ResourceIdentifier":{
"TableName":"Games"
}
},
{
"ResourceType":"AWS::DynamoDB::Table",
"LogicalResourceId":"ServiceTable",
"ResourceIdentifier":{
"TableName":"Service"
}
}
]
```
1. Per creare un set di modifiche, utilizza il seguente comando **create-change-set** e sostituisci il testo segnaposto. Per l’opzione `--change-set-type`, specifica il valore di **IMPORT**. Per l’opzione `--resources-to-import`, sostituisci la stringa JSON di esempio con la stringa JSON effettiva che hai appena creato.
```
aws cloudformation create-change-set \
--stack-name TargetStack --change-set-name ImportChangeSet \
--change-set-type IMPORT \
--template-url https://amzn-s3-demo-bucket.s3.us-west-2.amazonaws.com/TemplateToImport.json \
--resources-to-import '[{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"GamesTable","ResourceIdentifier":{"TableName":"Games"}},{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"ServiceTable","ResourceIdentifier":{"TableName":"Service"}}]'
```
**Nota**
`--resources-to-import` non supporta YAML in linea. I requisiti per l’escape delle virgolette nella stringa JSON variano in base al terminale. Per ulteriori informazioni, consulta [Utilizzo di virgolette all’interno di stringhe](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html#cli-usage-parameters-quoting-strings-containing) nella *Guida per l’utente di AWS Command Line Interface *.
In alternativa, è possibile anche utilizzare l’URL del file come input per l’opzione `--resources-to-import`, come mostrato nell’esempio seguente.
```
--resources-to-import file://ResourcesToImport.txt
```
1. Esamina il set di modifiche per assicurarti che vengano importate le risorse corrette.
```
aws cloudformation describe-change-set \
--change-set-name ImportChangeSet --stack-name TargetStack
```
1. Per avviare il set di modifiche e importare le risorse, utilizza il seguente comando **execute-change-set** e sostituisci il testo segnaposto. Al completamento dell’operazione `(IMPORT_COMPLETE)`, le risorse vengono importate correttamente.
```
aws cloudformation execute-change-set \
--change-set-name ImportChangeSet --stack-name TargetStack
```
1. (Facoltativo) Esegui il rilevamento della deviazione sullo stack `IMPORT_COMPLETE` per assicurarti che il modello e la configurazione effettiva delle risorse importate corrispondano. Per ulteriori informazioni, consulta [Rilevamento della deviazione su singole risorse di stack](detect-drift-resource.md).
1. Esegui il rilevamento della deriva sullo stack specificato.
```
aws cloudformation detect-stack-drift --stack-name TargetStack
```
Se eseguito correttamente, il comando restituirà il seguente output di esempio.
```
{ "Stack-Drift-Detection-Id" : "624af370-311a-11e8-b6b7-500cexample" }
```
1. Visualizza lo stato di avanzamento di un’operazione di rilevamento della deriva per l’ID di rilevamento della deriva dello stack specificato.
```
aws cloudformation describe-stack-drift-detection-status \
--stack-drift-detection-id 624af370-311a-11e8-b6b7-500cexample
```
1. Visualizza le informazioni di deviazione per le risorse la cui deviazione è stata controllata all’interno dello stack specificato.
```
aws cloudformation describe-stack-resource-drifts --stack-name TargetStack
```
1. (Facoltativo) Se le risorse importate non corrispondono alle configurazioni dei modelli previste, correggi le configurazioni dei modelli o aggiorna direttamente le risorse. In questa spiegazione passo per passo, vengono corrette le configurazioni dei modelli in modo che corrispondano alle configurazioni effettive.
1. [Ripristina l’operazione di importazione](resource-import-revert.md#resource-import-revert-cli) per le risorse interessate.
1. Aggiungi nuovamente le destinazioni di importazione al modello, assicurandoti che le configurazioni del modello corrispondano alle configurazioni effettive.
1. Ripeti i passaggi 3-6 utilizzando il modello modificato per importare nuovamente le risorse.
# Importazione di risorse esistenti in uno stack
Questo argomento mostra come importare AWS risorse esistenti in uno stack esistente descrivendole in un modello. Per cercare invece le risorse esistenti e generare automaticamente un modello da utilizzare per importare risorse esistenti CloudFormation o replicare le risorse in un nuovo account, consulta. [Generazione di modelli da risorse esistenti con il generatore IaC](generate-IaC.md)
**Prerequisiti**
Prima di iniziare, devi:
+ Un modello che descrive l’intero stack, incluse le risorse che fanno già parte dello stack e le risorse da importare. Salva il modello in locale o in un bucket Amazon S3.
**Per ottenere una copia del modello di uno stack in esecuzione**
1. Apri la CloudFormation console all'indirizzo [https://console.aws.amazon.com/cloudformation/](https://console.aws.amazon.com/cloudformation/).
1. Dagli elenchi di stack, scegli lo stack da cui recuperare il modello.
1. Nel riquadro dei dettagli dello stack, scegli la scheda **Modello**, quindi scegli **Copia negli appunti**.
1. Incolla il codice in un editor di testo per iniziare ad aggiungere altre risorse al modello.
+ Per ogni risorsa che desideri importare, includi:
+ le proprietà e i valori delle proprietà che definiscono la configurazione corrente della risorsa;
+ l’identificativo univoco per la risorsa, ad esempio il nome della risorsa. Per ulteriori informazioni, consulta [Identificatori di risorse](import-resources-manually.md#resource-import-identifiers-unique-ids).
+ gli [Attributi della DeletionPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-attribute-deletionpolicy.html).
**Topics**
+ [Modello di esempio](#resource-import-existing-stack-example-template)
+ [Importa una risorsa esistente in uno stack utilizzando il Console di gestione AWS](#resource-import-existing-stack-console)
+ [Importa una risorsa esistente in una pila utilizzando il AWS CLI](#resource-import-existing-stack-cli)
## Modello di esempio
In questa procedura guidata, supponiamo che tu stia utilizzando il seguente modello di esempio, chiamato `TemplateToImport.json`, che specifica due tabelle DynamoDB. `ServiceTable` è attualmente parte dello stack e `GamesTable` è la tabella che desideri importare.
**Nota**
Questo modello è inteso solo come esempio. Per utilizzarlo per scopi di test, sostituisci le risorse di esempio con le risorse del tuo account.
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Description": "Import test",
"Resources": {
"ServiceTable": {
"Type": "AWS::DynamoDB::Table",
"Properties": {
"TableName": "Service",
"AttributeDefinitions": [
{
"AttributeName": "key",
"AttributeType": "S"
}
],
"KeySchema": [
{
"AttributeName": "key",
"KeyType": "HASH"
}
],
"ProvisionedThroughput": {
"ReadCapacityUnits": 5,
"WriteCapacityUnits": 1
}
}
},
"GamesTable": {
"Type": "AWS::DynamoDB::Table",
"DeletionPolicy": "Retain",
"Properties": {
"TableName": "Games",
"AttributeDefinitions": [
{
"AttributeName": "key",
"AttributeType": "S"
}
],
"KeySchema": [
{
"AttributeName": "key",
"KeyType": "HASH"
}
],
"ProvisionedThroughput": {
"ReadCapacityUnits": 5,
"WriteCapacityUnits": 1
}
}
}
}
}
```
## Importa una risorsa esistente in uno stack utilizzando il Console di gestione AWS
**Nota**
La CloudFormation console non supporta l'uso della funzione intrinseca `Fn::Transform` durante l'importazione di risorse. È possibile utilizzare il AWS CLI per importare risorse che utilizzano la funzione. `Fn::Transform`
1. Accedi Console di gestione AWS e apri la CloudFormation console all'indirizzo [https://console.aws.amazon.com/cloudformazione.](https://console.aws.amazon.com/cloudformation/)
1. Nella pagina **Stack**, scegli lo stack in cui importare le risorse.
1. Scegli **Operazioni stack**, quindi scegli **Importa risorse nello stack**.
![\[L’opzione Importa risorse nello stack nella console.\]](http://docs.aws.amazon.com/it_it/AWSCloudFormation/latest/UserGuide/images/stack-actions-import.png)
1. Rivedi la pagina **Panoramica importazione**, quindi scegli **Successivo**.
1. Nella pagina **Specifica modello**, fornisci il modello aggiornato utilizzando uno dei metodi descritti di seguito, quindi scegli **Successivo**.
+ Scegli **URL Amazon S3**, quindi specifica l’URL per il tuo modello nella casella di testo.
+ Scegli **Carica un file modello**, quindi cercare il modello.
1. Nella pagina **Identifica risorse**, identifica ogni risorsa di destinazione. Per ulteriori informazioni, consulta [Identificatori di risorse](import-resources-manually.md#resource-import-identifiers-unique-ids).
1. In **Proprietà identificatore**, scegli il tipo di identificatore di risorsa. Ad esempio, la risorsa `AWS::DynamoDB::Table` può essere identificata utilizzando la proprietà `TableName`.
1. In **Valore identificatore**, digita il valore effettivo della proprietà. Ad esempio, il `TableName` per la risorsa `GamesTable` nel modello di esempio è `Games`.
1. Scegli **Successivo**.
1. Nella pagina **Specifica dettagli stack**, aggiorna i parametri, quindi scegli **Successivo**. Questo crea automaticamente un set di modifiche.
**Nota**
L’operazione di importazione ha esito negativo se si modificano i parametri esistenti che iniziano un’operazione di creazione, aggiornamento o eliminazione.
1. **Nella *stack-name* pagina **Revisione**, esamina le risorse da importare, quindi scegli Importa risorse.** In questo modo si esegue automaticamente il set di modifiche creato nell’ultimo passaggio. Tutti i tag a livello di stack vengono applicati alle risorse importate in questo momento. Per ulteriori informazioni, consulta [Configurazione delle opzioni dello stack](cfn-console-create-stack.md#configure-stack-options).
Viene visualizzata la pagina **Eventi** per lo stack.
![\[La scheda Eventi nella console.\]](http://docs.aws.amazon.com/it_it/AWSCloudFormation/latest/UserGuide/images/import-events.png)
1. (Facoltativo) Esegui il rilevamento della deviazione nello stack per assicurarti che il modello e la configurazione effettiva delle risorse importate corrispondano. Per ulteriori informazioni sul rilevamento delle deviazioni, consulta [Rileva la deriva su un'intera CloudFormation pila](detect-drift-stack.md).
1. (Facoltativo) Se le risorse importate non corrispondono alle configurazioni dei modelli previste, correggi le configurazioni dei modelli o aggiorna direttamente le risorse. Per ulteriori informazioni sull’importazione delle risorse con deviazioni, consulta [Risoluzione della deviazione con un’operazione di importazione](resource-import-resolve-drift.md).
## Importa una risorsa esistente in una pila utilizzando il AWS CLI
1. Per scoprire quali proprietà identificano ogni tipo di risorsa nel modello, esegui il comando **get-template-summary**, specificando l’URL S3 del modello. Ad esempio, la risorsa `AWS::DynamoDB::Table` può essere identificata utilizzando la proprietà `TableName`. Per la risorsa `GamesTable` nel modello di esempio, il valore di `TableName` è `Games`. Queste informazioni ti serviranno nella fase successiva.
```
aws cloudformation get-template-summary \
--template-url https://amzn-s3-demo-bucket.s3.us-west-2.amazonaws.com/TemplateToImport.json
```
Per ulteriori informazioni, consulta [Identificatori di risorse](import-resources-manually.md#resource-import-identifiers-unique-ids).
1. Componi un elenco di risorse attuali da importare e di relativi identificatori univoci nel seguente formato della stringa JSON.
```
[{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"GamesTable","ResourceIdentifier":{"TableName":"Games"}}]
```
In alternativa, puoi specificare i parametri formattati JSON in un file di configurazione.
Ad esempio, per importare`GamesTable`, è possibile creare un *ResourcesToImport.txt* file che contenga la seguente configurazione.
```
[
{
"ResourceType":"AWS::DynamoDB::Table",
"LogicalResourceId":"GamesTable",
"ResourceIdentifier": {
"TableName":"Games"
}
}
]
```
1. Per creare un set di modifiche, utilizza il seguente comando **create-change-set** e sostituisci il testo segnaposto. Per l’opzione `--change-set-type`, specifica il valore di **IMPORT**. Per l’opzione `--resources-to-import`, sostituisci la stringa JSON di esempio con la stringa JSON effettiva che hai appena creato.
```
aws cloudformation create-change-set \
--stack-name TargetStack --change-set-name ImportChangeSet \
--change-set-type IMPORT \
--template-url https://amzn-s3-demo-bucket.s3.us-west-2.amazonaws.com/TemplateToImport.json \
--resources-to-import '[{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"GamesTable","ResourceIdentifier":{"TableName":"Games"}}]'
```
**Nota**
`--resources-to-import` non supporta YAML in linea. I requisiti per l’escape delle virgolette nella stringa JSON variano in base al terminale. Per ulteriori informazioni, consulta [Utilizzo di virgolette all’interno di stringhe](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html#cli-usage-parameters-quoting-strings-containing) nella *Guida per l’utente di AWS Command Line Interface *.
In alternativa, è possibile anche utilizzare l’URL del file come input per l’opzione `--resources-to-import`, come mostrato nell’esempio seguente.
```
--resources-to-import file://ResourcesToImport.txt
```
1. Esamina il set di modifiche per assicurarti che vengano importate le risorse corrette.
```
aws cloudformation describe-change-set \
--change-set-name ImportChangeSet --stack-name TargetStack
```
1. Per avviare il set di modifiche e importare le risorse, utilizza il seguente comando **execute-change-set** e sostituisci il testo segnaposto. Tutti i tag a livello di stack vengono applicati alle risorse importate in questo momento. Per ulteriori informazioni, consulta [Configurazione delle opzioni dello stack](cfn-console-create-stack.md#configure-stack-options). Al completamento dell’operazione `(IMPORT_COMPLETE)`, le risorse vengono importate correttamente.
```
aws cloudformation execute-change-set \
--change-set-name ImportChangeSet --stack-name TargetStack
```
1. (Facoltativo) Esegui il rilevamento della deviazione sullo stack `IMPORT_COMPLETE` per assicurarti che il modello e la configurazione effettiva delle risorse importate corrispondano. Per ulteriori informazioni sul rilevamento delle deviazioni, consulta [Rileva la deriva su un'intera CloudFormation pila](detect-drift-stack.md).
1. Esegui il rilevamento della deriva sullo stack specificato.
```
aws cloudformation detect-stack-drift --stack-name TargetStack
```
Se eseguito correttamente, il comando restituirà il seguente output di esempio.
```
{ "Stack-Drift-Detection-Id" : "624af370-311a-11e8-b6b7-500cexample" }
```
1. Visualizza lo stato di avanzamento di un’operazione di rilevamento della deriva per l’ID di rilevamento della deriva dello stack specificato.
```
aws cloudformation describe-stack-drift-detection-status \
--stack-drift-detection-id 624af370-311a-11e8-b6b7-500cexample
```
1. Visualizza le informazioni di deviazione per le risorse la cui deviazione è stata controllata all’interno dello stack specificato.
```
aws cloudformation describe-stack-resource-drifts --stack-name TargetStack
```
1. (Facoltativo) Se le risorse importate non corrispondono alle configurazioni dei modelli previste, correggi le configurazioni dei modelli o aggiorna direttamente le risorse. Per ulteriori informazioni sull’importazione delle risorse con deviazioni, consulta [Risoluzione della deviazione con un’operazione di importazione](resource-import-resolve-drift.md).
# Spostamento di risorse tra stack
Utilizzando la funzionalità `resource import`, è possibile spostare le risorse tra stack o eseguirne il *refactoring*. Prima di tutto è necessario aggiungere una policy di eliminazione `Retain` alla risorsa da spostare per fare in modo che la risorsa venga mantenuta quando viene rimossa dallo stack di origine e importata nello stack di destinazione.
Se non conosci l’importazione, ti consigliamo di esaminare prima le informazioni introduttive nella sezione [Importa AWS risorse in una CloudFormation pila](import-resources.md).
**Importante**
Non tutte le risorse supportano le operazioni di importazione. Consulta [Risorse che supportano le operazioni di importazione](resource-import-supported-resources.md) prima di rimuovere una risorsa dallo stack. Se rimuovi una risorsa che non supporta le operazioni di importazione dallo stack, non potrai importarla in un altro stack o riportarla nello stack di origine.
## Rifattorizza uno stack usando il Console di gestione AWS
1. Nel modello di origine, specificate a `Retain` [DeletionPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-attribute-deletionpolicy.html)per la risorsa che desiderate spostare.
Nel seguente modello di origine di esempio, `Games` è la destinazione di questo refactoring.
**Example JSON**
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Description": "Import test",
"Resources": {
"ServiceTable":{
"Type":"AWS::DynamoDB::Table",
"Properties":{
"TableName":"Service",
"AttributeDefinitions":[
{
"AttributeName":"key",
"AttributeType":"S"
}
],
"KeySchema":[
{
"AttributeName":"key",
"KeyType":"HASH"
}
],
"ProvisionedThroughput":{
"ReadCapacityUnits":5,
"WriteCapacityUnits":1
}
}
},
"GamesTable": {
"Type": "AWS::DynamoDB::Table",
"DeletionPolicy": "Retain",
"Properties": {
"TableName": "Games",
"AttributeDefinitions": [
{
"AttributeName": "key",
"AttributeType": "S"
}
],
"KeySchema": [
{
"AttributeName": "key",
"KeyType": "HASH"
}
],
"ProvisionedThroughput": {
"ReadCapacityUnits": 5,
"WriteCapacityUnits": 1
}
}
}
}
}
```
1. Apri la CloudFormation console per eseguire un aggiornamento dello stack per applicare la politica di eliminazione.
1. Nella pagina **Stack** con lo stack selezionato, scegliere **Aggiorna**.
1. In **Prepara modello**, scegliere **Sostituisci modello corrente**.
1. In **Specifica modello**, fornire il modello di origine aggiornato con l’attributo `DeletionPolicy` su `GamesTable`, quindi scegliere **Successivo**.
+ Scegliere **URL Amazon S3**, quindi specificare l’URL per il modello di origine aggiornato nella casella di testo.
+ Scegliere **Carica un file modello**, quindi cercare il file modello di origine aggiornato.
1. Nella pagina **Specifica dettagli stack**, non sono necessarie modifiche. Scegli **Successivo**.
1. Nella pagina **Configura opzioni stack** non sono necessarie modifiche. Scegli **Next (Successivo)**.
1. Nella *SourceStackName* pagina **Revisione**, rivedi le modifiche. Se il modello contiene risorse IAM, selezionare**Acconsento che questo modello possa creare risorse IAM** per specificare che si desidera utilizzare risorse IAM nel modello. Per ulteriori informazioni sull’utilizzo delle risorse IAM nei modelli, consulta [Controlla CloudFormation l'accesso con AWS Identity and Access Management](control-access-with-iam.md). Quindi, aggiornare lo stack di origine creando un set di modifiche o aggiornare direttamente lo stack di origine.
1. Rimuovi la risorsa , i parametri correlati e gli output dal modello di origine, quindi aggiungili al modello di destinazione.
Il modello di origine ora è simile al seguente.
**Example JSON**
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Description": "Import test",
"Resources": {
"ServiceTable":{
"Type":"AWS::DynamoDB::Table",
"Properties":{
"TableName":"Service",
"AttributeDefinitions":[
{
"AttributeName":"key",
"AttributeType":"S"
}
],
"KeySchema":[
{
"AttributeName":"key",
"KeyType":"HASH"
}
],
"ProvisionedThroughput":{
"ReadCapacityUnits":5,
"WriteCapacityUnits":1
}
}
}
}
}
```
Il seguente modello di destinazione di esempio ha attualmente la risorsa `PlayersTable` e ora contiene anche `GamesTable`.
**Example JSON**
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Description": "Import test",
"Resources": {
"PlayersTable": {
"Type": "AWS::DynamoDB::Table",
"Properties": {
"TableName": "Players",
"AttributeDefinitions": [
{
"AttributeName": "key",
"AttributeType": "S"
}
],
"KeySchema": [
{
"AttributeName": "key",
"KeyType": "HASH"
}
],
"ProvisionedThroughput": {
"ReadCapacityUnits": 5,
"WriteCapacityUnits": 1
}
}
},
"GamesTable": {
"Type": "AWS::DynamoDB::Table",
"DeletionPolicy": "Retain",
"Properties": {
"TableName": "Games",
"AttributeDefinitions": [
{
"AttributeName": "key",
"AttributeType": "S"
}
],
"KeySchema": [
{
"AttributeName": "key",
"KeyType": "HASH"
}
],
"ProvisionedThroughput": {
"ReadCapacityUnits": 5,
"WriteCapacityUnits": 1
}
}
}
}
}
```
1. Ripeti i passaggi 2-3 per aggiornare nuovamente lo stack di origine, questa volta per eliminare la risorsa di destinazione dallo stack.
1. Eseguire un’operazione di importazione per aggiungere `GamesTable` allo stack di destinazione.
1. Nella pagina **Stack** con lo stack padre selezionato, scegliere **Operazioni stack**, quindi scegliere **Importa risorse nello stack**.
![\[L’opzione Importa risorse nello stack nella console.\]](http://docs.aws.amazon.com/it_it/AWSCloudFormation/latest/UserGuide/images/stack-actions-import.png)
1. Leggere la pagina **Panoramica importazione** per un elenco di elementi da fornire durante questa operazione. Quindi, seleziona **Next**.
1. Nella pagina **Specify template** completa una delle seguenti operazioni, quindi scegli **Next**.
+ Scegliere **URL Amazon S3**, quindi specificare un URL nella casella di testo.
+ Scegliere **Carica un file modello**, quindi cercare un file da caricare.
1. Nella pagina **Identifica risorse**, identificare la risorsa che si sta spostando (in questo esempio `GamesTable`). Per ulteriori informazioni, consulta [Identificatori di risorse](import-resources-manually.md#resource-import-identifiers-unique-ids).
1. In **Proprietà identificatore**, scegliere il tipo di identificatore di risorsa. Ad esempio, una risorsa `AWS::DynamoDB::Table` può essere identificata utilizzando la proprietà `TableName`.
1. In **Valore identificatore**, digitare il valore effettivo della proprietà. Ad esempio, `GamesTables`.
1. Scegli **Next (Successivo)**.
1. Nella pagina **Specifica dettagli stack**, modifica i parametri, quindi scegli **Successivo**. Questo crea automaticamente un set di modifiche.
**Importante**
L’operazione di importazione ha esito negativo se si modificano i parametri esistenti che iniziano un’operazione di creazione, aggiornamento o eliminazione.
1. Nella *TargetStackName* pagina **Revisione**, conferma che sia stata importata la risorsa corretta, quindi scegli **Importa risorse**. In questo modo il set di modifiche creato nell’ultima fase viene avviato automaticamente. Tutti i [tag a livello di stack](cfn-console-create-stack.md#configure-stack-options) vengono applicati alle risorse importate in questo momento.
1. Per lo stack padre viene visualizzato il riquadro **Eventi** della pagina **Dettagli stack**.
![\[La scheda Eventi nella console.\]](http://docs.aws.amazon.com/it_it/AWSCloudFormation/latest/UserGuide/images/import-events.png)
**Nota**
Non è necessario eseguire il rilevamento della deviazione nello stack padre dopo questa operazione di importazione perché la risorsa `AWS::CloudFormation::Stack` è già gestita da CloudFormation.
## Effettua il refactoring di uno stack utilizzando il AWS CLI
1. Nel modello di origine, specificate a `Retain` [DeletionPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-attribute-deletionpolicy.html)per la risorsa che desiderate spostare.
Nel seguente modello di origine di esempio, `GamesTable` è la destinazione di questo refactoring.
**Example JSON**
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Description": "Import test",
"Resources": {
"ServiceTable":{
"Type":"AWS::DynamoDB::Table",
"Properties":{
"TableName":"Service",
"AttributeDefinitions":[
{
"AttributeName":"key",
"AttributeType":"S"
}
],
"KeySchema":[
{
"AttributeName":"key",
"KeyType":"HASH"
}
],
"ProvisionedThroughput":{
"ReadCapacityUnits":5,
"WriteCapacityUnits":1
}
}
},
"GamesTable": {
"Type": "AWS::DynamoDB::Table",
"DeletionPolicy": "Retain",
"Properties": {
"TableName": "Games",
"AttributeDefinitions": [
{
"AttributeName": "key",
"AttributeType": "S"
}
],
"KeySchema": [
{
"AttributeName": "key",
"KeyType": "HASH"
}
],
"ProvisionedThroughput": {
"ReadCapacityUnits": 5,
"WriteCapacityUnits": 1
}
}
}
}
}
```
1. Aggiornare lo stack di origine per applicare la policy di eliminazione alla risorsa.
```
aws cloudformation update-stack --stack-name SourceStackName
```
1. Rimuovi la risorsa, i parametri correlati e gli output dal modello di origine, quindi aggiungili al modello di destinazione.
Il modello di origine ora è simile al seguente.
**Example JSON**
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Description": "Import test",
"Resources": {
"ServiceTable":{
"Type":"AWS::DynamoDB::Table",
"Properties":{
"TableName":"Service",
"AttributeDefinitions":[
{
"AttributeName":"key",
"AttributeType":"S"
}
],
"KeySchema":[
{
"AttributeName":"key",
"KeyType":"HASH"
}
],
"ProvisionedThroughput":{
"ReadCapacityUnits":5,
"WriteCapacityUnits":1
}
}
}
}
}
```
Il seguente modello di destinazione di esempio ha attualmente la risorsa `PlayersTable` e ora contiene anche `GamesTable`.
**Example JSON**
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Description": "Import test",
"Resources": {
"PlayersTable": {
"Type": "AWS::DynamoDB::Table",
"Properties": {
"TableName": "Players",
"AttributeDefinitions": [
{
"AttributeName": "key",
"AttributeType": "S"
}
],
"KeySchema": [
{
"AttributeName": "key",
"KeyType": "HASH"
}
],
"ProvisionedThroughput": {
"ReadCapacityUnits": 5,
"WriteCapacityUnits": 1
}
}
},
"GamesTable": {
"Type": "AWS::DynamoDB::Table",
"DeletionPolicy": "Retain",
"Properties": {
"TableName": "Games",
"AttributeDefinitions": [
{
"AttributeName": "key",
"AttributeType": "S"
}
],
"KeySchema": [
{
"AttributeName": "key",
"KeyType": "HASH"
}
],
"ProvisionedThroughput": {
"ReadCapacityUnits": 5,
"WriteCapacityUnits": 1
}
}
}
}
}
```
1. Aggiornare lo stack di origine per eliminare la risorsa `GamesTable` e i relativi parametri e output dallo stack.
```
aws cloudformation update-stack --stack-name SourceStackName
```
1. Componi un elenco di risorse attuali da importare e di relativi identificatori univoci nel seguente formato della stringa JSON. Per ulteriori informazioni, consulta [Identificatori di risorse](import-resources-manually.md#resource-import-identifiers-unique-ids).
```
[{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"GamesTable","ResourceIdentifier":{"TableName":"Games"}}]
```
In alternativa, puoi specificare i parametri formattati JSON in un file di configurazione.
Ad esempio, per importare`GamesTable`, potreste creare un *ResourcesToImport.txt* file che contenga la seguente configurazione.
```
[
{
"ResourceType":"AWS::DynamoDB::Table",
"LogicalResourceId":"GamesTable",
"ResourceIdentifier": {
"TableName":"Games"
}
}
]
```
1. Per creare un set di modifiche, utilizza il seguente comando **create-change-set** e sostituisci il testo segnaposto. Per l’opzione `--change-set-type`, specifica il valore di **IMPORT**. Per l’opzione `--resources-to-import`, sostituisci la stringa JSON di esempio con la stringa JSON effettiva che hai appena creato.
```
aws cloudformation create-change-set \
--stack-name TargetStackName --change-set-name ImportChangeSet \
--change-set-type IMPORT \
--template-body file://TemplateToImport.json \
--resources-to-import "'[{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"GamesTable","ResourceIdentifier":{"TableName":"Games"}}]'"
```
**Nota**
`--resources-to-import` non supporta YAML in linea. I requisiti per l’escape delle virgolette nella stringa JSON variano in base al terminale. Per ulteriori informazioni, consulta [Utilizzo di virgolette all’interno di stringhe](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html#cli-usage-parameters-quoting-strings-containing) nella *Guida per l’utente di AWS Command Line Interface *.
In alternativa, è possibile anche utilizzare l’URL del file come input per l’opzione `--resources-to-import`, come mostrato nell’esempio seguente.
```
--resources-to-import file://ResourcesToImport.txt
```
1. Esaminare il set di modifiche per assicurarsi che la risorsa corretta venga importata nello stack di destinazione.
```
aws cloudformation describe-change-set \
--change-set-name ImportChangeSet
```
1. Per creare un set di modifiche, utilizza il seguente comando **execute-change-set** e sostituisci il testo segnaposto. Tutti i tag a livello di stack vengono applicati alle risorse importate in questo momento. Al completamento dell’operazione `(IMPORT_COMPLETE)`, la risorsa viene importata correttamente.
```
aws cloudformation execute-change-set \
--change-set-name ImportChangeSet --stack-name TargetStackName
```
**Nota**
Non è necessario eseguire il rilevamento della deviazione nello stack di destinazione dopo questa operazione di importazione perché la risorsa è già gestita da CloudFormation.
# Nidificazione di uno stack esistente
Utilizzare la funzionalità `resource import` per nidificare uno stack esistente all’interno di un altro stack esistente. Gli stack nidificati sono componenti comuni che l’utente dichiara e vi fa riferimento all’interno di altri modelli. In questo modo, è possibile evitare di copiare e incollare le stesse configurazioni nei modelli e semplificare gli aggiornamenti dello stack. Se si dispone di un modello per un componente comune, è possibile utilizzare la risorsa `AWS::CloudFormation::Stack` per fare riferimento a questo modello da un altro modello. Per ulteriori informazioni sugli stack nidificati, consulta [Dividi un modello in pezzi riutilizzabili usando stack nidificati](using-cfn-nested-stacks.md).
CloudFormation supporta solo un livello di nidificazione. `resource import` Ciò significa che non è possibile importare uno stack in uno stack figlio o importare uno stack con figli.
Se non hai mai effettuato l’importazione, ti consigliamo di esaminare prima le informazioni introduttive nella sezione [Importazione AWS manuale delle risorse in uno CloudFormation stack](import-resources-manually.md).
## Convalida dell’importazione dello stack nidificato
Durante un'operazione di importazione di stack annidati, CloudFormation esegue le seguenti convalide.
+ La definizione `AWS::CloudFormation::Stack` nidificata nel modello di stack padre corrisponde al modello dello stack nidificato effettivo.
+ I tag per la definizione `AWS::CloudFormation::Stack` nidificata nel modello di stack padre corrispondono ai tag per la risorsa stack nidificata effettiva.
## Annidate uno stack esistente utilizzando il Console di gestione AWS
1. Aggiungi la `AWS::CloudFormation::Stack` risorsa al modello dello stack principale con un. `Retain` [DeletionPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-attribute-deletionpolicy.html) Nel seguente modello di stack padre di esempio, `MyNestedStack` è la destinazione dell’importazione.
**JSON**
```
{
"AWSTemplateFormatVersion" : "2010-09-09",
"Resources" : {
"ServiceTable":{
"Type":"AWS::DynamoDB::Table",
"Properties":{
"TableName":"Service",
"AttributeDefinitions":[
{
"AttributeName":"key",
"AttributeType":"S"
}
],
"KeySchema":[
{
"AttributeName":"key",
"KeyType":"HASH"
}
],
"ProvisionedThroughput":{
"ReadCapacityUnits":5,
"WriteCapacityUnits":1
}
}
},
"MyNestedStack" : {
"Type" : "AWS::CloudFormation::Stack",
"DeletionPolicy": "Retain",
"Properties" : {
"TemplateURL" : "https://s3.amazonaws.com/cloudformation-templates-us-east-2/EC2ChooseAMI.template",
"Parameters" : {
"InstanceType" : "t1.micro",
"KeyName" : "mykey"
}
}
}
}
}
```
**YAML**
```
AWSTemplateFormatVersion: 2010-09-09
Resources:
ServiceTable:
Type: AWS::DynamoDB::Table
Properties:
TableName: Service
AttributeDefinitions:
- AttributeName: key
AttributeType: S
KeySchema:
- AttributeName: key
KeyType: HASH
ProvisionedThroughput:
ReadCapacityUnits: 5
WriteCapacityUnits: 1
MyNestedStack:
Type: AWS::CloudFormation::Stack
DeletionPolicy: Retain
Properties:
TemplateURL: >-
https://s3.amazonaws.com/cloudformation-templates-us-east-2/EC2ChooseAMI.template
Parameters:
InstanceType: t1.micro
KeyName: mykey
```
1. Apri la CloudFormation console.
1. Nella pagina **Stack** con lo stack padre selezionato, scegliere **Operazioni stack**, quindi scegliere **Importa risorse nello stack**.
![\[L’opzione Importa risorse nello stack nella console.\]](http://docs.aws.amazon.com/it_it/AWSCloudFormation/latest/UserGuide/images/stack-actions-import.png)
1. Leggere la pagina **Panoramica importazione** per un elenco di elementi da fornire durante questa operazione. Quindi, seleziona **Successivo**.
1. Nella pagina **Specifica modello**, fornire il modello padre aggiornato utilizzando uno dei metodi descritti di seguito, quindi scegliere **Successivo**.
+ Scegliere **URL Amazon S3**, quindi specificare l’URL per il tuo modello nella casella di testo.
+ Scegliere **Carica un file modello**, quindi cercare il modello.
1. Nella pagina **Identifica risorse**, identifica la risorsa `AWS::CloudFormation::Stack`.
1. In **Proprietà identificatore**, scegliere il tipo di identificatore di risorsa. Ad esempio, una risorsa `AWS::CloudFormation::Stack` può essere identificata utilizzando la proprietà `StackId`.
1. In **Valore identificatore**, digita l’ARN dello stack che stai importando. Ad esempio, `arn:aws:cloudformation:us-west-2:12345678910:stack/mystack/5b918d10-cd98-11ea-90d5-0a9cd3354c10`.
![\[La pagina relativa all’identificazione delle risorse nella console.\]](http://docs.aws.amazon.com/it_it/AWSCloudFormation/latest/UserGuide/images/resource-import-stackid.png)
1. Scegli **Successivo**.
1. Nella pagina **Specifica dettagli stack**, modifica i parametri, quindi scegli **Successivo**. Questo crea automaticamente un set di modifiche.
**Importante**
L’operazione di importazione ha esito negativo se si modificano i parametri esistenti che iniziano un’operazione di creazione, aggiornamento o eliminazione.
1. Nella *MyParentStack* pagina **Revisione**, conferma che sia stata importata la risorsa corretta, quindi scegli **Importa risorse**. In questo modo si esegue automaticamente il set di modifiche creato nell’ultimo passaggio. Tutti i tag a livello di stack vengono applicati alle risorse importate in questo momento.
1. Per lo stack padre viene visualizzato il riquadro **Eventi** della pagina **Dettagli stack**.
![\[La scheda Eventi nella console.\]](http://docs.aws.amazon.com/it_it/AWSCloudFormation/latest/UserGuide/images/import-events.png)
**Nota**
Non è necessario eseguire il rilevamento della deviazione nello stack padre dopo questa operazione di importazione perché la risorsa `AWS::CloudFormation::Stack` era già gestita da CloudFormation.
## Annidate uno stack esistente utilizzando il AWS CLI
1. Aggiungi la `AWS::CloudFormation::Stack` risorsa al modello dello stack principale con un. `Retain` [DeletionPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-attribute-deletionpolicy.html) Nel seguente modello padre di esempio, `MyNestedStack` è la destinazione dell’importazione.
**JSON**
```
{
"AWSTemplateFormatVersion" : "2010-09-09",
"Resources" : {
"ServiceTable":{
"Type":"AWS::DynamoDB::Table",
"Properties":{
"TableName":"Service",
"AttributeDefinitions":[
{
"AttributeName":"key",
"AttributeType":"S"
}
],
"KeySchema":[
{
"AttributeName":"key",
"KeyType":"HASH"
}
],
"ProvisionedThroughput":{
"ReadCapacityUnits":5,
"WriteCapacityUnits":1
}
}
},
"MyNestedStack" : {
"Type" : "AWS::CloudFormation::Stack",
"DeletionPolicy": "Retain",
"Properties" : {
"TemplateURL" : "https://s3.amazonaws.com/cloudformation-templates-us-east-2/EC2ChooseAMI.template",
"Parameters" : {
"InstanceType" : "t1.micro",
"KeyName" : "mykey"
}
}
}
}
}
```
**YAML**
```
AWSTemplateFormatVersion: 2010-09-09
Resources:
ServiceTable:
Type: AWS::DynamoDB::Table
Properties:
TableName: Service
AttributeDefinitions:
- AttributeName: key
AttributeType: S
KeySchema:
- AttributeName: key
KeyType: HASH
ProvisionedThroughput:
ReadCapacityUnits: 5
WriteCapacityUnits: 1
MyNestedStack:
Type: AWS::CloudFormation::Stack
DeletionPolicy: Retain
Properties:
TemplateURL: >-
https://s3.amazonaws.com/cloudformation-templates-us-east-2/EC2ChooseAMI.template
Parameters:
InstanceType: t1.micro
KeyName: mykey
```
1. Componi una stringa JSON come mostrato nell’esempio seguente, con queste modifiche:
+ Sostituisci *MyNestedStack* con l'ID logico della risorsa di destinazione come specificato nel modello.
+ Sostituisci *arn:aws:cloudformation:us-west-2:12345678910:stack/mystack/5b918d10-cd98-11ea-90d5-0a9cd3354c10* con l'ARN dello stack che desideri importare.
```
[{"ResourceType":"AWS::CloudFormation::Stack","LogicalResourceId":"MyNestedStack","ResourceIdentifier":{"StackId":"arn:aws:cloudformation:us-east-2:123456789012:stack/mystack/5b918d10-cd98-11ea-90d5-0a9cd3354c10"}}]
```
In alternativa, puoi specificare i parametri in un file di configurazione.
Ad esempio, per importare`MyNestedStack`, potreste creare un *ResourcesToImport.txt* file che contenga la seguente configurazione.
**JSON**
```
[
{
"ResourceType":"AWS::CloudFormation::Stack",
"LogicalResourceId":"MyNestedStack",
"ResourceIdentifier": {
"StackId":"arn:aws:cloudformation:us-west-2:12345678910:stack/mystack/5b918d10-cd98-11ea-90d5-0a9cd3354c10"
}
}
]
```
**YAML**
```
ResourceType: AWS::CloudFormation::Stack
LogicalResourceId: MyNestedStack
ResourceIdentifier:
StackId: >-
arn:aws:cloudformation:us-west-2:12345678910:stack/mystack/5b918d10-cd98-11ea-90d5-0a9cd3354c10
```
1. Per creare un set di modifiche, utilizza il seguente comando **create-change-set** e sostituisci il testo segnaposto. Per l’opzione `--change-set-type`, specifica il valore di **IMPORT**. Per l’opzione `--resources-to-import`, sostituisci la stringa JSON di esempio con la stringa JSON effettiva che hai appena creato.
```
aws cloudformation create-change-set \
--stack-name MyParentStack --change-set-name ImportChangeSet \
--change-set-type IMPORT \
--template-body file://TemplateToImport.json \
--resources-to-import '[{"ResourceType":"AWS::CloudFormation::Stack","LogicalResourceId":"MyNestedStack","ResourceIdentifier":{"StackId":"arn:aws:cloudformation:us-west-2:12345678910:stack/mystack/5b918d10-cd98-11ea-90d5-0a9cd3354c10"}}]'
```
**Nota**
`--resources-to-import` non supporta YAML in linea. I requisiti per l’escape delle virgolette nella stringa JSON variano in base al terminale. Per ulteriori informazioni, consulta [Utilizzo di virgolette all’interno di stringhe](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html#cli-usage-parameters-quoting-strings-containing) nella *Guida per l’utente di AWS Command Line Interface *.
In alternativa, puoi anche utilizzare l’URL del file come input per l’opzione `--resources-to-import`, come mostrato nell’esempio seguente.
```
--resources-to-import file://ResourcesToImport.txt
```
Se eseguito correttamente, il comando restituirà il seguente output di esempio.
```
{
"Id": "arn:aws:cloudformation:us-west-2:12345678910:changeSet/ImportChangeSet/8ad75b3f-665f-46f6-a200-0b4727a9442e",
"StackId": "arn:aws:cloudformation:us-west-2:12345678910:stack/MyParentStack/4e345b70-1281-11ef-b027-027366d8e82b"
}
```
1. Esaminare il set di modifiche per assicurarsi che venga importato lo stack corretto.
```
aws cloudformation describe-change-set --change-set-name ImportChangeSet
```
1. Per avviare il set di modifiche e importare lo stack nello stack padre di origine, utilizza il seguente comando **execute-change-set** e sostituisci il testo segnaposto. Tutti i [tag a livello di stack](cfn-console-create-stack.md#configure-stack-options) vengono applicati alle risorse importate in questo momento. Al completamento dell’operazione di importazione `(IMPORT_COMPLETE)`, lo stack viene nidificato correttamente.
```
aws cloudformation execute-change-set --change-set-name ImportChangeSet
```
**Nota**
Non è necessario eseguire il rilevamento della deviazione nello stack padre dopo questa operazione di importazione perché la risorsa `AWS::CloudFormation::Stack` è già gestita da CloudFormation.
# Importa AWS automaticamente le risorse in uno CloudFormation stack
Ora puoi importare automaticamente *risorse denominate* durante la creazione o l'aggiornamento degli stack. CloudFormation Una *risorsa denominata* è una risorsa con un nome personalizzato. Per ulteriori informazioni, consulta [Name type](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-name.html) nel *CloudFormation Template Reference.*
Quando avvii l'importazione automatica, CloudFormation verifica le risorse esistenti che corrispondono al modello e le importa durante la distribuzione. Per gli stack nidificati, crea il set di modifiche dallo stack radice.
Al termine dell’importazione e prima di eseguire operazioni di stack successive, ti consigliamo di eseguire il rilevamento della deviazione sulle risorse importate. Il rilevamento della deviazione garantisce che la configurazione del modello corrisponda alla configurazione effettiva. Per ulteriori informazioni, consulta [Rileva la deriva su un'intera CloudFormation pila](detect-drift-stack.md).
Per importare una risorsa, è necessario rispettare i seguenti requisiti:
+ La risorsa deve avere un nome statico personalizzato definito nel modello. I nomi dinamici (usando \$1Ref o altre funzioni) non sono attualmente supportati.
+ La risorsa deve avere una `DeletionPolicy` di `Retain` o `RetainExceptOnCreate`.
+ La risorsa non deve già appartenere a un altro CloudFormation stack.
+ Il tipo di risorsa deve supportare le operazioni di CloudFormation importazione. Per ulteriori informazioni, consulta [Supporto del tipo di risorse](resource-import-supported-resources.md).
+ L’ID principale per il tipo di risorsa deve essere nel modello. Le proprietà primarie IDs con sola lettura non sono supportate. Per scoprire qual è l’ID primario di un tipo, cerca la proprietà `primaryIdentifier` nello schema delle risorse. Per ulteriori informazioni sulla proprietà, consulta [primaryIdentifier](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-primaryidentifier).
**Example Esempio di importazione automatica**
L’esempio seguente utilizza un set di modifiche `CreateChangeSet` per creare uno stack chiamato `my-stack` basato su un file modello, `template.yaml`, e importa automaticamente le risorse corrispondenti.
```
aws cloudformation create-change-set \
--stack-name my-stack \
--change-set-name CreateChangeSet \
--change-set-type CREATE \
--template-body file://template.yaml \
--import-existing-resources
```
## Risoluzione dei problemi
Se l’importazione automatica non va a buon fine, procedi come segue per risolvere il problema:
+ Verifica che il nome della risorsa nel modello corrisponda esattamente al nome della risorsa
+ Verifica che la risorsa non sia già gestita da un altro stack
+ Assicurati che il tipo di risorsa supporti le operazioni di importazione
+ Verifica che il modello includa tutte le proprietà richieste per il tipo di risorsa
# Ripristino di un'operazione di importazione
Per ripristinare un'operazione di importazione, specificare una policy di eliminazione `Retain` per la risorsa che si desidera rimuovere dal modello per assicurarsi che venga mantenuta quando viene eliminata dallo stack.
## Annullare un'operazione di importazione utilizzando Console di gestione AWS
1. Specificate a `Retain` [DeletionPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-attribute-deletionpolicy.html)per le risorse che desiderate rimuovere dal vostro stack. Nel modello di esempio seguente, `GamesTable` è la destinazione di questa operazione di inversione.
**Example JSON**
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Description": "Import test",
"Resources": {
"ServiceTable":{
"Type":"AWS::DynamoDB::Table",
"Properties":{
"TableName":"Service",
"AttributeDefinitions":[
{
"AttributeName":"key",
"AttributeType":"S"
}
],
"KeySchema":[
{
"AttributeName":"key",
"KeyType":"HASH"
}
],
"ProvisionedThroughput":{
"ReadCapacityUnits":5,
"WriteCapacityUnits":1
}
}
},
"GamesTable": {
"Type": "AWS::DynamoDB::Table",
"DeletionPolicy": "Retain",
"Properties": {
"TableName": "Games",
"AttributeDefinitions": [
{
"AttributeName": "key",
"AttributeType": "S"
}
],
"KeySchema": [
{
"AttributeName": "key",
"KeyType": "HASH"
}
],
"ProvisionedThroughput": {
"ReadCapacityUnits": 5,
"WriteCapacityUnits": 1
}
}
}
}
}
```
1. Apri la CloudFormation console per eseguire un aggiornamento dello stack per applicare la politica di eliminazione.
1. Nella pagina **Stacks (Stack)** con lo stack selezionato, scegliere **Update (Aggiorna)**, quindi scegliere **Update stack (Aggiorna stack) (standard)**.
1. In **Prepara modello**, scegliere **Sostituisci modello corrente**.
1. In **Specifica modello**, fornire il modello di origine aggiornato con l’attributo `DeletionPolicy` su `GamesTable`, quindi scegliere **Successivo**.
+ Scegliere **URL Amazon S3**, quindi specificare l’URL per il modello di origine aggiornato nella casella di testo.
+ Scegliere **Carica un file modello**, quindi cercare il file modello di origine aggiornato.
1. Nella pagina **Specifica dettagli stack**, non sono necessarie modifiche. Scegli **Successivo**.
1. Nella pagina **Configura opzioni stack** non sono necessarie modifiche. Scegli **Next (Successivo)**.
1. Nella *MyStack* pagina **Revisione**, rivedi le modifiche. Se il modello contiene risorse IAM, selezionare**Acconsento che questo modello possa creare risorse IAM** per specificare che si desidera utilizzare risorse IAM nel modello. Per ulteriori informazioni, consulta [Riconoscimento delle risorse IAM nei modelli CloudFormation](control-access-with-iam.md#using-iam-capabilities). Quindi, aggiornare lo stack di origine creando un set di modifiche o aggiornare direttamente lo stack di origine.
1. Rimuovere la risorsa, i parametri correlati e gli output dal modello dello stack. In questo esempio, il modello ora è simile al seguente.
**Example JSON**
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Description": "Import test",
"Resources": {
"ServiceTable":{
"Type":"AWS::DynamoDB::Table",
"Properties":{
"TableName":"Service",
"AttributeDefinitions":[
{
"AttributeName":"key",
"AttributeType":"S"
}
],
"KeySchema":[
{
"AttributeName":"key",
"KeyType":"HASH"
}
],
"ProvisionedThroughput":{
"ReadCapacityUnits":5,
"WriteCapacityUnits":1
}
}
}
}
}
```
1. Ripetere il passaggio 2 per eliminare la risorsa (`GamesTable`) e i relativi parametri e output dallo stack.
## Annullare un'operazione di importazione utilizzando il AWS CLI
1. Specificate a `Retain` [DeletionPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-attribute-deletionpolicy.html)per le risorse che desiderate rimuovere dal vostro stack. Nel modello di esempio seguente, `GamesTable` è la destinazione di questa operazione di inversione.
**Example JSON**
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Description": "Import test",
"Resources": {
"ServiceTable":{
"Type":"AWS::DynamoDB::Table",
"Properties":{
"TableName":"Service",
"AttributeDefinitions":[
{
"AttributeName":"key",
"AttributeType":"S"
}
],
"KeySchema":[
{
"AttributeName":"key",
"KeyType":"HASH"
}
],
"ProvisionedThroughput":{
"ReadCapacityUnits":5,
"WriteCapacityUnits":1
}
}
},
"GamesTable": {
"Type": "AWS::DynamoDB::Table",
"DeletionPolicy": "Retain",
"Properties": {
"TableName": "Games",
"AttributeDefinitions": [
{
"AttributeName": "key",
"AttributeType": "S"
}
],
"KeySchema": [
{
"AttributeName": "key",
"KeyType": "HASH"
}
],
"ProvisionedThroughput": {
"ReadCapacityUnits": 5,
"WriteCapacityUnits": 1
}
}
}
}
}
```
1. Aggiornare lo stack per applicare la policy di eliminazione alla risorsa.
```
aws cloudformation update-stack --stack-name MyStack
```
1. Rimuovere la risorsa, i parametri correlati e gli output dal modello dello stack. In questo esempio, il modello ora è simile al seguente.
**Example JSON**
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Description": "Import test",
"Resources": {
"ServiceTable":{
"Type":"AWS::DynamoDB::Table",
"Properties":{
"TableName":"Service",
"AttributeDefinitions":[
{
"AttributeName":"key",
"AttributeType":"S"
}
],
"KeySchema":[
{
"AttributeName":"key",
"KeyType":"HASH"
}
],
"ProvisionedThroughput":{
"ReadCapacityUnits":5,
"WriteCapacityUnits":1
}
}
}
}
}
```
1. Aggiornare lo stack per eliminare la risorsa (`GamesTable`) e i relativi parametri e output dallo stack.
```
aws cloudformation update-stack --stack-name MyStack
```