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 delle istanze di Amazon DocumentDB
I seguenti argomenti forniscono informazioni per aiutarti a gestire le istanze di Amazon DocumentDB. Includono dettagli sulle classi e gli stati delle istanze e su come creare, eliminare e modificare un'istanza.
**Topics**
+ [Determinazione dello stato di un'istanza](#db-instance-status)
+ [Ciclo di vita dell'istanza](db-instance-life-cycle.md)
+ [Gestione delle classi di istanze](db-instance-classes.md)
+ [Istanze supportate da NVMe](db-instance-nvme.md)
## Determinazione dello stato di un'istanza
Per visualizzare gli stati validi di un'istanza, il loro significato e come determinare lo stato delle istanze, consulta [Monitoraggio dello stato di un'istanza Amazon DocumentDB](monitoring_docdb-instance_status.md).
# Ciclo di vita delle istanze Amazon DocumentDB
Il ciclo di vita di un'istanza Amazon DocumentDB include la creazione, la modifica, la manutenzione e l'aggiornamento, l'esecuzione di backup e ripristini, il riavvio e l'eliminazione dell'istanza. Questa sezione fornisce informazioni su come completare questi processi.
**Topics**
+ [Aggiungere un'istanza](db-instance-add.md)
+ [Descrizione delle istanze](db-instance-view-details.md)
+ [Modifica di un'istanza](db-instance-modify.md)
+ [Riavvio di un'istanza](db-instance-reboot.md)
+ [Eliminazione di un'istanza](db-instance-delete.md)
Puoi creare una nuova istanza di Amazon DocumentDB utilizzando Console di gestione AWS o il. AWS CLI Per aggiungere un'istanza a un cluster, il cluster deve essere nello stato *disponibile* . Non è possibile aggiungere un'istanza a un cluster arrestato. Se il cluster viene arrestato, per prima cosa avviare il cluster, attendere che diventi *disponibile*, quindi aggiungere un’istanza. Per ulteriori informazioni, consulta [Arresto e avvio di un cluster Amazon DocumentDB](db-cluster-stop-start.md).
**Nota**
Se crei un cluster Amazon DocumentDB utilizzando la console, contemporaneamente viene creata automaticamente un'istanza per te. Per creare altre istanze, utilizza una delle procedure riportate di seguito.
# Aggiungere un'istanza Amazon DocumentDB a un cluster
------
#### [ Using the Console di gestione AWS ]
Utilizza la seguente procedura per creare un'istanza per il tuo cluster utilizzando la console 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. Nel pannello di navigazione scegliere **Cluster**.
**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 scegliere il cluster a cui aggiungere un'istanza, seleziona il pulsante a sinistra del nome del cluster.
1. Scegli **Actions (Operazioni)**, quindi **Add instance (Aggiungi istanza)**.
1. Nella pagina **Add instance to: (Aggiungi istanza a:)** ripetere i seguenti passaggi per ogni istanza che si desidera aggiungere al cluster. Puoi averne fino a 15.
1. **Identificatore dell'istanza**: puoi inserire un identificatore univoco per questa istanza o consentire ad Amazon DocumentDB di fornire l'identificatore dell'istanza basato sull'identificatore del cluster.
Vincoli per la denominazione di un'istanza:
+ La lunghezza è di [1—63] lettere, numeri o trattini.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
+ Deve essere unico per tutte le istanze in Amazon RDS, Neptune e Amazon DocumentDB per regione. Account AWS
1. **Classe di istanza**: dall'elenco a discesa, scegli il tipo di istanza che desideri per questa istanza.
1. **Livello di promozione**: dall'elenco a discesa, scegli il livello di promozione per la tua istanza o scegli *Nessuna preferenza* per consentire ad Amazon DocumentDB di impostare il livello di promozione per la tua istanza. Un numero minore indica una priorità più elevata. Per ulteriori informazioni, consulta [Controllo della destinazione del failover](failover.md#failover-target_control).
1. Per aggiungere ulteriori istanze, scegliere **Add additional instances (Aggiungi istanze aggiuntive)** e ripetere i passaggi a, b e c.
1. Terminare l'operazione.
+ Per aggiungere istanze al cluster, scegliere **Crea**.
+ Per annullare l'operazione, scegli **Cancel (Annulla)**.
La creazione dell'istanza richiede diversi minuti. Puoi usare la console o AWS CLI visualizzare lo stato dell'istanza. Per ulteriori informazioni, consulta [Monitoraggio dello stato di un'istanza](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS CLI ]
Utilizza l'`create-db-instance` AWS CLI operazione con i seguenti parametri per creare l'istanza principale per il tuo cluster.
+ **--db-instance-class**: obbligatorio. La capacità di calcolo e di memoria dell'istanza, ad esempio `db.m4.large`. Non tutte le classi di istanze sono disponibili in tutte Regioni AWS.
+ **--db-instance-identifier**: obbligatorio. Una stringa di lettere minuscole che identifica l'istanza.
Vincoli per la denominazione di un'istanza:
+ La lunghezza è di [1—63] lettere, numeri o trattini.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
+ Deve essere unico per tutte le istanze in Amazon RDS, Neptune e Amazon DocumentDB per regione. Account AWS
+ **--engine**: obbligatorio. Deve essere `docdb`.
+ **--availability-zone**— Facoltativo. La zona di disponibilità in cui verrà creata l'istanza. Utilizza questo parametro per trovare le istanze in diverse zone di disponibilità per aumentare la tolleranza ai guasti. Per ulteriori informazioni, consulta [Amazon DocumentDB Disponibilità e replica elevate](replication.md).
+ **--promotion-tier**— Facoltativo. Il livello di priorità di failover per l'istanza. Il valore deve essere compreso tra 0 e 15 con i numeri più bassi che corrispondono a una priorità maggiore. Per ulteriori informazioni, consulta [Controllo della destinazione del failover](failover.md#failover-target_control).
1. **Innanzitutto, determina in quali zone di disponibilità puoi creare l'istanza. **
Se desideri specificare la zona di disponibilità prima di creare l'istanza, esegui il comando seguente per determinare quali zone di disponibilità sono disponibili per il tuo cluster Amazon DocumentDB.
Per Linux, macOS o Unix:
```
aws docdb describe-db-clusters \
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
Per Windows:
```
aws docdb describe-db-clusters ^
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
[
[
"sample-cluster",
[
"us-east-1c",
"us-east-1b",
"us-east-1a"
]
]
]
```
1. **In secondo luogo, determina quali classi di istanza puoi creare nella regione. **
Per determinare le classi di istanze disponibili nella tua regione, esegui il comando seguente. Dall'output, scegli una classe di istanza per l'istanza che desideri aggiungere al tuo cluster Amazon DocumentDB.
Per Linux, macOS o Unix:
```
aws docdb describe-orderable-db-instance-options \
--engine docdb \
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
Per Windows:
```
aws docdb describe-orderable-db-instance-options ^
--engine docdb ^
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
[
"db.r5.16xlarge",
"db.r5.2xlarge",
"db.r5.4xlarge",
"db.r5.8xlarge",
"db.r5.large",
"db.r5.xlarge"
]
```
1. **Infine, aggiungi un'istanza al tuo cluster Amazon DocumentDB.**
Per aggiungere un'istanza al tuo cluster Amazon DocumentDB, esegui il comando seguente.
Per Linux, macOS o Unix:
```
aws docdb create-db-instance \
--db-cluster-identifier sample-cluster \
--db-instance-identifier sample-instance-2 \
--availability-zone us-east-1b \
--promotion-tier 2 \
--db-instance-class db.r5.xlarge \
--engine docdb
```
Per Windows:
```
aws docdb create-db-instance ^
--db-cluster-identifier sample-cluster ^
--db-instance-identifier sample-instance-2 ^
--availability-zone us-east-1b ^
--promotion-tier 2 ^
--db-instance-class db.r5.xlarge ^
--engine docdb
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance-2",
"DBInstanceClass": "db.r5.xlarge",
"Engine": "docdb",
"DBInstanceStatus": "creating",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1b",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-west-2a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-west-2b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:11:35-sun:12:05",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 2,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2"
}
}
```
La creazione dell'istanza richiede diversi minuti. Puoi usare la console o AWS CLI visualizzare lo stato dell'istanza. Per ulteriori informazioni, consulta [Monitoraggio dello stato di un'istanza Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
# Descrizione delle istanze di Amazon DocumentDB
Puoi utilizzare la console di gestione di Amazon DocumentDB o visualizzare dettagli come endpoint di connessione, gruppi di sicurezza, autorità di certificazione e gruppi VPCs di parametri relativi alle tue istanze di Amazon DocumentDB. AWS CLI
------
#### [ Using the Console di gestione AWS ]
Per visualizzare i dettagli delle istanze utilizzando la Console di gestione AWS, segui la procedura riportata di seguito.
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 scegliere **Cluster**.
**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. **Nella casella di navigazione Clusters, vedrai la colonna Cluster Identifier.** Le tue istanze sono elencate in cluster, in modo simile alla schermata seguente.
![\[Tabella dei cluster che mostra l'elenco dei cluster nella colonna Cluster identifier, con le istanze annidate all'interno dei cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/choose-clusters.png)
1. Nell'elenco delle istanze, scegli il nome dell'istanza di cui desideri visualizzarne i dettagli. Le informazioni sull'istanza sono organizzate nei seguenti raggruppamenti:
+ **Riepilogo**: informazioni generali sull'istanza, tra cui la versione del motore, la classe, lo stato e qualsiasi manutenzione in sospeso.
+ **Connettività e sicurezza**: la sezione **Connect** elenca gli endpoint di connessione per connettersi a questa istanza con la shell mongo o con un'applicazione. Nella sezione **Security Groups (Gruppi di sicurezza)** sono elencati i gruppi di sicurezza associati a questa istanza, l'ID VPC e le descrizioni.
+ **Configurazione**: la sezione **Dettagli** elenca le configurazioni e lo stato dell'istanza, inclusi l'Amazon Resource Name (ARN), l'endpoint, il ruolo, la classe e l'autorità di certificazione dell'istanza. Vengono inoltre elencate le impostazioni di sicurezza e di rete dell'istanza e le informazioni di backup. La sezione **Cluster details (Dettagli cluster)** elenca i dettagli del cluster a cui appartiene questa istanza. La sezione **Istanze del cluster** elenca tutte le istanze che appartengono al cluster con lo stato del ruolo e del gruppo di parametri del cluster di ogni istanza.
**Nota**
Puoi modificare il cluster associato all'istanza selezionando **Modify (Modifica)** accanto all'intestazione **Cluster details (Dettagli cluster)** . Per ulteriori informazioni, consulta [Modifica di un cluster Amazon DocumentDB](db-cluster-modify.md).
+ **Monitoraggio**: i parametri dei CloudWatch log per questa istanza. Per ulteriori informazioni, consulta [Monitoraggio di Amazon DocumentDB con CloudWatch](cloud_watch.md).
+ **Eventi e tag**: la sezione **Eventi recenti elenca gli eventi** recenti per questa istanza. Amazon DocumentDB registra gli eventi relativi a cluster, istanze, snapshot, gruppi di sicurezza e gruppi di parametri del cluster. Queste informazioni includono la data, l'ora e il messaggio associati a ciascun evento. La sezione **Tag** elenca i tag allegati al cluster. Per ulteriori informazioni, consulta [Etichettatura delle risorse di Amazon DocumentDB](tagging.md).
------
#### [ Using the AWS CLI ]
Per visualizzare i dettagli delle tue istanze di Amazon DocumentDB utilizzando il AWS CLI, usa il `describe-db-clusters` comando come mostrato negli esempi seguenti. Per ulteriori informazioni, consulta [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html)*Amazon DocumentDB Resource Management API* Reference.
**Nota**
Per alcune funzionalità di gestione come la gestione del ciclo di vita di cluster e istanze, Amazon DocumentDB sfrutta la tecnologia operativa condivisa con Amazon RDS. Il parametro `filterName=engine,Values=docdb` filter restituisce solo cluster Amazon DocumentDB.
1. **Elenca tutte le istanze di Amazon DocumentDB.**
Il AWS CLI codice seguente elenca i dettagli per tutte le istanze di Amazon DocumentDB in una regione.
Per Linux, macOS o Unix:
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
Per Windows:
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
1. **Elenca tutti i dettagli per un'istanza Amazon DocumentDB specificata**
Il codice seguente consente di elencare i dettagli per `sample-cluster-instance`. Se includi il parametro `--db-instance-identifier` nel nome di un'istanza, puoi limitare l’output alle sole informazioni su quella specifica istanza.
Per Linux, macOS o Unix:
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
Per Windows:
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
{
"DBInstances": [
{
"DbiResourceId": "db-BJKKB54PIDV5QFKGVRX5T3S6GM",
"DBInstanceArn": "arn:aws:rds:us-east-1:012345678901:db:sample-cluster-instance-00",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"DBInstanceClass": "db.r5.large",
"DBInstanceStatus": "creating",
"AutoMinorVersionUpgrade": true,
"PreferredMaintenanceWindow": "fri:09:32-fri:10:02",
"BackupRetentionPeriod": 1,
"StorageEncrypted": true,
"DBClusterIdentifier": "sample-cluster",
"EngineVersion": "3.6.0",
"AvailabilityZone": "us-east-1a",
"Engine": "docdb",
"PromotionTier": 2,
"DBInstanceIdentifier": "sample-cluster-instance",
"PreferredBackupWindow": "00:00-00:30",
"PubliclyAccessible": false,
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"Subnets": [
{
"SubnetIdentifier": "subnet-4e26d263",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-afc329f4",
"SubnetAvailabilityZone": {
"Name": "us-east-1c"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-b3806e8f",
"SubnetAvailabilityZone": {
"Name": "us-east-1e"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-53ab3636",
"SubnetAvailabilityZone": {
"Name": "us-east-1d"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-991cb8d0",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-29ab1025",
"SubnetAvailabilityZone": {
"Name": "us-east-1f"
},
"SubnetStatus": "Active"
}
],
"VpcId": "vpc-91280df6",
"DBSubnetGroupDescription": "default",
"SubnetGroupStatus": "Complete"
},
"PendingModifiedValues": {},
"KmsKeyId": "arn:aws:kms:us-east-1:012345678901:key/0961325d-a50b-44d4-b6a0-a177d5ff730b"
}
]
}
```
------
# Modifica di un'istanza Amazon DocumentDB
Puoi modificare la tua istanza di Amazon DocumentDB utilizzando Console di gestione AWS o. AWS CLI Per modificare un'istanza, questa deve essere nello stato *disponibile* . Non è possibile modificare un'istanza arrestata. Se il cluster viene arrestato, per prima cosa avviare il cluster, attendere che l’istanza diventi *disponibile*, quindi apportare le modifiche desiderate. Per ulteriori informazioni, consulta [Arresto e avvio di un cluster Amazon DocumentDB](db-cluster-stop-start.md).
------
#### [ Using the Console di gestione AWS ]
Per modificare un'istanza specifica di Amazon DocumentDB utilizzando la console, completa i seguenti passaggi.
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 scegliere **Cluster**.
**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. **Nella casella di navigazione Clusters, vedrai la colonna Cluster Identifier.** Le tue istanze sono elencate in cluster, in modo simile alla schermata seguente.
![\[Tabella dei cluster che mostra l'elenco dei cluster nella colonna Cluster identifier, con le istanze annidate all'interno dei cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/choose-clusters.png)
1. Seleziona la casella a sinistra dell'istanza che desideri modificare.
1. Scegli **Actions (Operazioni)**, quindi **Modify (Modifica)**.
1. Nel riquadro **Modify instance: (Modifica istanza: instance-name)** apporta le modifiche desiderate. È possibile apportare le seguenti modifiche.
+ **Specifiche dell'istanza**: l'identificatore e la classe dell'istanza. Vincoli di denominazione dell'identificatore di istanza:
+ **Identificatore dell'istanza**: inserisci un nome univoco per tutte le istanze di tua proprietà Account AWS nell'area corrente. L'identificatore di istanza deve contenere [1—63] caratteri alfanumerici o trattini, avere una lettera come primo carattere e non può terminare con un trattino o contenere due trattini consecutivi.
+ **Classe di istanza**: dal menu a discesa, seleziona una classe di istanza per la tua istanza Amazon DocumentDB. Per ulteriori informazioni, consulta [Gestione delle classi di istanze](db-instance-classes.md).
+ **Autorità di certificazione: certificato** del server per questa istanza. Per ulteriori informazioni, consulta [Aggiornamento dei certificati TLS di Amazon DocumentDB](ca_cert_rotation.md).
+ **Failover**: durante il failover, l'istanza con il livello di promozione più alto verrà promossa a principale. Per ulteriori informazioni, consulta [Failover di Amazon DocumentDB](failover.md).
+ **Manutenzione**: la finestra di manutenzione in cui le modifiche o le patch in sospeso vengono applicate alle istanze del cluster.
1. Al termine, scegli **Continue (Continua)** per visualizzare un riepilogo delle modifiche.
1. Dopo aver verificato le modifiche, è possibile applicarle immediatamente o durante la successiva finestra di manutenzione in **Scheduling of modifications (Pianificazione delle modifiche)**. Scegli **Instance (Modifica istanza)** per salvare le modifiche. In alternativa, puoi selezionare **Cancel (Annulla)** per eliminare le modifiche.
L'applicazione delle modifiche richiede qualche minuto. Puoi utilizzare l'istanza solo quando ha lo stato *disponibile*. Puoi monitorare lo stato dell'istanza con la console o l' AWS CLI. Per ulteriori informazioni, consulta [Monitoraggio dello stato di un'istanza Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS CLI ]
Per modificare un'istanza specifica di Amazon DocumentDB utilizzando il AWS CLI, utilizza `modify-db-instance` i seguenti parametri. Per ulteriori informazioni, consulta [Modify. DBInstance](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBInstance.html) Il codice seguente modifica la classe di istanza in `db.r5.large` per l'istanza `sample-instance`.
**Parameters**
+ **--db-instance-identifier**: obbligatorio. L'identificatore dell'istanza da modificare.
+ **--db-instance-class**— Facoltativo. La nuova capacità di calcolo e memoria dell'istanza, `db.r5.large` ad esempio. Non tutte le classi di istanze sono disponibili in tutte Regioni AWS. Se si modifica la classe dell'istanza, si verifica un'interruzione durante la modifica. La modifica viene applicata durante la finestra di manutenzione successiva, a meno che non `ApplyImmediately` sia specificata come true per questa richiesta.
+ **--apply-immediately**o **--no-apply-immediately** — Facoltativo. Specifica se questa modifica debba essere applicata subito o alla prossima finestra di manutenzione. Se questo parametro viene omesso, la modifica viene eseguita durante la finestra di manutenzione successiva.
**Example**
Per Linux, macOS o Unix:
```
aws docdb modify-db-instance \
--db-instance-identifier sample-instance \
--db-instance-class db.r5.large \
--apply-immediately
```
Per Windows:
```
aws docdb modify-db-instance ^
--db-instance-identifier sample-instance ^
--db-instance-class db.r5.large ^
--apply-immediately
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
{
"DBInstances": [
{
"DBInstanceIdentifier": "sample-instance-1",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "modifying",
"Endpoint": {
"Address": "sample-instance-1.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-01-10T22:18:55.921Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1a",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-abcd0123",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:10:57-sun:11:27",
"PendingModifiedValues": {
"DBInstanceClass": "db.r5.large"
},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:sample-instance-1",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
]
}
```
L'applicazione delle modifiche richiede qualche minuto. Puoi utilizzare l'istanza solo quando ha lo stato *disponibile*. È possibile monitorare lo stato dell'istanza utilizzando Console di gestione AWS o AWS CLI. Per ulteriori informazioni, consulta [Monitoraggio dello stato di un'istanza Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
# Riavvio di un'istanza Amazon DocumentDB
Occasionalmente, potrebbe essere necessario riavviare l'istanza di Amazon DocumentDB, di solito per motivi di manutenzione. Se apporti alcune modifiche, ad esempio la modifica del gruppo di parametri del cluster associato a un cluster, devi riavviare le istanze del cluster affinché le modifiche abbiano effetto. È possibile riavviare un'istanza specificata utilizzando o il Console di gestione AWS . AWS CLI
Il riavvio di un'istanza comporta il riavvio del servizio del motore di database. Il riavvio comporta un'interruzione temporanea, durante la quale lo stato dell'istanza viene impostato `rebooting`. Un evento Amazon DocumentDB viene creato al termine del riavvio.
Il riavvio di un'istanza non comporta un failover. Per eseguire il failover di un cluster Amazon DocumentDB, usa Console di gestione AWS l'operazione o AWS CLI . `failover-db-cluster` Per ulteriori informazioni, consulta [Failover di Amazon DocumentDB](failover.md).
Non puoi riavviare l'istanza se il suo stato non è *disponibile*. Il database può non essere disponibile per diversi motivi, ad esempio una modifica richiesta in precedenza o un'operazione della finestra di manutenzione. Per ulteriori informazioni sugli stati delle istanze, consulta [Monitoraggio dello stato di un'istanza Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
#### [ Using the Console di gestione AWS ]
La procedura seguente riavvia un'istanza specificata utilizzando la console.
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 scegliere **Cluster**.
**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. **Nella casella di navigazione Clusters, vedrai la colonna Cluster Identifier.** Le tue istanze sono elencate in cluster, in modo simile alla schermata seguente.
![\[Tabella dei cluster che mostra l'elenco dei cluster nella colonna Cluster identifier, con le istanze annidate all'interno dei cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/choose-clusters.png)
1. Seleziona la casella a sinistra dell'istanza che desideri riavviare.
1. Scegli **Actions (Operazioni)**, scegli **Reboot (Riavvia)** e quindi **Reboot (Riavvia)** per confermare il riavvio.
Per il riavvio dell'istanza sono necessari alcuni minuti. Puoi utilizzare l'istanza solo quando ha lo stato *disponibile*. Puoi monitorare lo stato dell'istanza con la console o l' AWS CLI. Per ulteriori informazioni, consulta [Monitoraggio dello stato di un'istanza Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS CLI ]
Per riavviare un'istanza Amazon DocumentDB, utilizza l'operazione con `reboot-db-instance` `--db-instance-identifier` il parametro. Questo parametro specifica l'identificatore per l'istanza da riavviare.
Il codice seguente riavvia l'istanza `sample-instance`.
**Example**
Per Linux, macOS o Unix:
```
aws docdb reboot-db-instance \
--db-instance-identifier sample-instance
```
Per Windows:
```
aws docdb reboot-db-instance ^
--db-instance-identifier sample-instance
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "rebooting",
"Endpoint": {
"Address": "sample-instance.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-03-27T08:05:56.314Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1c",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-abcd0123",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
}
```
Per il riavvio dell'istanza sono necessari alcuni minuti. Puoi utilizzare l'istanza solo quando ha lo stato *disponibile*. Puoi monitorare lo stato dell'istanza con la console o l' AWS CLI. Per ulteriori informazioni, consulta [Monitoraggio dello stato di un'istanza Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
# Eliminazione di un'istanza Amazon DocumentDB
Puoi eliminare la tua istanza di Amazon DocumentDB utilizzando Console di gestione AWS o. AWS CLI Per eliminare un'istanza, questa deve essere nello stato *disponibile*. Non è possibile eliminare un'istanza arrestata. Se il cluster Amazon DocumentDB che contiene l'istanza viene interrotto, avvia prima il cluster, attendi che l'istanza diventi *disponibile*, quindi elimina l'istanza. Per ulteriori informazioni, consulta [Arresto e avvio di un cluster Amazon DocumentDB](db-cluster-stop-start.md).
**Nota**
Amazon DocumentDB archivia tutti i dati nel volume del cluster. I dati persistono nel volume cluster, anche se rimuovi tutte le istanze dal cluster. Se hai bisogno di accedere nuovamente ai dati, puoi aggiungere un'istanza al cluster in qualsiasi momento e riprendere da dove avevi lasciato.
------
#### [ Using the Console di gestione AWS ]
La procedura seguente elimina un'istanza Amazon DocumentDB specificata utilizzando la console.
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 scegliere **Cluster**.
**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. **Nella casella di navigazione Clusters, vedrai la colonna Cluster Identifier.** Le tue istanze sono elencate in cluster, in modo simile alla schermata seguente.
![\[Tabella dei cluster che mostra l'elenco dei cluster nella colonna Cluster identifier, con le istanze annidate all'interno dei cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/choose-clusters.png)
1. Seleziona la casella a sinistra dell'istanza che desideri eliminare.
1. Scegli **Actions (Operazioni)**, quindi **Delete (Elimina)**.
1. Se stai eliminando l'ultima istanza nel cluster:
+ **Create final cluster snapshot? (Crea la snapshot del cluster finale?)** — Scegliete **Sì** se desiderate creare un'istantanea finale prima dell'eliminazione del cluster. Altrimenti, scegli **No**.
+ **Nome dell'istantanea finale**: se scegli di creare un'istantanea finale, inserisci l'identificatore dell'istantanea del cluster della nuova istantanea del cluster creata.
+ **Delete instance? (Elimina istanza ?)** — Inserisci la frase **delete entire cluster** nel campo per confermare l'eliminazione.
1. Se non stai eliminando l'ultima istanza nel cluster:
+ **Delete instance? (Elimina istanza ?)** — Inserisci la frase **delete me** nel campo per confermare l'eliminazione.
1. Seleziona **Delete (Elimina)** per eliminare l'istanza.
Sono necessari alcuni minuti per l'eliminazione dell'istanza. Per monitorare lo stato di un'istanza, consulta [Monitoraggio dello stato di un'istanza Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS CLI ]
La procedura seguente elimina un'istanza di Amazon DocumentDB utilizzando. AWS CLI
1. **Innanzitutto, determina quante istanze ci sono nel tuo cluster Amazon DocumentDB:**
Per determinare il numero di istanze presenti nel cluster, esegui il comando `describe-db-clusters` come indicato di seguito.
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]'
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
[
[
"sample-cluster",
[
"sample-instance-1",
"sample-instance-2"
]
]
]
```
1. **Se nel cluster Amazon DocumentDB sono presenti più di un'istanza:**
Per eliminare un'istanza Amazon DocumentDB specificata, usa il `delete-db-instance` comando con il `--db-instance-identifier` parametro, come illustrato di seguito. Sono necessari alcuni minuti per l'eliminazione dell'istanza. Per monitorare lo stato di un'istanza, consulta [Monitoraggio dello stato di un'istanza Amazon DocumentDB](monitoring_docdb-instance_status.md).
```
aws docdb delete-db-instance \
--db-instance-identifier sample-instance-2
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance-2",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "deleting",
"Endpoint": {
"Address": "sample-instance-2.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-03-27T08:05:56.314Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1c",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
}
```
1. **Se l'istanza che desideri eliminare è l'ultima istanza del tuo cluster Amazon DocumentDB:**
Se elimini l'ultima istanza in un cluster Amazon DocumentDB, elimini anche quel cluster e gli snapshot automatici e i backup continui associati a quel cluster.
Per eliminare l'ultima istanza del cluster, puoi eliminare il cluster e, facoltativamente, creare uno snapshot finale. Per ulteriori informazioni, consulta [Eliminazione di un cluster Amazon DocumentDB](db-cluster-delete.md).
------
## Protezione da eliminazione
L'eliminazione dell'ultima istanza di un cluster Amazon DocumentDB comporta anche l'eliminazione del cluster, nonché gli snapshot automatici e i backup continui associati a tale cluster. Amazon DocumentDB applica la protezione da eliminazione per un cluster indipendentemente dal fatto che l'operazione di eliminazione venga eseguita utilizzando o il Console di gestione AWS . AWS CLI Se la protezione dall'eliminazione è abilitata, non puoi eliminare un cluster.
Per eliminare un cluster con la protezione dall'eliminazione abilitata, devi modificare il cluster e disabilitare la protezione dall'eliminazione. Per ulteriori informazioni, consulta [Eliminazione di un cluster Amazon DocumentDB](db-cluster-delete.md).
# Gestione delle classi di istanze
La classe di istanza determina la capacità di calcolo e memoria di un'istanza Amazon DocumentDB (con compatibilità con MongoDB). La classe di istanza di cui hai bisogno dipende dai requisiti in termini di potenza di elaborazione e memoria.
Amazon DocumentDB supporta le famiglie di classi di istanze R4, R5, R6G, R8G, T3 e T4G. ovvero classi di istanze della generazione attuale ottimizzate per applicazioni a elevato utilizzo di memoria. Per le specifiche relative a tali classi, consulta [Specifiche della classe di istanza](#db-instance-class-specs).
**Topics**
+ [Determinare una classe di istanza](#db-instance-class-determining)
+ [Modifica della classe di un'istanza](#db-instance-class-changing)
+ [Classi di istanza supportate per regione](#db-instance-classes-by-region)
+ [Specifiche della classe di istanza](#db-instance-class-specs)
## Determinare una classe di istanza
Per determinare la classe di un'istanza, è possibile utilizzare l'`describe-db-instances` AWS CLI operazione Console di gestione AWS o.
------
#### [ Using the Console di gestione AWS ]
Per determinare la classe di istanza per le istanze del cluster, completa i seguenti passaggi nella console.
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, scegli **Clusters** per trovare l'istanza che ti interessa.
**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. Nella casella di navigazione Clusters, vedrai la colonna **Cluster** Identifier. Le tue istanze sono elencate in cluster, in modo simile alla schermata seguente.
![\[Tabella dei cluster che mostra come un'istanza viene annidata in un cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/choose-clusters.png)
1. Nell'elenco delle istanze, espandi il cluster per trovare le istanze che ti interessano. Trova l'istanza che desideri. Quindi, guarda la colonna **Size** della riga dell'istanza per vedere la sua classe di istanza.
Nell'immagine seguente, la classe per l'istanza `robo3t` è `db.r5.4xlarge`.
![\[Elenco delle istanze nella tabella Clusters con la colonna Size che mostra il tipo di istanza.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/instance-class.png)
------
#### [ Using the AWS CLI ]
Per determinare la classe di un'istanza utilizzando il AWS CLI, utilizzate l'`describe-db-instances`operazione con i seguenti parametri.
+ **--db-instance-identifier**— Facoltativo. Specifica l'istanza della quale desideri trovare la classe. Se questo parametro viene omesso, `describe-db-instances` restituisce una descrizione per un massimo di 100 istanze.
+ **--query**— Facoltativo. Specifica i membri dell'istanza da includere nei risultati. Se questo parametro viene omesso, vengono restituiti tutti i membri dell'istanza.
**Example**
L'esempio seguente trova il nome e la classe dell'istanza`sample-instance-1`.
Per Linux, macOS o Unix:
```
aws docdb describe-db-instances \
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' \
--db-instance-identifier sample-instance-1
```
Per Windows:
```
aws docdb describe-db-instances ^
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' ^
--db-instance-identifier sample-instance-1
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
[
[
"sample-instance-1",
"db.r5.large"
]
```
**Example**
L'esempio seguente trova il nome e la classe dell'istanza per un massimo di 100 istanze di Amazon DocumentDB.
Per Linux, macOS o Unix:
```
aws docdb describe-db-instances \
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' \
--filter Name=engine,Values=docdb
```
Per Windows:
```
aws docdb describe-db-instances ^
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' ^
--filter Name=engine,Values=docdb
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
[
[
"sample-instance-1",
"db.r5.large"
],
[
"sample-instance-2",
"db.r5.large"
],
[
"sample-instance-3",
"db.r5.4xlarge"
],
[
"sample-instance-4",
"db.r5.4xlarge"
]
]
```
Per ulteriori informazioni, consulta [Descrizione delle istanze di Amazon DocumentDB](db-instance-view-details.md).
------
## Modifica della classe di un'istanza
È possibile modificare la classe di istanza dell'istanza utilizzando Console di gestione AWS o il AWS CLI. Per ulteriori informazioni, consulta [Modifica di un'istanza Amazon DocumentDB](db-instance-modify.md).
## Classi di istanza supportate per regione
Amazon DocumentDB supporta le seguenti classi di istanze:
+ `R8G`—Istanze ottimizzate per la memoria di ultima generazione basate su processori AWS Graviton4 basati su ARM che offrono prestazioni fino al 30% migliori rispetto alle istanze R6G.
+ `R6G`—Istanze ottimizzate per la memoria alimentate da processori AWS Graviton2 basati su ARM che offrono prestazioni fino al 30% migliori rispetto alle istanze R5 a un costo inferiore del 5%.
+ `R6GD`—Istanze R6G ottimizzate per la memoria con storage Solid-State Drive (SSD) basato su memoria non volatile locale per dati effimeri. NVMe
+ `R5`—Istanze ottimizzate per la memoria che offrono prestazioni fino al 100% migliori rispetto alle istanze R4 allo stesso costo delle istanze.
+ `R4`—Generazione precedente di istanze ottimizzate per la memoria.
+ `T4G`—Tipo di istanza generica, sostenibile e a basso costo di ultima generazione, alimentata da processori AWS Graviton2 basati su ARM che fornisce un livello base di prestazioni della CPU, offre un rapporto prezzo/prestazioni fino al 35% migliore rispetto alle istanze T3 ed è ideale per l'esecuzione di applicazioni con un utilizzo moderato della CPU che presentano picchi temporanei di utilizzo.
+ `T3`—Tipo di istanza generica espandibile a basso costo che fornisce un livello base di prestazioni della CPU con la possibilità di aumentare l'utilizzo della CPU in qualsiasi momento per tutto il tempo necessario.
Per specifiche dettagliate relative alle classi di istanze, consulta [Specifiche della classe di istanza](#db-instance-class-specs).
**Nota**
Lo storage ottimizzato per l'I/O è disponibile solo nelle versioni 5.0 e 8.0 del motore (cluster basati su istanze).
Una particolare classe di istanza può essere supportata o meno in una determinata regione. La tabella seguente specifica quali classi di istanze sono supportate da Amazon DocumentDB in ciascuna regione.
**Classi di istanze supportate per regione**
| | Classi di istanza | Region | R8G | R6GD | R6G | R5 | R4 | T4G | T3 | Serverless |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| Stati Uniti orientali (Ohio) | Supportata | Supportato | Supportato | Supportato | Supportato | Supportato | Supportato | Supportata |
| Stati Uniti orientali (Virginia settentrionale) | Supportata | Supportato | Supportato | Supportato | Supportato | Supportato | Supportato | Supportata |
| Stati Uniti occidentali (Oregon) | Supportata | Supportato | Supportato | Supportato | Supportato | Supportato | Supportato | Supportata |
| Africa (Città del Capo) | | | Supportata | Supportato | | Supportato | Supportato | Supportata |
| Sud America (San Paolo) | | Supportata | Supportato | Supportato | | Supportato | Supportato | Supportata |
| Asia Pacifico (Hong Kong) | | | Supportata | Supportato | | Supportato | Supportato | Supportata |
| Asia Pacifico (Hyderabad) | | | Supportata | Supportato | | Supportato | Supportato | Supportata |
| Asia Pacifico (Malesia) | | | Supportata | | | Supportato | Supportata | |
| Asia Pacifico (Mumbai) | Supportata | Supportato | Supportato | Supportato | | Supportato | Supportato | Supportata |
| Asia Pacifico (Osaka) | | Supportata | Supportato | Supportato | | Supportato | Supportata | |
| Asia Pacifico (Seul) | Supportata | Supportato | Supportato | Supportato | | Supportato | Supportato | Supportata |
| Asia Pacifico (Sydney) | Supportata | Supportato | Supportato | Supportato | | Supportato | Supportato | Supportata |
| Asia Pacifico (Giacarta) | Supportata | Supportato | Supportato | Supportato | | Supportato | Supportata | |
| Asia Pacifico (Melbourne) | | | Supportata | Supportato | | Supportato | Supportata | |
| Asia Pacifico (Singapore) | Supportata | Supportato | Supportato | Supportato | | Supportato | Supportato | Supportata |
| Asia Pacifico (Thailandia) | | | Supportata | | | Supportato | Supportata | |
| Asia Pacifico (Tokyo) | Supportata | Supportato | Supportato | Supportato | | Supportato | Supportato | Supportata |
| Canada (Centrale) | | Supportata | Supportato | Supportato | | Supportato | Supportato | Supportata |
| Europa (Francoforte) | Supportata | Supportato | Supportato | Supportato | | Supportato | Supportato | Supportata |
| Europa (Zurigo) | | Supportata | Supportato | Supportato | | Supportato | Supportata | |
| Europa (Irlanda) | Supportata | Supportato | Supportato | Supportato | Supportato | Supportato | Supportato | Supportata |
| Europa (Londra) | | Supportata | Supportato | Supportato | | Supportato | Supportato | Supportata |
| Europa (Milano) | | | Supportata | Supportato | | Supportato | Supportato | Supportata |
| Europa (Parigi) | | Supportata | Supportato | Supportato | | Supportato | Supportato | Supportata |
| Europa (Spagna) | Supportata | Supportato | Supportato | Supportato | | Supportato | Supportato | Supportata |
| Europa (Stoccolma) | Supportata | Supportato | Supportato | Supportato | | Supportato | Supportata | |
| Messico (centrale) | | | Supportata | | | Supportato | Supportata | |
| Medio Oriente (Emirati Arabi Uniti) | | | Supportata | Supportato | | Supportato | Supportato | Supportata |
| Cina (Pechino) | | Supportata | Supportato | Supportato | | Supportato | Supportato | Supportata |
| Cina (Ningxia) | | | Supportata | Supportato | | Supportato | Supportato | Supportata |
| Israele (Tel Aviv) | | | Supportata | Supportato | | Supportato | Supportato | Supportata |
| AWS GovCloud (Stati Uniti occidentali) | Supportata | Supportato | Supportato | Supportato | | Supportato | Supportato | Supportata |
| AWS GovCloud (Stati Uniti orientali) | | Supportata | Supportato | Supportato | | Supportato | Supportato | Supportata |
## Specifiche della classe di istanza
La tabella seguente fornisce dettagli sulle classi di istanze di Amazon DocumentDB, inclusi i tipi di istanza supportati in ciascuna classe. Puoi trovare spiegazioni su ogni colonna della tabella nella sezione sotto la tabella.
| Classe di istanza | vCPU1 | Memoria (GiB) 2 | NVMe Cache SSD su più livelli (GiB) 3 | Temperatura massima di archiviazione (GiB) 4 | Larghezza di banda base/burst (Gbps) 5 | Motori di supporto 6 |
| --- | --- | --- | --- | --- | --- | --- |
| R8G — Classe di istanza ottimizzata per la memoria di attuale generazione basata su Graviton4 R8G è la famiglia di istanze più recente (Graviton4), disponibile solo nelle versioni del motore 5.0 e 8.0. Le dimensioni db.r8g.24xlarge e db.r8g.48xlarge non sono ancora disponibili. |
| db.r8g.large | 2 | 16 | - | 30 | 0,937/12,5 | 5.0.0 e 8.0.0 |
| db.r8g.xlarge | 4 | 32 | - | 60 | 1,875/12,5 | 5.0.0 e 8.0.0 |
| db.r8g.2xlarge | 8 | 64 | - | 121 | 3,75/15,0 | 5.0.0 e 8.0.0 |
| db.r8g.4xlarge | 16 | 128 | - | 243 | 7,5/15,0 | 5.0.0 e 8.0.0 |
| db.r8g.8xlarge | 32 | 256 | - | 488 | 15 | 5.0.0 e 8.0.0 |
| db.r8g.12xlarge | 48 | 384 | - | 732 | 22 | 5.0.0 e 8.0.0 |
| db.r8g.16xlarge | 64 | 512 | - | 987 | 30 | 5.0.0 e 8.0.0 |
| R6G — Classe di istanza ottimizzata per la memoria di ultima generazione basata su Graviton2 |
| db.r6g.large | 2 | 16 | - | 32 | 0,75/10 | 4.0.0, 5.0.0 e 8.0.0 |
| db.r6g.xlarge | 4 | 32 | - | 63 | 1,25/10 | 4.0.0, 5.0.0 e 8.0.0 |
| db.r6g.2xlarge | 8 | 64 | - | 126 | 2,5/10 | 4.0.0, 5.0.0 e 8.0.0 |
| db.r6g.4xlarge | 16 | 128 | - | 252 | 5,0/10 | 4.0.0, 5.0.0 e 8.0.0 |
| db.r6g.8xlarge | 32 | 256 | - | 504 | 12 | 4.0.0, 5.0.0 e 8.0.0 |
| db.r6g.12xlarge | 48 | 384 | - | 756 | 20 | 4.0.0, 5.0.0 e 8.0.0 |
| db.r6g.16xlarge | 64 | 512 | - | 1008 | 25 | 4.0.0, 5.0.0 e 8.0.0 |
| R6GD — Classe di istanza supportata dalla generazione attuale basata su Graviton2 NVMe |
| db.r6gd.xlarge | 4 | 32 | 173 | 64 | 1,25/10 | 5.0.0 e 8.0.0 |
| db.r6gd.2xlarge | 8 | 64 | 346 | 128 | 2,5/10 | 5.0.0 e 8.0.0 |
| db.r6gd.4xlarge | 16 | 128 | 694 | 256 | 5,0/10 | 5.0.0 e 8.0.0 |
| db.r6gd.8xlarge | 32 | 256 | 1388 | 512 | 12 | 5.0.0 e 8.0.0 |
| db.r6gd.12xlarge | 48 | 384 | 2082 | 768 | 20 | 5.0.0 e 8.0.0 |
| db.r6gd.16xlarge | 64 | 512 | 2776 | 1.024 | 25 | 5.0.0 e 8.0.0 |
| R5 — Classe di istanza ottimizzata per la memoria della generazione precedente |
| db.r5.large | 2 | 16 | - | 31 | 0,75/10 | 3.6.0, 4.0.0, 5.0.0 e 8.0.0 |
| db.r5.xlarge | 4 | 32 | - | 62 | 1,25/10 | 3.6.0, 4.0.0, 5.0.0 e 8.0.0 |
| db.r5.2xlarge | 8 | 64 | - | 124 | 2,5/10 | 3.6.0, 4.0.0, 5.0.0 e 8.0.0 |
| db.r5.4xlarge | 16 | 128 | - | 249 | 5,0/10 | 3.6.0, 4.0.0, 5.0.0 e 8.0.0 |
| db.r5.8xlarge | 32 | 256 | - | 504 | 10 | 3.6.0, 4.0.0, 5.0.0 e 8.0.0 |
| db.r5.12xlarge | 48 | 384 | - | 748 | 12 | 3.6.0, 4.0.0, 5.0.0 e 8.0.0 |
| db.r5.16xlarge | 64 | 512 | - | 1008 | 20 | 3.6.0, 4.0.0, 5.0.0 e 8.0.0 |
| db.r5.24xlarge | 96 | 768 | - | 1500 | 25 | 3.6.0, 4.0.0, 5.0.0 e 8.0.0 |
| R4 — Classe di istanza ottimizzata per la memoria della generazione precedente Le istanze R4 sono supportate solo nella versione 3.6 del motore. Tieni presente che Amazon DocumentDB 3.6 raggiungerà la fine del supporto standard il 30 marzo 2026. L'Extended Support (a pagamento) è disponibile fino a marzo 2029. |
| db.r4.large | 2 | 15,25 | - | 30 | 0,75/10 | Solo 3.6.0 |
| db.r4.xlarge | 4 | 30,5 | - | 60 | 1,25/10 | Solo 3.6.0 |
| db.r4.2xlarge | 8 | 61 | - | 120 | 2.5/10 | solo 3.6.0 |
| db.r4.4xlarge | 16 | 122 | - | 240 | 5,0 /10 | solo 3.6.0 |
| db.r4.8xlarge | 32 | 244 | - | 480 | 10 | solo 3.6.0 |
| db.r4.16xlarge | 64 | 488 | - | 960 | 25 | solo 3.6.0 |
| T4G: classi di istanze Burstable Performance di ultima generazione basate su Graviton2 Le istanze della serie T funzionano in modalità Unlimited CPU burst. L'utilizzo prolungato oltre la linea di base viene fatturato a parte. Non supportato per Global Clusters. |
| db.t4g.medium | 2 | 4 | - | 8.13 | 0,256/5 | 4.0.0, 5.0.0 e 8.0.0 |
| T3: classi di istanze Burstable Performance della generazione precedente |
| db.t3.medium | 2 | 4 | - | 7.5 | 0,256/5 | 3.6.0, 4.0.0, 5.0.0 e 8.0.0 |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/db-instance-classes.html) |
# Istanze supportate da NVMe
NVMele istanze supportate da -backed offrono prestazioni di query fino a 7 volte più veloci per applicazioni con set di dati di grandi dimensioni che superano la memoria di un'istanza normale. Queste istanze sfruttano lo storage Solid-State Drive (SSD) basato su memoria non volatile locale basato su Express (NVMe) disponibile sulle istanze r6gd per archiviare dati effimeri, ridurre l'accesso allo storage basato sulla rete e migliorare la latenza di lettura e il throughput.
Lo spazio SSD locale è diviso in due sezioni:
+ **Cache a più livelli**: circa il 73% dell'SSD locale viene allocato come cache del database, il che consente al sistema di archiviare fino a cinque volte più pagine del database rispetto alla sola memoria principale. L'SSD locale funge da cache di secondo livello, mentre la cache buffer in memoria esistente rimane la cache di primo livello. La query accede alla memoria esterna solo se si verifica un errore sia nella cache buffer che nella cache SSD.
+ **Archiviazione temporanea**: il restante 27% è riservato all'archiviazione temporanea di file non persistente, utilizzata per query complesse che implicano operazioni di ordinamento o che richiedono molte risorse come la creazione di indici. Nelle istanze normali, lo spazio temporaneo risiede su un volume Amazon Elastic Block Store (EBS). Lo storage temporaneo ospitato localmente sull'SSD riduce la latenza delle query e degli ordinamenti fino a due volte e accelera le operazioni che richiedono molte risorse come la creazione di indici.
I dettagli riguardanti il tipo di istanze NVMe supportate e le relative specifiche sono disponibili in. [Specifiche della classe di istanza](db-instance-classes.md#db-instance-class-specs)
**Topics**
+ [Casi d'uso consigliati per le istanze supportate da NVMe](#nvme-use-cases)
+ [Utilizzo di istanze NVMe supportate con Amazon DocumentDB](#using-nvme)
+ [Monitoraggio delle istanze supportate da NVMe](#monitoring-nvme)
## Casi d'uso consigliati per le istanze supportate da NVMe
Ti consigliamo di utilizzare istanze NVMe supportate da backup nei seguenti scenari:
+ **Carichi di lavoro con elevata intensità di lettura**: se il carico di lavoro richiede un'intensa attività di lettura e il set di dati è più grande della cache buffer, indicata da parametri bassi `BufferCacheHitRatio` e alti, le istanze supportate da backup possono offrire vantaggi in termini di prestazioni. `ReadIOPS` NVMe
+ **Carichi di lavoro con un elevato numero di aggiornamenti: se il carico di lavoro** richiede un uso intensivo degli aggiornamenti e Garbage Collection non riesce a tenere il passo a causa della latenza di lettura sullo storage di rete, le istanze supportate da backup potrebbero contribuire a mitigare il problema. NVMe
NVMele istanze supportate da -backed possono essere utili per diversi casi d'uso, tra cui:
+ **Applicazioni su scala Internet: applicazioni** come l'elaborazione dei pagamenti, la fatturazione e il commercio elettronico con rigorosi accordi sui livelli di servizio (SLAs) possono sfruttare i vantaggi prestazionali delle istanze supportate da backup. NVMe
+ Dashboard di **reporting in tempo reale: le dashboard** che eseguono centinaia di query per la raccolta di metriche e dati possono trarre vantaggio dalla bassa latenza e dall'elevato throughput delle istanze supportate. NVMe
+ **Applicazioni AI generative: le applicazioni** che utilizzano la ricerca vettoriale per trovare i vicini esatti o più vicini in milioni di incorporamenti vettoriali possono sfruttare le elevate prestazioni delle istanze supportate. NVMe
## Utilizzo di istanze NVMe supportate con Amazon DocumentDB
Per utilizzare istanze NVMe supportate da Amazon DocumentDB:
+ Crea un cluster Amazon DocumentDB e aggiungi una delle classi di istanze NVMe supportate. Per ulteriori informazioni, consulta [Creazione di un cluster Amazon DocumentDB](db-cluster-create.md).
+ In alternativa, modifica un cluster Amazon DocumentDB esistente per utilizzare una delle classi di istanze NVMe supportate. Per ulteriori informazioni, consulta [Modifica di un cluster Amazon DocumentDB](db-cluster-modify.md).
Per verificare la disponibilità di istanze NVMe supportate da backup in diverse AWS regioni, consulta. [Classi di istanza supportate per regione](db-instance-classes.md#db-instance-classes-by-region)
Se desideri tornare da un'istanza supportata da NVMe backup a un'istanza normale, modifica la classe di istanza di database della tua istanza Amazon DocumentDB con una classe di istanza simile senza NVMe lo storage. Ad esempio, se la classe di istanza corrente è 'db.r6gd.4xlarge', scegli 'db.r6g.4xlarge' per tornare indietro. Per ulteriori informazioni, consulta [Modifica di un cluster Amazon DocumentDB](db-cluster-modify.md).
## Monitoraggio delle istanze supportate da NVMe
Oltre ai normali parametri delle istanze disponibili in Amazon CloudWatch, le istanze NVMe supportate emettono parametri aggiuntivi specifici per lo storage SSD, gli IOPS e il NVMe throughput basati su SSD.
```
NVMeStorageCacheHitRatio
FreeNVMeStorage
ReadIOPSNVMeStorage
ReadLatencyNVMeStorage
ReadThroughputNVMeStorage
WriteIOPSNVMeStorage
WriteLatencyNVMeStorage
WriteThroughputNVMeStorage
```
Per ulteriori informazioni su queste metriche, consulta [NVMe-metriche delle istanze supportate](cloud_watch.md#nvme-metrics)