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 orphan`
<a name="ref-cli-cmd-orphan"></a>

**Importante**  
Il `cdk orphan` comando è in versione di anteprima ed è soggetto a modifiche.  
È necessario fornire l'`--unstable=orphan`opzione quando si utilizza questo comando.

Scollega in modo sicuro una o più risorse da una AWS CloudFormation pila senza eliminarle. Ciò è utile quando è necessario migrare una risorsa da un tipo di costrutto a un altro (ad esempio, migrando un DynamoDB a) senza tempi di inattività o perdita `Table` di `TableV2` dati.

Quando modificate un tipo di costrutto nel codice CDK, lo CloudFormation interpreta come una risorsa sostitutiva, che elimina la risorsa esistente e ne crea una nuova. Per le risorse statiche come database e storage, ciò causa la perdita di dati. Il `cdk orphan` comando risolve questo problema scollegando prima la risorsa dallo stack, in modo da poterla reimportare con il nuovo tipo di costrutto utilizzando. `cdk import`

Con il `cdk orphan` puoi:
+ Scollega le risorse stateful da una pila prima di modificarne il tipo di costrutto.
+ Esegui la migrazione tra le versioni di build (ad esempio, DynamoDB to) senza perdita di dati`Table`. `TableV2`
+ Cambia il tipo di CloudFormation risorsa su cui si basa un costrutto senza sostituire la risorsa fisica.

Il comando orphan esegue tre distribuzioni: CloudFormation 

1.  Risolvi **riferimenti: risolve** i riferimenti tra risorse (`Ref`,,`Fn::Sub`) alle risorse orfane`Fn::GetAtt`, in modo che le altre risorse dello stack che dipendono da esse continuino a funzionare dopo la rimozione delle risorse orfane.

1.  **Disaccoppia**: sostituisce tutti i riferimenti tra risorse con i relativi valori letterali risolti, imposta e rimuove le `DependsOn` voci `DeletionPolicy` per isolare le `Retain` risorse dal resto dello stack.

1.  **Rimuovi: rimuove** le risorse dal modello. CloudFormation Le risorse fisiche continuano a esistere nel tuo AWS account.

Dopo l'orfano, aggiorna il codice CDK per utilizzare il nuovo tipo di costrutto e usa [cdk import](ref-cli-cmd-import.md) per riportare la risorsa in gestione.

 **Per rendere orfana una risorsa e reimportarla con un nuovo tipo di costrutto**   

1. Distribuisci il tuo stack e verifica l'esistenza della risorsa.

1. Esegui `cdk orphan` con il percorso di costruzione della risorsa:

   ```
   $ cdk orphan MyStack/MyTable --unstable=orphan
   ```

1. Il comando genera una mappatura delle risorse. Salvalo per la fase di importazione.

1. Aggiorna il codice CDK per utilizzare il nuovo tipo di costrutto (ad esempio, cambia `Table` in`TableV2`).

1. Esegui `cdk import` con la mappatura delle risorse dall'output orfano:

   ```
   $ cdk import MyStack --resource-mapping-inline '{"MyTable":{"TableName":"my-table"}}'
   ```

1. Una volta completata l'importazione, `cdk import` rileva la deriva e richiede all'utente di eseguire la distribuzione. Accettate la richiesta di riconciliare lo stack.

Questa funzionalità presenta attualmente le seguenti limitazioni:
+ Tutti i percorsi di costruzione devono fare riferimento allo stesso stack. La creazione di risorse orfane su più stack in un unico comando non è supportata.
+ I pattern wildcard non sono supportati. I percorsi vengono abbinati come prefissi esatti.
+ Questo comando richiede la versione 32 del modello bootstrap, che include le autorizzazioni IAM necessarie per il ruolo di distribuzione.

## Utilizzo
<a name="ref-cli-cmd-orphan-usage"></a>

```
$ cdk orphan <PATHS> <options>
```

## Arguments (Argomenti)
<a name="ref-cli-cmd-orphan-args"></a><a name="ref-cli-cmd-orphan-args-paths"></a>

 **PERCORSI**   
Uno o più percorsi di costruzione verso l'orfano, nel formato. `StackName/ConstructPath` Ad esempio, `MyStack/MyTable`. È possibile fornire più percorsi per rendere orfane diverse risorse in un unico comando.  
Tutti i percorsi devono fare riferimento allo stesso stack.  
 ▬*Tipo:* stringa  
 *Obbligatorio:* sì

## Opzioni
<a name="ref-cli-cmd-orphan-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.<a name="ref-cli-cmd-orphan-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostra le informazioni di riferimento relative al `cdk orphan` comando.

## Esempi
<a name="ref-cli-cmd-orphan-examples"></a>

### Orfana: una sola risorsa
<a name="ref-cli-cmd-orphan-examples-single"></a>

```
$ cdk orphan MyStack/MyTable --unstable=orphan
```

### Risorse multiple orfane
<a name="ref-cli-cmd-orphan-examples-multiple"></a>

```
$ cdk orphan MyStack/MyTable MyStack/MyBucket --unstable=orphan
```

### Salta la richiesta di conferma
<a name="ref-cli-cmd-orphan-examples-yes"></a>

```
$ cdk orphan MyStack/MyTable --unstable=orphan --yes
```