Questa è la AWS CDK v2 Developer Guide. Il vecchio CDK v1 è entrato in manutenzione il 1° giugno 2022 e ha terminato il supporto il 1° giugno 2023.

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

# `cdk migrate`
<a name="ref-cli-cdk-migrate"></a>

Migra AWS le risorse, gli AWS CloudFormation stack e i CloudFormation modelli distribuiti in un nuovo progetto CDK. AWS 

Questo comando crea una nuova app CDK che include un singolo stack denominato con il valore fornito utilizzando. `--stack-name` È possibile configurare l'origine della migrazione utilizzando `--from-scan``--from-stack`, o. `--from-path`

Per ulteriori informazioni sull'utilizzo`cdk migrate`, consulta [Migrare risorse e AWS CloudFormation modelli esistenti al AWS CDK](migrate.md).

**Nota**  
Il `cdk migrate` comando è sperimentale e potrebbe subire modifiche sostanziali in futuro.

## Utilizzo
<a name="ref-cli-cdk-migrate-usage"></a>

```
$ cdk migrate <options>
```

## Opzioni
<a name="ref-cli-cdk-migrate-options"></a>

Per un elenco di opzioni globali che funzionano con tutti i comandi CDK CLI, [vedete](ref-cli-cmd.md#ref-cli-cmd-options) Opzioni globali.

### Opzioni richieste
<a name="ref-cli-cdk-migrate-options-required"></a><a name="ref-cli-cdk-migrate-options-stack-name"></a>

 `--stack-name <STRING>`   
Il nome dello AWS CloudFormation stack che verrà creato all'interno dell'app CDK dopo la migrazione.  
 *Campo obbligatorio*: sì

### Opzioni condizionali
<a name="ref-cli-cdk-migrate-options-conditional"></a><a name="ref-cli-cdk-migrate-options-from-path"></a>

 `--from-path <PATH>`   
Il percorso del AWS CloudFormation modello da migrare. Fornisci questa opzione per specificare un modello locale.  
 *Obbligatorio:* condizionale. Obbligatorio in caso di migrazione da un AWS CloudFormation modello locale.<a name="ref-cli-cdk-migrate-options-from-scan"></a>

 `--from-scan <STRING>`   
Durante la migrazione delle risorse distribuite da un AWS ambiente, utilizzate questa opzione per specificare se avviare una nuova scansione o se la CLI AWS CDK deve utilizzare l'ultima scansione riuscita.  
 *Obbligatorio:* condizionale. Richiesto per la migrazione dalle risorse distribuite. AWS   
 *Valori accettati*:, `most-recent` `new` <a name="ref-cli-cdk-migrate-options-from-stack"></a>

 `--from-stack <BOOLEAN>`   
Fornisci questa opzione per migrare da uno stack distribuito AWS CloudFormation . Utilizzare `--stack-name` per specificare il nome dello stack distribuito. AWS CloudFormation   
 *Obbligatorio:* condizionale. Obbligatorio in caso di migrazione da uno stack distribuito. AWS CloudFormation 

### Opzioni opzionali
<a name="ref-cli-cdk-migrate-options-optional"></a><a name="ref-cli-cdk-migrate-options-account"></a>

 `--account <STRING>`   
L'account da cui recuperare il modello dello AWS CloudFormation stack.  
 *Required*: No  
 *Predefinito*: la CLI AWS CDK ottiene le informazioni sull'account da fonti predefinite.<a name="ref-cli-cdk-migrate-options-compress"></a>

 `--compress <BOOLEAN>`   
Fornite questa opzione per comprimere il progetto CDK generato in un file. `ZIP`  
 *Required*: No<a name="ref-cli-cdk-migrate-options-filter"></a>

 `--filter <ARRAY>`   
Da utilizzare per la migrazione delle risorse distribuite da un account e da una AWS regione. AWS Questa opzione specifica un filtro per determinare quali risorse distribuite migrare.  
Questa opzione accetta una matrice di coppie chiave-valore, dove **key** rappresenta il tipo di filtro e **value rappresenta il valore** da filtrare.  
Sono accettate le seguenti chiavi:  
+  `resource-identifier`— Un identificatore per la risorsa. Il valore può essere l'ID logico o fisico della risorsa. Ad esempio, `resource-identifier="ClusterName"`.
+  `resource-type-prefix`— Il prefisso del tipo di AWS CloudFormation risorsa. Ad esempio, specifica di `resource-type-prefix="AWS::DynamoDB::"` filtrare tutte le risorse Amazon DynamoDB.
+  `tag-key`— La chiave di un tag di risorsa. Ad esempio, `tag-key="myTagKey"`.
+  `tag-value`— Il valore di un tag di risorsa. Ad esempio, `tag-value="myTagValue"`.
Fornisci più coppie chiave-valore per la logica `AND` condizionale. L'esempio seguente filtra per qualsiasi risorsa DynamoDB `myTagKey` etichettata come chiave tag:. `--filter resource-type-prefix="AWS::DynamoDB::", tag-key="myTagKey"`  
Fornisci l'`--filter`opzione più volte in un unico comando per la logica `OR` condizionale. L'esempio seguente filtra per qualsiasi risorsa che sia una risorsa DynamoDB o contrassegnata come chiave tag`myTagKey`:. `--filter resource-type-prefix="AWS::DynamoDB::" --filter tag-key="myTagKey"`  
 *Required*: No<a name="ref-cli-cdk-migrate-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostra le informazioni di riferimento del `cdk migrate` comando.<a name="ref-cli-cdk-migrate-options-language"></a>

 `--language <STRING>`   
Il linguaggio di programmazione da utilizzare per il progetto CDK creato durante la migrazione.  
 *Required*: No  
 *Valori validi*:`typescript`,`python`,, `java``csharp`,`go`.  
 *Default*: `typescript` <a name="ref-cli-cdk-migrate-options-output-path"></a>

 `--output-path <PATH>`   
Il percorso di output per il progetto CDK migrato.  
 *Required*: No  
 *Impostazione predefinita*: per impostazione predefinita, la CLI AWS CDK utilizzerà la directory di lavoro corrente.<a name="ref-cli-cdk-migrate-options-region"></a>

 `--region <STRING>`   
La AWS regione da cui recuperare il modello dello AWS CloudFormation stack.  
 *Required*: No  
 *Predefinito*: la CLI AWS CDK AWS ottiene informazioni sulla regione da fonti predefinite.

## Esempi
<a name="ref-cli-cdk-migrate-examples"></a>

### Semplice esempio di migrazione da uno stack CloudFormation
<a name="ref-cli-cdk-migrate-examples-1"></a>

Esegui la migrazione da uno CloudFormation stack distribuito in un ambiente specifico utilizzando. AWS `--from-stack` Fornisci un nome `--stack-name` al tuo nuovo stack CDK. Di seguito è riportato un esempio di migrazione `myCloudFormationStack` a una nuova app CDK che utilizza: TypeScript

```
$ cdk migrate --language typescript --from-stack --stack-name 'myCloudFormationStack'
```

### Semplice esempio di migrazione da un modello locale CloudFormation
<a name="ref-cli-cdk-migrate-examples-2"></a>

Esegui la migrazione da un modello JSON o CloudFormation YAML locale utilizzando. `--from-path` Fornisci un nome `--stack-name` al tuo nuovo stack CDK. Di seguito è riportato un esempio che crea una nuova app CDK TypeScript che include uno `myCloudFormationStack` stack da un file locale: `template.json`

```
$ cdk migrate --stack-name "myCloudFormationStack" --language typescript --from-path "./template.json"
```

### Semplice esempio di migrazione dalle risorse distribuite AWS
<a name="ref-cli-cdk-migrate-examples-3"></a>

Migra AWS le risorse distribuite da un AWS ambiente specifico che non sono associate a uno stack che utilizza. CloudFormation `--from-scan` La CLI CDK utilizza il IaC generator servizio per cercare risorse e generare un modello. Quindi, la CLI CDK fa riferimento al modello per creare la nuova app CDK. Di seguito è riportato un esempio che crea una nuova app CDK TypeScript con un nuovo `myCloudFormationStack` stack contenente risorse migrate: AWS 

```
$ cdk migrate --language typescript --from-scan --stack-name "myCloudFormationStack"
```