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à. # Gestione dei sottogruppi di sottoreti Amazon DocumentDB Un cloud privato virtuale (VPC) è una rete virtuale dedicata al tuo. Account AWSÈ logicamente isolato dalle altre reti virtuali nel AWS cloud. Puoi avviare AWS le tue risorse, come i cluster Amazon DocumentDB, nel tuo Amazon VPC. Puoi specificare un intervallo di indirizzi IP per il VPC, aggiungere sottoreti, associare gruppi di sicurezza e configurare tabelle di routing. Una sottorete è un intervallo di indirizzi IP nel tuo Amazon VPC. Puoi avviare AWS risorse in una sottorete specificata. Utilizza una sottorete *pubblica* per le risorse che devono essere connesse a Internet. Utilizza una sottorete *privata* per le risorse che non saranno connesse a Internet. Per ulteriori informazioni sulle sottoreti pubbliche e private, consulta [VPC e Subnet Basics](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html#vpc-subnet-basics) nella *Amazon* Virtual Private Cloud User Guide. Un gruppo di sottoreti del database è una raccolta di sottoreti creata in un VPC, che è possibile indicare per i cluster. Un gruppo di sottoreti consente di specificare un determinato VPC quando si creano i cluster. Se usi il gruppo di sottoreti `default`, esso include tutte le sottoreti nel VPC. Ogni gruppo di sottoreti database dovrebbe avere almeno due zone di disponibilità in una data regione . Quando si crea un cluster DB in un VPC, è necessario selezionare un gruppo di sottoreti DB. Amazon DocumentDB utilizza quel gruppo di sottoreti DB e la tua zona di disponibilità preferita per selezionare una sottorete e un indirizzo IP all'interno di quella sottorete da associare al cluster. Se l'istanza primaria fallisce, Amazon DocumentDB può promuovere un'istanza di replica corrispondente come nuova istanza primaria. È possibile creare una nuova istanza di replica usando un indirizzo IP della sottorete in cui si trovava l'istanza primaria precedente. Quando Amazon DocumentDB crea un'istanza in un VPC, assegna un'interfaccia di rete al cluster utilizzando un indirizzo IP selezionato dal gruppo di sottoreti DB. È consigliabile utilizzare il nome DNS, perché l'indirizzo IP sottostante può variare durante il failover. Per ulteriori informazioni, consulta [Endpoint Amazon DocumentDB](how-it-works.md#how-it-works.endpoints). Per informazioni sulla creazione di VPC e sottoreti personalizzati, consulta [Working with VPCs and Subnet nella *Amazon* Virtual Private](https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html) Cloud User Guide. **Topics** + [Creazione di un sottogruppo di Amazon DocumentDB](document-db-subnet-group-create.md) + [Descrizione di un sottogruppo di Amazon DocumentDB](document-db-subnet-group-describe.md) + [Modifica di un gruppo di sottoreti Amazon DocumentDB](document-db-subnet-group-modify.md) + [Eliminazione di un sottogruppo di Amazon DocumentDB](document-db-subnet-group-delete.md) # Creazione di un sottogruppo di Amazon DocumentDB Quando crei un cluster Amazon DocumentDB, devi scegliere un Amazon VPC e il gruppo di sottoreti corrispondente all'interno di quel cluster Amazon VPC per avviare il cluster. Le sottoreti determinano la zona di disponibilità e l'intervallo di IP all'interno della zona di disponibilità che desideri utilizzare per avviare un'istanza. Un gruppo di sottoreti è un insieme denominato di sottoreti (or AZs) che consente di specificare le zone di disponibilità da utilizzare per avviare le istanze di Amazon DocumentDB. Ad esempio, in un cluster con tre istanze, si consiglia di eseguire il provisioning di ciascuna istanza separatamente, in modo da ottimizzare l'elevata disponibilità. AZs Pertanto, se una singola AZ fallisce, avrà effetto solo su una singola istanza. Attualmente, le istanze di Amazon DocumentDB possono essere fornite in un massimo di tre. AZs Anche se un gruppo di sottoreti ha più di tre sottoreti, potrai utilizzarne solo tre per creare un cluster Amazon DocumentDB. Pertanto, quando crei un gruppo di sottoreti, ti consigliamo di scegliere solo le tre sottoreti di cui desideri distribuire le istanze. Ad esempio: viene creato un cluster e Amazon DocumentDB sceglie AZs \$11A, 1B e 1C\$1. Se tenti di creare un'istanza in AZ \$11D\$1 la chiamata API non riuscirà. Tuttavia, se scegli di creare un'istanza, senza specificare la particolare AZ, Amazon DocumentDB sceglierà una AZ per tuo conto. Amazon DocumentDB utilizza un algoritmo per bilanciare il carico delle istanze AZs per aiutarti a raggiungere un'elevata disponibilità. Se viene effettuato il provisioning di tre istanze, per impostazione predefinita, verrà eseguito il provisioning su tre istanze AZs e non verrà eseguito il provisioning tutte in un'unica AZ. Best practice + A meno che non si abbia un motivo specifico, creare sempre un gruppo di sottoreti con tre sottoreti. Ciò garantisce che i cluster con tre o più istanze saranno in grado di raggiungere una maggiore disponibilità man mano che le istanze verranno fornite su tre. AZs + Distribuisci sempre le istanze su più AZs istanze per ottenere un'elevata disponibilità. Non posizionare mai tutte le istanze di un cluster in una singola AZ. + Poiché gli eventi di failover possono verificarsi in qualsiasi momento, non devi presumere che un'istanza primaria o le istanze di replica siano sempre in una determinata AZ. ## Come creare un gruppo di sottoreti Puoi usare Console di gestione AWS o AWS CLI per creare un sottogruppo di Amazon DocumentDB: ------ #### [ Using the Console di gestione AWS ] Utilizza i seguenti passaggi per creare un sottogruppo di Amazon DocumentDB. **Per creare un sottogruppo di Amazon DocumentDB** 1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb) 1. Dal riquadro di navigazione, scegliere **Subnet group (Gruppo di sottoreti)**, quindi scegliere **Create (Crea)**. **Suggerimento** Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina. 1. Dalla pagina **Create subnet group (Crea gruppo di sottorete)**: 1. Nella sezione **Subnet group details (Dettagli del gruppo di sottoreti)**: 1. **Nome**: inserisci un nome significativo per il gruppo di sottoreti. 1. **Descrizione**: immettere una descrizione del gruppo di sottoreti. 1. Nella sezione **Add subnets (Aggiungi sottoreti)**: 1. **VPC**: nell'elenco, scegli un VPC per questo gruppo di sottoreti. 1. Esegui una di queste operazioni: + Per includere tutte le sottoreti nel VPC selezionato, scegliere **Add all the subnets related to this VPC (Aggiungi tutte le sottoreti correlate a questo VPC)**. + Per specificare le sottoreti per questo gruppo di sottoreti, eseguire la procedura seguente per ogni zona di disponibilità in cui si desidera includere le sottoreti. È necessario includere almeno due zone di disponibilità. 1. **Zona di disponibilità**: nell'elenco, scegli una zona di disponibilità. 1. **Subnet**: nell'elenco, scegli una sottorete dalla zona di disponibilità scelta per questo gruppo di sottoreti. 1. Scegliere **Add subnet (Aggiungi sottorete)**. 1. Scegli **Create (Crea) **. Quando viene creato, il gruppo di sottoreti viene elencato con gli altri gruppi di sottoreti. ![\[Screenshot: Mostrare i dettagli di un gruppo di sottoreti.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-subnet-groups-list.png) ------ #### [ Using the AWS CLI ] Prima di poter creare un gruppo di sottoreti utilizzando il AWS CLI, è necessario innanzitutto determinare quali sottoreti sono disponibili. Eseguire la seguente AWS CLI operazione per elencare le zone di disponibilità e le relative sottoreti. **Parametri:** + **--db-subnet-group**—Facoltativo. L'indicazione di un determinato gruppo di sottoreti elencherà le zone di disponibilità e le sottoreti per quel gruppo. L'omissione di questo parametro elencherà zone di disponibilità e le sottoreti per tutti i gruppi di sottoreti. L'indicazione del gruppo di sottoreti `default` elenca tutte le sottoreti del VPC. **Example** Per Linux, macOS o Unix: ``` aws docdb describe-db-subnet-groups \ --db-subnet-group-name default \ --query 'DBSubnetGroups[*].[DBSubnetGroupName,Subnets[*].[SubnetAvailabilityZone.Name,SubnetIdentifier]]' ``` Per Windows: ``` aws docdb describe-db-subnet-groups ^ --db-subnet-group-name default ^ --query 'DBSubnetGroups[*].[DBSubnetGroupName,Subnets[*].[SubnetAvailabilityZone.Name,SubnetIdentifier]]' ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` [ [ "default", [ [ "us-east-1a", "subnet-4e26d263" ], [ "us-east-1c", "subnet-afc329f4" ], [ "us-east-1e", "subnet-b3806e8f" ], [ "us-east-1d", "subnet-53ab3636" ], [ "us-east-1b", "subnet-991cb8d0" ], [ "us-east-1f", "subnet-29ab1025" ] ] ] ] ``` Utilizzando l'output dall'operazione precedente, è possibile creare un nuovo gruppo di sottoreti. Il nuovo gruppo di sottoreti deve includere sottoreti da almeno due zone di disponibilità. **Parametri:** + **--db-subnet-group-name**: obbligatorio. Il nome di questo gruppo di sottoreti. + **--db-subnet-group-description**: obbligatorio. La descrizione di questo gruppo di sottoreti. + **--subnet-ids**: obbligatorio. Un elenco di sottoreti da includere in questo gruppo di sottoreti. Esempio: `subnet-53ab3636`. + --Tags —Facoltativo****. Un elenco di tag (coppie chiave/valore) da collegare a questo gruppo di sottoreti. Il codice seguente crea il gruppo di sottoreti `sample-subnet-group` con tre sottoreti `subnet-4e26d263`, `subnet-afc329f4` e `subnet-b3806e8f`. Per Linux, macOS o Unix: ``` aws docdb create-db-subnet-group \ --db-subnet-group-name sample-subnet-group \ --db-subnet-group-description "A sample subnet group" \ --subnet-ids subnet-4e26d263 subnet-afc329f4 subnet-b3806e8f \ --tags Key=tag1,Value=One Key=tag2,Value=2 ``` Per Windows: ``` aws docdb create-db-subnet-group ^ --db-subnet-group-name sample-subnet-group ^ --db-subnet-group-description "A sample subnet group" ^ --subnet-ids subnet-4e26d263 subnet-afc329f4 subnet-b3806e8f ^ --tags Key=tag1,Value=One Key=tag2,Value=2 ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "DBSubnetGroup": { "DBSubnetGroupDescription": "A sample subnet group", "DBSubnetGroupName": "sample-subnet-group", "Subnets": [ { "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetIdentifier": "subnet-4e26d263", "SubnetStatus": "Active" }, { "SubnetAvailabilityZone": { "Name": "us-east-1c" }, "SubnetIdentifier": "subnet-afc329f4", "SubnetStatus": "Active" }, { "SubnetAvailabilityZone": { "Name": "us-east-1e" }, "SubnetIdentifier": "subnet-b3806e8f", "SubnetStatus": "Active" } ], "VpcId": "vpc-91280df6", "DBSubnetGroupArn": "arn:aws:rds:us-east-1:123SAMPLE012:subgrp:sample-subnet-group", "SubnetGroupStatus": "Complete" } } ``` ------ # Descrizione di un sottogruppo di Amazon DocumentDB Puoi usare Console di gestione AWS o the AWS CLI per ottenere i dettagli di un sottogruppo di Amazon DocumentDB. ------ #### [ Using the Console di gestione AWS ] La procedura seguente mostra come ottenere i dettagli di un sottogruppo di Amazon DocumentDB. **Per individuare i dettagli di un gruppo di sottoreti** 1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb) 1. Nel pannello di navigazione selezionare **Subnet groups (Gruppi di sottoreti)**. **Suggerimento** Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina. 1. Per vedere i dettagli di un gruppo di sottoreti, selezionare il nome di tale gruppo di sottoreti. ![\[Screenshot: Mostrare i dettagli di un gruppo di sottoreti.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-subnet-group-details.png) ------ #### [ Using the AWS CLI ] Per trovare i dettagli di un sottogruppo di Amazon DocumentDB, utilizza l'`describe-db-subnet-groups`operazione con il seguente parametro. **Parametro** + `--db-subnet=group-name`—Facoltativo. Se incluso, sono elencati i dettagli per il gruppo di sottoreti designato. Se omesso, sono elencati i dettagli di un massimo di 100 gruppi di sottoreti. **Example** Il codice seguente elenca i dettagli per il gruppo di sottoreti `sample-subnet-group` che abbiamo creato nella sezione [Creazione di un sottogruppo di Amazon DocumentDB](document-db-subnet-group-create.md). Per Linux, macOS o Unix: ``` aws docdb describe-db-subnet-groups \ --db-subnet-group-name sample-subnet-group ``` Per Windows: ``` aws docdb describe-db-subnet-groups ^ --db-subnet-group-name sample-subnet-group ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { "DBSubnetGroup": { "DBSubnetGroupArn": "arn:aws:rds:us-east-1:123SAMPLE012:subgrp:sample-subnet-group", "VpcId": "vpc-91280df6", "SubnetGroupStatus": "Complete", "DBSubnetGroupName": "sample-subnet-group", "Subnets": [ { "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-4e26d263" }, { "SubnetAvailabilityZone": { "Name": "us-east-1c" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-afc329f4" }, { "SubnetAvailabilityZone": { "Name": "us-east-1e" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-b3806e8f" } ], "DBSubnetGroupDescription": "A sample subnet group" } } ``` ------ # Modifica di un gruppo di sottoreti Amazon DocumentDB Puoi usare Console di gestione AWS o AWS CLI per modificare la descrizione di un gruppo di sottoreti o per aggiungere o rimuovere sottoreti da un sottogruppo di Amazon DocumentDB. Tuttavia, non è possibile modificare il gruppo di sottoreti `default`. ------ #### [ Using the Console di gestione AWS ] Puoi usare il Console di gestione AWS per modificare la descrizione di un gruppo di sottoreti o per aggiungere e rimuovere sottoreti. Ricorda che, al termine di questa operazione è necessario disporre di almeno due zone di disponibilità associate al gruppo di sottoreti. **Per modificare il gruppo di sottoreti** 1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb) 1. Nel pannello di navigazione selezionare **Subnet groups (Gruppi di sottoreti)**. Quindi scegliere il pulsante a sinistra del nome del gruppo di sottoreti. Ricorda che non è possibile modificare il gruppo di sottoreti `default`. **Suggerimento** Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina. 1. Scegli **Actions (Operazioni)**, quindi **Modify (Modifica)**. 1. **Descrizione**: per modificare la descrizione del tuo gruppo di sottoreti, inserisci una nuova descrizione. 1. Per modificare le sottoreti associate al gruppo di sottoreti, nella sezione **Add subnets (Aggiungi sottoreti)** , eseguire una o più delle operazioni seguenti: + Per rimuovere tutte le sottoreti da questo gruppo di sottoreti, scegliere **Remove all (Rimuovi tutte)**. + Per rimuovere sottoreti specifiche da questo gruppo di sottoreti, scegliere **Remove (Rimuovi)** per ciascuna sottorete da rimuovere. + Per aggiungere tutte le sottoreti associate a questo VPC, scegliere **Add all the subnets related to this VPC (Aggiungi tutte le sottoreti correlate a questo VPC)**. + Per aggiungere sottoreti specifiche a questo gruppo di sottoreti, eseguire la procedura seguente per ogni zona di disponibilità a cui si desidera aggiungere una sottorete. 1. **Zona di disponibilità**: nell'elenco, scegli una nuova zona di disponibilità. 1. **Subnet**: nell'elenco, scegli una sottorete dalla zona di disponibilità scelta per questo gruppo di sottoreti. 1. Scegliere **Add subnet (Aggiungi sottorete)**. 1. Nella finestra di dialogo di conferma: + Per apportare tali modifiche al gruppo di sottoreti, scegliere **Modify (Modifica)**. + Per mantenere il gruppo di sottoreti invariato, scegliere **Cancel (Annulla)**. ------ #### [ Using the AWS CLI ] È possibile utilizzare il AWS CLI per modificare la descrizione di un gruppo di sottoreti o per aggiungere e rimuovere sottoreti. Ricorda che, al termine di questa operazione è necessario disporre di almeno due zone di disponibilità associate al gruppo di sottoreti. Non è possibile modificare il gruppo di sottoreti `default`. **Parametri:** + `--db-subnet-group-name`: obbligatorio. Il nome del gruppo di sottoreti Amazon DocumentDB che stai modificando. + `--subnet-ids`: obbligatorio. Un elenco di tutte le sottoreti che vuoi aggiungere al gruppo di sottoreti al completamento di questa modifica. **Importante** Tutte le sottoreti attualmente nel gruppo di sottoreti che non vengono incluse in questo elenco vengono rimosse dal gruppo di sottoreti. Se si desidera conservare le sottoreti attualmente nel gruppo di sottoreti, è necessario includerle in questo elenco. + `--db-subnet-group-description`—Facoltativo. La descrizione del gruppo di sottoreti. **Example** Il codice seguente modifica la descrizione e sostituisce le sottoreti esistenti con le sottoreti `subnet-991cb8d0`, `subnet-53ab3636` e `subnet-29ab1025`. Per Linux, macOS o Unix: ``` aws docdb modify-db-subnet-group \ --db-subnet-group-name sample-subnet-group \ --subnet-ids subnet-991cb8d0 subnet-53ab3636 subnet-29ab1025 \ --db-subnet-group-description "Modified subnet group" ``` Per Windows: ``` aws docdb modify-db-subnet-group ^ --db-subnet-group-name sample-subnet-group ^ --subnet-ids subnet-991cb8d0 subnet-53ab3636 subnet-29ab1025 ^ --db-subnet-group-description "Modified subnet group" ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). Questo è lo stesso gruppo di sottoreti che è stato creato nella sezione [Creazione di un sottogruppo di Amazon DocumentDB](document-db-subnet-group-create.md). Tuttavia, le sottoreti nel gruppo di sottoreti vengono sostituite da quelle elencate nell'operazione `modify-db-subnet-group`. ``` { "DBSubnetGroup": { "DBSubnetGroupArn": "arn:aws:rds:us-east-1:123SAMPLE012:subgrp:sample-subnet-group", "DBSubnetGroupDescription": "Modified subnet group", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetAvailabilityZone": { "Name": "us-east-1d" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-53ab3636" }, { "SubnetAvailabilityZone": { "Name": "us-east-1b" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-991cb8d0" }, { "SubnetAvailabilityZone": { "Name": "us-east-1f" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-29ab1025" } ], "VpcId": "vpc-91280df6", "DBSubnetGroupName": "sample-subnet-group" } } ``` ------ # Eliminazione di un sottogruppo di Amazon DocumentDB Puoi usare Console di gestione AWS o AWS CLI per eliminare un sottogruppo di Amazon DocumentDB. Tuttavia, non è possibile eliminare il gruppo di sottoreti `default`. ------ #### [ Using the Console di gestione AWS ] Puoi usare il Console di gestione AWS per eliminare un gruppo di sottoreti. Tuttavia, non è possibile eliminare il gruppo di sottoreti `default`. **Per eliminare un gruppo di sottoreti** 1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb) 1. Nel pannello di navigazione selezionare **Subnet groups (Gruppi di sottoreti)**. Quindi scegliere il pulsante a sinistra del nome del gruppo di sottoreti. Ricorda che non è possibile eliminare il gruppo di sottoreti `default`. **Suggerimento** Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina. 1. Scegli **Azioni**, quindi **Elimina**. 1. Nella finestra di dialogo di conferma: + Per eliminare il gruppo di sottoreti, scegliere **Delete (Elimina)**. + Per mantenere il gruppo di sottoreti, scegliere **Cancel (Annulla)**. ------ #### [ Using the AWS CLI ] Per eliminare un sottogruppo di Amazon DocumentDB utilizzando il AWS CLI, utilizza l'`delete-db-subnet-group`operazione con il seguente parametro. **Parametro** + `--db-subnet-group-name`: obbligatorio. Il nome del sottogruppo di Amazon DocumentDB da eliminare. Ricorda che non è possibile eliminare il gruppo di sottoreti `default`. **Example** Il codice seguente consente di eliminare `sample-subnet-group`. Per Linux, macOS o Unix: ``` aws docdb delete-db-subnet-group \ --db-subnet-group-name sample-subnet-group ``` Per Windows: ``` aws docdb delete-db-subnet-group ^ --db-subnet-group-name sample-subnet-group ``` L'operazione non produce alcun output. ------