

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

# Guida introduttiva all'IPAM utilizzando AWS CLI

Questo tutorial ti guida attraverso il processo di configurazione e utilizzo di Amazon VPC IP Address Manager (IPAM) con la AWS CLI utilizzando un singolo account. AWS Al termine di questo tutorial, avrai creato un IPAM, creato una gerarchia di pool di indirizzi IP e assegnato un CIDR a un VPC.

## Prerequisiti
<a name="prerequisites"></a>

Prima di iniziare questo tutorial, assicurati di disporre dei seguenti elementi:
+ Un AWS account con autorizzazioni per creare e gestire risorse IPAM.
+ La AWS CLI è stata installata e configurata con le credenziali appropriate. Per informazioni sull'installazione della AWS CLI, vedere [ Installazione o aggiornamento della versione più recente della CLI. AWS](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) Per informazioni sulla configurazione della AWS CLI, vedere Nozioni di base sulla configurazione. [https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html) 
+ Conoscenza di base dell’assegnazione di indirizzi IP e della notazione CIDR.
+ Conoscenza di base dei concetti relativi ad Amazon VPC.
+ Per terminare il tutorial saranno necessari circa 30 minuti.

## Crea un IPAM
<a name="create-an-ipam"></a>

La prima cosa da fare è creare un IPAM con regioni operative. Un IPAM consente di pianificare, tracciare e monitorare gli indirizzi IP per i carichi di lavoro. AWS 

Crea un IPAM con regioni operative in us-east-1 e us-west-2:

```json
aws ec2 create-ipam \
  --description "My IPAM" \
  --operating-regions RegionName=us-east-1 RegionName=us-west-2
```

Questo comando crea un IPAM e gli consente di gestire gli indirizzi IP nelle regioni indicate. Le regioni operative sono le AWS regioni in cui l'IPAM è autorizzato a gestire i CIDR degli indirizzi IP.

Verifica che il tuo IPAM sia stato creato:

```
aws ec2 describe-ipams
```

Annota l’ID IPAM ricevuto in base all’output, perché avrai bisogno di utilizzarlo in seguito.

Attendi che venga completata la creazione dell’IPAM e che questo sia disponibile (circa 20 secondi):

```
sleep 20
```

## Ottieni l’ID dell’ambito IPAM
<a name="get-the-ipam-scope-id"></a>

Quando si crea un IPAM, crea AWS automaticamente un ambito privato e uno pubblico. Per questo tutorial verrà illustrato l’utilizzo dell’ambito privato.

Recupera i dettagli DELL’IPAM ed estrai l’ID dell’ambito privato:

```
aws ec2 describe-ipams --ipam-id ipam-0abcd1234
```

Sostituisci `ipam-0abcd1234` con l’ID effettivo dell’IPAM.

In base all’output, identifica e annota l’ID dell’ambito privato disponibile nel campo `PrivateDefaultScopeId`. L'aspetto sarà simile a `ipam-scope-0abcd1234`.

## Come creare un pool di livello superiore IPv4
<a name="create-a-top-level-ipv4-pool"></a>

Adesso creermo un pool di livello superiore nell’ambito privato. Questo pool sarà quello principale per tutti gli altri pool della gerarchia.

Come creare un pool di livello superiore IPv4:

```
aws ec2 create-ipam-pool \
  --ipam-scope-id ipam-scope-0abcd1234 \
  --address-family ipv4 \
  --description "Top-level pool"
```

Sostituisci `ipam-scope-0abcd1234` con l’ID effettivo dell’ambito privato.

Attendi che venga completata la creazione del pool e che questo sia disponibile:

```
aws ec2 describe-ipam-pools --ipam-pool-ids ipam-pool-0abcd1234 --query 'IpamPools[0].State' --output text
```

Sostituisci `ipam-pool-0abcd1234` con l’ID effettivo del pool di livello superiore. Prima di procedere, lo stato deve essere `create-complete`.

Quando il pool è disponibile, effettua il provisioning di un intervallo CIDR:

```
aws ec2 provision-ipam-pool-cidr \
  --ipam-pool-id ipam-pool-0abcd1234 \
  --cidr 10.0.0.0/8
```

Attendi che venga completato il provisioning del CIDR:

```
aws ec2 get-ipam-pool-cidrs --ipam-pool-id ipam-pool-0abcd1234 --query "IpamPoolCidrs[?Cidr=='10.0.0.0/8'].State" --output text
```

Prima di procedere, lo stato deve essere `provisioned`.

## Crea un pool IPv4 regionale
<a name="create-a-regional-ipv4-pool"></a>

A questo punto, crea un pool regionale all’interno del pool di livello superiore. Questo pool sarà specifico per una particolare AWS regione.

Come creare un pool IPv4 regionale:

```
aws ec2 create-ipam-pool \
  --ipam-scope-id ipam-scope-0abcd1234 \
  --source-ipam-pool-id ipam-pool-0abcd1234 \
  --locale us-east-1 \
  --address-family ipv4 \
  --description "Regional pool in us-east-1"
```

Sostituisci `ipam-scope-0abcd1234` con l’ID effettivo dell’ambito privato e `ipam-pool-0abcd1234` con l’ID del pool di livello superiore.

Attendi che venga completata la creazione del pool regionale e che questo sia disponibile:

```
aws ec2 describe-ipam-pools --ipam-pool-ids ipam-pool-1abcd1234 --query 'IpamPools[0].State' --output text
```

Sostituisci `ipam-pool-1abcd1234` con l’ID effettivo del pool regionale. Prima di procedere, lo stato deve essere `create-complete`.

Quando il pool è disponibile, effettua il provisioning di un intervallo CIDR:

```
aws ec2 provision-ipam-pool-cidr \
  --ipam-pool-id ipam-pool-1abcd1234 \
  --cidr 10.0.0.0/16
```

Attendi che venga completato il provisioning del CIDR:

```
aws ec2 get-ipam-pool-cidrs --ipam-pool-id ipam-pool-1abcd1234 --query "IpamPoolCidrs[?Cidr=='10.0.0.0/16'].State" --output text
```

Prima di procedere, lo stato deve essere `provisioned`.

## Come creare un pool IPv4 di sviluppo
<a name="create-a-development-ipv4-pool"></a>

A questo punto, crea un pool di sviluppo all’interno di un pool regionale. Questo pool verrà utilizzato per ambienti di sviluppo.

Come creare un pool IPv4 di sviluppo:

```
aws ec2 create-ipam-pool \
  --ipam-scope-id ipam-scope-0abcd1234 \
  --source-ipam-pool-id ipam-pool-1abcd1234 \
  --locale us-east-1 \
  --address-family ipv4 \
  --description "Development pool"
```

Sostituisci `ipam-scope-0abcd1234` con l’ID effettivo dell’ambito privato e `ipam-pool-1abcd1234` con l’ID del pool regionale.

Attenzione: ricordati di includere il parametro `--locale` in linea con le impostazioni locali del pool principale.

Attendi che venga completata la creazione del pool di sviluppo e che questo sia disponibile:

```
aws ec2 describe-ipam-pools --ipam-pool-ids ipam-pool-2abcd1234 --query 'IpamPools[0].State' --output text
```

Sostituisci `ipam-pool-2abcd1234` con l’ID effettivo del pool di sviluppo. Prima di procedere, lo stato deve essere `create-complete`.

Quando il pool è disponibile, effettua il provisioning di un intervallo CIDR:

```
aws ec2 provision-ipam-pool-cidr \
  --ipam-pool-id ipam-pool-2abcd1234 \
  --cidr 10.0.0.0/24
```

Attendi che venga completato il provisioning del CIDR:

```
aws ec2 get-ipam-pool-cidrs --ipam-pool-id ipam-pool-2abcd1234 --query "IpamPoolCidrs[?Cidr=='10.0.0.0/24'].State" --output text
```

Prima di procedere, lo stato deve essere `provisioned`.

## Come creare un VPC che utilizza un CIDR del pool IPAM
<a name="create-a-vpc-using-an-ipam-pool-cidr"></a>

Infine, crea un VPC che utilizza un CIDR del pool IPAM. Ciò dimostra come l'IPAM può essere utilizzato per allocare lo spazio degli indirizzi IP alle risorse. AWS 

Come creare un VPC che utilizza un CIDR del pool IPAM

```
aws ec2 create-vpc \
  --ipv4-ipam-pool-id ipam-pool-2abcd1234 \
  --ipv4-netmask-length 26 \
  --tag-specifications 'ResourceType=vpc,Tags=[{Key=Name,Value=IPAM-VPC}]'
```

Sostituisci `ipam-pool-2abcd1234` con l’ID effettivo del pool di sviluppo.

Il parametro `--ipv4-netmask-length 26` indica che è necessario assegnare un intervallo CIDR /26 (64 indirizzi IP) dal pool. Questa lunghezza della netmask viene scelta per fare in modo che sia inferiore all’intervallo CIDR del pool (/24).

Verifica che il VPC sia stato creato:

```
aws ec2 describe-vpcs --filters "Name=tag:Name,Values=IPAM-VPC"
```

## Verifica l’assegnazione del pool IPAM
<a name="verify-the-ipam-pool-allocation"></a>

Verifica che il CIDR sia stato assegnato dal pool IPAM:

```
aws ec2 get-ipam-pool-allocations \
  --ipam-pool-id ipam-pool-2abcd1234
```

Sostituisci `ipam-pool-2abcd1234` con l’ID effettivo del pool di sviluppo.

Questo comando mostra tutte le assegnazioni dal pool IPAM indicato, incluso il VPC appena creato.

## Risoluzione dei problemi
<a name="troubleshooting"></a>

Di seguito sono indicati alcuni problemi comuni che possono verificarsi durante l’utilizzo di IPAM:
+ **Errori di autorizzazione**: verifica che l’utente o il ruolo IAM disponga delle autorizzazioni necessarie per creare e gestire le risorse IPAM. Potrebbero essere necessari `ec2:CreateIpam`, `ec2:CreateIpamPool` e altre autorizzazioni correlate.
+ **Limite di risorse superato**: è possibile creare un solo IPAM per regione. AWS Se hai già un IPAM, dovrai eliminarlo prima di crearne uno nuovo o utilizzare quello già esistente.
+ **Errori di assegnazione CIDR**: quando effettui il provisioning dei CIDR nei pool, verifica che il CIDR interessato non si sovrapponga con le assegnazioni esistenti in altri pool.
+ **Timeout delle richieste API**: se si verificano errori "RequestExpired", ciò potrebbe essere dovuto alla latenza di rete o a problemi di sincronizzazione dell'ora. Prova a eseguire nuovamente il comando.
+ **Errori di stato errati**: se ricevi errori IncorrectState "", potrebbe essere perché stai cercando di eseguire un'operazione su una risorsa che non è nello stato corretto. Attendi che vengano completati la creazione o il provisioning della risorsa prima di procedere.
+ **Errori relativi alle dimensioni dell'allocazione**: se ricevi errori InvalidParameterValue "" sulla dimensione dell'allocazione, assicurati che la lunghezza della maschera di rete richiesta sia appropriata per le dimensioni del pool. Ad esempio, non è possibile assegnare un CIDR /25 da un pool /24.
+ **Violazioni delle dipendenze**: durante la pulizia delle risorse, potresti riscontrare errori "». DependencyViolation Questa circostanza è dovuta al fatto che le risorse dipendono l’una dall’altra. Assicurati di eliminare le risorse nell’ordine inverso rispetto a quello di creazione e di revoca dei CIDR prima di eliminare i pool.

## Eseguire la pulizia delle risorse
<a name="clean-up-resources"></a>

Dopo aver completato questo tutorial, dovresti eliminare le risorse create per evitare addebiti superflui.

1. Eliminare il VPC

   ```
   aws ec2 delete-vpc --vpc-id vpc-0abcd1234
   ```

1. Revoca il CIDR del pool di sviluppo:

   ```
   aws ec2 deprovision-ipam-pool-cidr --ipam-pool-id ipam-pool-2abcd1234 --cidr 10.0.0.0/24
   ```

1. Elimina il pool di sviluppo:

   ```
   aws ec2 delete-ipam-pool --ipam-pool-id ipam-pool-2abcd1234
   ```

1. Revoca il CIDR del pool regionale:

   ```
   aws ec2 deprovision-ipam-pool-cidr --ipam-pool-id ipam-pool-1abcd1234 --cidr 10.0.0.0/16
   ```

1. Elimina il pool regionale:

   ```
   aws ec2 delete-ipam-pool --ipam-pool-id ipam-pool-1abcd1234
   ```

1. Revoca il CIDR del pool di livello superiore.

   ```
   aws ec2 deprovision-ipam-pool-cidr --ipam-pool-id ipam-pool-0abcd1234 --cidr 10.0.0.0/8
   ```

1. Elimina il pool di livello superiore:

   ```
   aws ec2 delete-ipam-pool --ipam-pool-id ipam-pool-0abcd1234
   ```

1. Elimina l’IPAM:

   ```
   aws ec2 delete-ipam --ipam-id ipam-0abcd1234
   ```

Sostituisci tutti gli ID con gli ID effettivi delle risorse.

**Nota**  
Potrebbe essere necessario attendere tra un’operazione e l’altra per consentire l’eliminazione completa delle risorse prima di passare alla fase successiva. Se riscontri violazioni delle dipendenze, attendi qualche secondo e riprova.

## Fasi successive
<a name="next-steps"></a>

Ora che hai imparato a creare e utilizzare IPAM con la AWS CLI, potresti voler esplorare funzionalità più avanzate:
+ [Pianificare il provisioning degli indirizzi IP](planning-ipam.md) – Scopri come pianificare in modo efficace lo spazio degli indirizzi IP
+ [Monitoraggio dell'utilizzo del CIDR per risorsa](monitor-cidr-compliance-ipam.md) – Scopri come monitorare l’utilizzo degli indirizzi IP
+ [Condividi un pool IPAM utilizzando AWS RAM](share-pool-ipam.md)— Scopri come condividere i pool IPAM tra gli account AWS 
+ [Integra IPAM con gli account in un AWS Organizzazione](enable-integ-ipam.md) – Scopri come utilizzare IPAM nella tua organizzazione