As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Gerenciar instâncias do Amazon DocumentDB
Os tópicos a seguir fornecem informações para ajudar a gerenciar as instâncias do Amazon DocumentDB. Eles incluem detalhes sobre classes e status de instâncias e como criar, excluir e modificar uma instância.
**Topics**
+ [Determinar o status de uma instância](#db-instance-status)
+ [Ciclo de vida da instância](db-instance-life-cycle.md)
+ [Gerenciar classes de instância](db-instance-classes.md)
+ [Instâncias baseadas em NVMe](db-instance-nvme.md)
## Determinar o status de uma instância
Para ver os status válidos da instância, seus significados e como determinar o status de suas instâncias, consulte [Monitoramento do status de uma instância do Amazon DocumentDB](monitoring_docdb-instance_status.md).
# Ciclo de vida da instância do Amazon DocumentDB
O ciclo de vida de uma instância do Amazon DocumentDB inclui a criação, a modificação, a manutenção e a atualização, a realização de backups e restaurações, a reinicialização e a exclusão dessa instância. Esta seção fornece informações sobre como concluir esses processos.
**Topics**
+ [Adicionar uma instância](db-instance-add.md)
+ [Descrever instâncias](db-instance-view-details.md)
+ [Modificar uma instância](db-instance-modify.md)
+ [Reinicializar uma instância](db-instance-reboot.md)
+ [Excluir uma instância](db-instance-delete.md)
Você pode criar uma nova instância do Amazon DocumentDB usando o Console de gerenciamento da AWS ou o. AWS CLI Para adicionar uma instância a um cluster, o cluster deve estar no estado *disponível*. Não é possível adicionar uma instância a um cluster que foi interrompido. Se o cluster foi interrompido, primeiro inicie-o, aguarde até que fique *disponível* e adicione uma instância. Para obter mais informações, consulte [Interromper e iniciar um cluster do Amazon DocumentDB](db-cluster-stop-start.md).
**nota**
Se você criar um cluster do Amazon DocumentDB usando o console, uma instância será criada automaticamente para você ao mesmo tempo. Se você deseja criar instâncias adicionais, use um dos procedimentos a seguir.
# Adicionar uma instância do Amazon DocumentDB a um cluster
------
#### [ Using the Console de gerenciamento da AWS ]
Use o procedimento a seguir para criar uma instância para o cluster usando o console do Amazon DocumentDB.
1. [Faça login no e abra Console de gerenciamento da AWS o console do Amazon DocumentDB em https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. No painel de navegação, escolha **Clusters**.
**dica**
Caso não visualize o painel de navegação à esquerda da tela, selecione o ícone do menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/docdb-menu-icon.png)) no canto superior esquerdo da página.
1. Para escolher o cluster ao qual você deseja adicionar uma instância, selecione o botão à esquerda do nome do cluster.
1. Escolha **Ações** e escolha **Adicionar instâncias**.
1. Na página **Adicionar instância a: **, repita as etapas a seguir para cada instância a ser adicionada ao cluster. É possível ter até 15.
1. **Identificador da instância**: você pode inserir um identificador exclusivo para essa instância ou permitir que o Amazon DocumentDB forneça o identificador da instância com base no identificador do cluster.
Restrições de nomenclatura da instância:
+ O comprimento é de [1 a 63] letras, números ou hífens.
+ O primeiro caractere deve ser uma letra.
+ Não pode terminar com um hífen ou conter dois hifens consecutivos.
+ Deve ser exclusivo para todas as instâncias do Amazon RDS, Neptune e Amazon DocumentDB por região. Conta da AWS
1. **Classe da instância**: na lista suspensa, escolha o tipo de instância desejado para essa instância.
1. **Nível de promoção**: na lista suspensa, escolha o nível de promoção da instância ou selecione *Nenhuma preferência* para permitir que o Amazon DocumentDB defina o nível de promoção para a instância. Números mais baixos significam maior prioridade. Para obter mais informações, consulte [Controlar o destino de failover](failover.md#failover-target_control).
1. Para adicionar mais instâncias, escolha **Adicionar outras instâncias** e repita as etapas a, b e c.
1. Conclua a operação.
+ Para adicionar instâncias ao seu cluster, escolha **Criar**.
+ Para cancelar a operação, escolha **Cancelar**.
Leva alguns minutos para criar uma instância. Você pode usar o console ou AWS CLI visualizar o status da instância. Para obter mais informações, consulte [Monitorar o status de uma instância](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS CLI ]
Use a `create-db-instance` AWS CLI operação com os parâmetros a seguir para criar a instância primária para seu cluster.
+ **--db-instance-class** — Obrigatório. A capacidade de computação e memória da instância, por exemplo, `db.m4.large`. Nem todas as classes de instâncias estão disponíveis em todas as Regiões da AWS.
+ **--db-instance-identifier** — Obrigatório. Uma string que identifica a instância.
Restrições de nomenclatura da instância:
+ O comprimento é de [1 a 63] letras, números ou hífens.
+ O primeiro caractere deve ser uma letra.
+ Não pode terminar com um hífen ou conter dois hifens consecutivos.
+ Deve ser exclusivo para todas as instâncias do Amazon RDS, Neptune e Amazon DocumentDB por região. Conta da AWS
+ **--engine** — Obrigatório. Deve ser `docdb`.
+ **--availability-zone** — Opcional. A zona de disponibilidade na qual você deseja que essa instância seja criada. Use esse parâmetro para localizar suas instâncias em diferentes zonas de disponibilidade para aumentar a tolerância a falhas. Para obter mais informações, consulte [Alta disponibilidade e replicação do Amazon DocumentDB](replication.md).
+ **--promotion-tier** — Opcional. O nível de prioridade de failover dessa instância. Deve estar entre 0 e 15, com números mais baixos sendo prioridade mais alta. Para obter mais informações, consulte [Controlar o destino de failover](failover.md#failover-target_control).
1. **Primeiro, determine em quais zonas de disponibilidade você pode criar a instância. **
Se quiser especificar a zona de disponibilidade antes de criar a instância, execute o seguinte comando para determinar quais zonas de disponibilidade estão disponíveis para o cluster do Amazon DocumentDB.
Para Linux, macOS ou Unix:
```
aws docdb describe-db-clusters \
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
Para Windows:
```
aws docdb describe-db-clusters ^
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
A saída dessa operação é semelhante à seguinte.
```
[
[
"sample-cluster",
[
"us-east-1c",
"us-east-1b",
"us-east-1a"
]
]
]
```
1. **Segundo, determine quais classes de instância você pode criar na região. **
Para determinar quais classes de instância estão disponíveis na sua região, execute o seguinte comando. Na saída, escolha uma classe de instância para a instância que deseja adicionar ao cluster do Amazon DocumentDB.
Para Linux, macOS ou Unix:
```
aws docdb describe-orderable-db-instance-options \
--engine docdb \
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
Para Windows:
```
aws docdb describe-orderable-db-instance-options ^
--engine docdb ^
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
A saída dessa operação é semelhante à seguinte.
```
[
"db.r5.16xlarge",
"db.r5.2xlarge",
"db.r5.4xlarge",
"db.r5.8xlarge",
"db.r5.large",
"db.r5.xlarge"
]
```
1. **Por último, adicione uma instância ao cluster do Amazon DocumentDB.**
Para adicionar uma instância ao cluster do Amazon DocumentDB, execute o seguinte comando.
Para Linux, macOS ou 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
```
Para 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
```
A saída dessa operação é semelhante à seguinte.
```
{
"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"
}
}
```
Leva alguns minutos para criar a instância. Você pode usar o console ou AWS CLI visualizar o status da instância. Para obter mais informações, consulte [Monitoramento do status de uma instância do Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
# Descrever instâncias do Amazon DocumentDB
Você pode usar o Amazon DocumentDB Management Console ou o AWS CLI para ver detalhes como endpoints de conexão, grupos de segurança, autoridade de certificação e grupos VPCs de parâmetros relacionados às suas instâncias do Amazon DocumentDB.
------
#### [ Using the Console de gerenciamento da AWS ]
Para visualizar os detalhes de suas instâncias usando o Console de gerenciamento da AWS, siga as etapas abaixo.
1. [Faça login no e abra Console de gerenciamento da AWS o console do Amazon DocumentDB em https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. No painel de navegação, escolha **Clusters**.
**dica**
Caso não visualize o painel de navegação à esquerda da tela, selecione o ícone do menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/docdb-menu-icon.png)) no canto superior esquerdo da página.
1. Na caixa de navegação Clusters, você verá a coluna **Identificador do Cluster**. Suas instâncias estão listadas em clusters, semelhante ao snapshot abaixo.
![\[Tabela de clusters mostrando a lista de clusters na coluna Identificador de cluster, com instâncias aninhadas dentro de clusters.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/choose-clusters.png)
1. Na lista de instâncias, escolha o nome da instância da qual você deseja ver os detalhes. As informações sobre a instância são organizadas nos seguintes agrupamentos:
+ **Resumo**: informações gerais sobre a instância, incluindo a versão do mecanismo, a classe, o status e todas as manutenções pendentes.
+ **Conectividade e segurança**: a seção **Conecte-se** lista os endpoints de conexão para se conectar a essa instância com o shell do mongo ou com uma aplicação. A seção **Grupos de segurança** lista os grupos de segurança associados a essa instância e suas descrições e ID da VPC.
+ **Configuração**: a seção **Detalhes** lista as configurações e o status da instância, incluindo o nome do recurso da Amazon (ARN), o endpoint, o perfil, a classe e a autoridade certificadora da instância. Ela também lista as configurações de segurança e de rede da instância e as informações de backup. A seção **Detalhes do cluster** lista os detalhes do cluster ao qual essa instância pertence. A seção **Instâncias de cluster** lista todas as instâncias que pertencem ao cluster com cada função e status de grupo de parâmetros de cluster de cada instância.
**nota**
É possível modificar o cluster associado à sua instância selecionando **Modificar** ao lado do cabeçalho **Detalhes do cluster**. Para obter mais informações, consulte [Modificar um cluster do Amazon DocumentDB](db-cluster-modify.md).
+ **Monitoramento** — as métricas de CloudWatch registros dessa instância. Para obter mais informações, consulte [Monitorando o Amazon DocumentDB com CloudWatch](cloud_watch.md).
+ **Eventos e tags**: a seção **Eventos recentes** lista os eventos recentes dessa instância. O Amazon DocumentDB mantém um registro de eventos que se relacionam a seus clusters, instâncias, snapshots, grupos de segurança e grupos de parâmetros do cluster. Essas informações incluem a data, a hora e a mensagem associadas a cada evento. A seção **Tags** lista as tags anexadas a este cluster. Para obter mais informações, consulte [Marcação de recursos do Amazon DocumentDB](tagging.md).
------
#### [ Using the AWS CLI ]
Para visualizar os detalhes de suas instâncias do Amazon DocumentDB usando o AWS CLI, use o `describe-db-clusters` comando conforme mostrado nos exemplos abaixo. Para obter mais informações, consulte [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html) na *Referência de API para gerenciamento de recursos do Amazon DocumentDB*.
**nota**
Para determinados atributos de gerenciamento, como o gerenciamento do ciclo de vida de cluster e instâncias, o Amazon DocumentDB aproveita a tecnologia operacional compartilhada com o Amazon RDS. O parâmetro de filtro `filterName=engine,Values=docdb` só retorna clusters do Amazon DocumentDB.
1. **Liste todas as instâncias do Amazon DocumentDB.**
O AWS CLI código a seguir lista os detalhes de todas as instâncias do Amazon DocumentDB em uma região.
Para Linux, macOS ou Unix:
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
Para Windows:
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
1. **Listar todos os detalhes de uma instância especificada do Amazon DocumentDB**
O código a seguir lista os detalhes para `sample-cluster-instance`. Incluir o parâmetro `--db-instance-identifier` com o nome de uma instância restringe a saída às informações sobre essa instância específica.
Para Linux, macOS ou Unix:
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
Para Windows:
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
A saída dessa operação é semelhante à seguinte.
```
{
"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"
}
]
}
```
------
# Modificar uma instância do Amazon DocumentDB
Você pode modificar sua instância do Amazon DocumentDB usando o Console de gerenciamento da AWS ou o. AWS CLI Para modificar uma instância, ela deve estar no estado *disponível*. Você não pode modificar uma instância que foi interrompida. Se o cluster foi interrompido, primeiro inicie-o, aguarde até que a instância fique *disponível* e faça as modificações desejadas. Para obter mais informações, consulte [Interromper e iniciar um cluster do Amazon DocumentDB](db-cluster-stop-start.md).
------
#### [ Using the Console de gerenciamento da AWS ]
Para modificar uma instância específica do Amazon DocumentDB usando o console, siga as etapas a seguir.
1. [Faça login no e abra Console de gerenciamento da AWS o console do Amazon DocumentDB em https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. No painel de navegação, escolha **Clusters**.
**dica**
Caso não visualize o painel de navegação à esquerda da tela, selecione o ícone do menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/docdb-menu-icon.png)) no canto superior esquerdo da página.
1. Na caixa de navegação Clusters, você verá a coluna **Identificador do Cluster**. Suas instâncias estão listadas em clusters, semelhante ao snapshot abaixo.
![\[Tabela de clusters mostrando a lista de clusters na coluna Identificador de cluster, com instâncias aninhadas dentro de clusters.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/choose-clusters.png)
1. Marque a caixa à esquerda da instância que você deseja modificar.
1. Escolha **Ações** e, em seguida, **Modificar**.
1. No painel **Modificar instância: **, faça as alterações desejadas. É possível fazer as alterações a seguir:
+ **Especificações da instância**: o identificador e a classe da instância. Restrições de nomenclatura de identificador de instância:
+ **Identificador da instância** — insira um nome exclusivo para todas as instâncias de sua propriedade Conta da AWS na região atual. O identificador da instância deve conter [1 a 63] caracteres alfanuméricos ou hifens, ter uma letra como primeiro caractere e não pode terminar com um hífen nem conter dois hifens consecutivos.
+ **Classe de instância**: no menu suspenso, selecione uma classe de instância para sua instância do Amazon DocumentDB. Para obter mais informações, consulte [Gerenciar classes de instância](db-instance-classes.md).
+ **Autoridade de certificação**: certificado do servidor para essa instância. Para obter mais informações, consulte [Atualizar seus certificados TLS do Amazon DocumentDB](ca_cert_rotation.md).
+ **Failover**: durante o failover, a instância com o nível de promoção mais alto será promovida para primária. Para obter mais informações, consulte [Failover do Amazon DocumentDB](failover.md).
+ **Manutenção**: a janela de manutenção na qual modificações ou patches pendentes são aplicados às instâncias no cluster.
1. Ao concluir, escolha **Continuar** para ver um resumo das alterações.
1. Depois de verificar suas alterações, é possível aplicá-las imediatamente, ou durante a próxima janela de manutenção em **Programação de modificações**. Selecione **Modificar instância** para salvar as alterações. Como alternativa, você pode escolher **Cancelar** para descartar as alterações.
Levará alguns minutos para que suas alterações sejam aplicadas. É possível usar a instância somente quando seu status for *disponível*. É possível monitorar o status da instância usando o console ou a AWS CLI. Para obter mais informações, consulte [Monitoramento do status de uma instância do Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS CLI ]
Para modificar uma instância específica do Amazon DocumentDB usando o AWS CLI, use o `modify-db-instance` com os seguintes parâmetros. Para obter mais informações, consulte [Modificar DBInstance](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBInstance.html). O código a seguir modifica a classe de instância para `db.r5.large` para a instância `sample-instance`.
**Parâmetros**
+ **--db-instance-identifier** — Obrigatório. O identificador da instância a ser modificada.
+ **--db-instance-class** — Opcional. A nova capacidade de computação e memória da instância. Por exemplo, `db.r5.large`. Nem todas as classes de instância estão disponíveis em todos os Regiões da AWS. Se você modificar a classe da instância, ocorrerá uma interrupção durante a alteração. A alteração será aplicada durante a próxima janela de manutenção, a menos que `ApplyImmediately` seja especificado como verdadeiro para essa solicitação.
+ **--apply-immediately** ou **--no-apply-immediately**: opcional. Especifica se essa modificação deve ser aplicada imediatamente ou se deve aguardar até a próxima janela de manutenção. Se esse parâmetro for omitido, a modificação será executada durante a próxima janela de manutenção.
**Example**
Para Linux, macOS ou Unix:
```
aws docdb modify-db-instance \
--db-instance-identifier sample-instance \
--db-instance-class db.r5.large \
--apply-immediately
```
Para Windows:
```
aws docdb modify-db-instance ^
--db-instance-identifier sample-instance ^
--db-instance-class db.r5.large ^
--apply-immediately
```
A saída dessa operação é semelhante à seguinte.
```
{
"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"
]
}
]
}
```
Leva alguns minutos para que suas modificações sejam aplicadas. É possível usar a instância somente quando seu status for *disponível*. Você pode monitorar o status da instância usando o Console de gerenciamento da AWS ou AWS CLI. Para obter mais informações, consulte [Monitoramento do status de uma instância do Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
# Reinicializar uma instância do Amazon DocumentDB
Ocasionalmente, você pode precisar reinicializar sua instância do Amazon DocumentDB, geralmente por motivos de manutenção. Se você fizer determinadas alterações, como alterar o grupo de parâmetros de cluster associado a um cluster, será necessário reinicializar as instâncias no cluster para que as alterações sejam implantadas. Você pode reinicializar uma instância específica usando o Console de gerenciamento da AWS ou o. AWS CLI
Reinicializar uma instância reinicia o serviço de mecanismo de banco de dados. A reinicialização resulta em uma interrupção momentânea, durante a qual o status da instância é definido como `rebooting`. Um evento do Amazon DocumentDB é criado quando a reinicialização é concluída.
A reinicialização de uma instância não resulta em um failover. Para fazer o failover de um cluster do Amazon DocumentDB, use Console de gerenciamento da AWS a ou AWS CLI a operação. `failover-db-cluster` Para obter mais informações, consulte [Failover do Amazon DocumentDB](failover.md).
Você não poderá reinicializar sua instância se ela não estiver no estado *disponível*. Seu banco de dados pode se tornar indisponível por vários motivos, como uma modificação solicitada anteriormente ou uma ação no intervalo de manutenção. Para obter mais informações sobre os estados da instância, consulte [Monitoramento do status de uma instância do Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
#### [ Using the Console de gerenciamento da AWS ]
O procedimento a seguir reinicializa uma instância especificada usando o console.
1. [Faça login no e abra Console de gerenciamento da AWS o console do Amazon DocumentDB em https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. No painel de navegação, escolha **Clusters**.
**dica**
Caso não visualize o painel de navegação à esquerda da tela, selecione o ícone do menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/docdb-menu-icon.png)) no canto superior esquerdo da página.
1. Na caixa de navegação Clusters, você verá a coluna **Identificador do Cluster**. Suas instâncias estão listadas em clusters, semelhante ao snapshot abaixo.
![\[Tabela de clusters mostrando a lista de clusters na coluna Identificador de cluster, com instâncias aninhadas dentro de clusters.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/choose-clusters.png)
1. Marque a caixa à esquerda da instância que você deseja reinicializar.
1. Escolha **Ações**, escolha **Reinicializar** e depois **Reinicializar** para confirmar a reinicialização.
Demora alguns minutos para sua instância reinicializar. É possível usar a instância somente quando seu status for *disponível*. É possível monitorar o status da instância usando o console ou a AWS CLI. Para obter mais informações, consulte [Monitoramento do status de uma instância do Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS CLI ]
Para reinicializar uma instância do Amazon DocumentDB, use a operação `reboot-db-instance` com o parâmetro `--db-instance-identifier`. Esse parâmetro especifica o identificador da instância a ser reinicializada.
O código a seguir reinicializa a instância `sample-instance`.
**Example**
Para Linux, macOS ou Unix:
```
aws docdb reboot-db-instance \
--db-instance-identifier sample-instance
```
Para Windows:
```
aws docdb reboot-db-instance ^
--db-instance-identifier sample-instance
```
A saída dessa operação é semelhante à seguinte.
```
{
"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"
]
}
}
```
Demora alguns minutos para sua instância reinicializar. É possível usar a instância somente quando seu status for *disponível*. É possível monitorar o status da instância usando o console ou a AWS CLI. Para obter mais informações, consulte [Monitoramento do status de uma instância do Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
# Excluir uma instância do Amazon DocumentDB
Você pode excluir sua instância do Amazon DocumentDB usando o Console de gerenciamento da AWS ou o. AWS CLI Para excluir uma instância, ela deve estar no estado *disponível*. Você não pode excluir uma instância que foi interrompida. Se o cluster do Amazon DocumentDB que contém a instância for interrompido, primeiro inicie o cluster, aguarde até que a instância fique *disponível* e, depois, exclua-a. Para obter mais informações, consulte [Interromper e iniciar um cluster do Amazon DocumentDB](db-cluster-stop-start.md).
**nota**
O Amazon DocumentDB armazena todos os dados no volume do cluster. Os dados persistem nesse volume de cluster, mesmo se você remover todas as instâncias do cluster. Se precisar acessar os dados novamente, adicione uma instância ao cluster a qualquer momento e continue de onde parou.
------
#### [ Using the Console de gerenciamento da AWS ]
O procedimento a seguir excluir uma instância do Amazon DocumentDB especificada usando o console.
1. [Faça login no e abra Console de gerenciamento da AWS o console do Amazon DocumentDB em https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. No painel de navegação, escolha **Clusters**.
**dica**
Caso não visualize o painel de navegação à esquerda da tela, selecione o ícone do menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/docdb-menu-icon.png)) no canto superior esquerdo da página.
1. Na caixa de navegação Clusters, você verá a coluna **Identificador do Cluster**. Suas instâncias estão listadas em clusters, semelhante ao snapshot abaixo.
![\[Tabela de clusters mostrando a lista de clusters na coluna Identificador de cluster, com instâncias aninhadas dentro de clusters.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/choose-clusters.png)
1. Marque a caixa à esquerda da instância que você deseja excluir.
1. Selecione **Ações** e escolha **Excluir**.
1. Se você estiver excluindo a última instância no cluster:
+ **Criar snapshot final do cluster?** — Escolha **Sim** se você quiser criar um snapshot final antes do cluster ser excluído. Caso contrário, escolha **Não**.
+ **Nome do snapshot final**: se você escolher criar um snapshot final, insira o identificador do novo snapshot do cluster.
+ **Excluir instância ?** — Insira a frase **excluir cluster inteiro** no campo para confirmar a exclusão.
1. Se você não estiver excluindo a última instância no cluster:
+ **Excluir instância ?** — Insira a frase **exclua-me** no campo para confirmar a exclusão.
1. Selecione **Excluir** para excluir a instância.
Leva alguns minutos para uma instância ser excluída. Para monitorar o status de uma instância, consulte [Monitoramento do status de uma instância do Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS CLI ]
O procedimento a seguir exclui uma instância do Amazon DocumentDB usando a AWS CLI.
1. **Primeiro, determine quantas instâncias estão no cluster do Amazon DocumentDB:**
Para determinar quantas instâncias estão no cluster, execute o comando `describe-db-clusters` da seguinte forma.
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]'
```
A saída dessa operação é semelhante à seguinte.
```
[
[
"sample-cluster",
[
"sample-instance-1",
"sample-instance-2"
]
]
]
```
1. **Se houver mais de uma instância no cluster do Amazon DocumentDB:**
Para excluir uma instância do Amazon DocumentDB especificada, use o comando `delete-db-instance` com o parâmetro `--db-instance-identifier`, conforme mostrado abaixo. Leva alguns minutos para uma instância ser excluída. Para monitorar o status de uma instância, consulte [Monitoramento do status de uma instância do Amazon DocumentDB](monitoring_docdb-instance_status.md).
```
aws docdb delete-db-instance \
--db-instance-identifier sample-instance-2
```
A saída dessa operação é semelhante à seguinte.
```
{
"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 a instância que deseja excluir for a última instância no cluster do Amazon DocumentDB: **
Se você excluir a última instância em um cluster do Amazon DocumentDB, você também excluirá esse cluster e os snapshots automáticos e backups contínuos associados a ele.
Para excluir a última instância no cluster, é possível excluí-lo e opcionalmente criar um snapshot final. Para obter mais informações, consulte [Excluir um cluster do Amazon DocumentDB](db-cluster-delete.md).
------
## Proteção contra exclusão
A exclusão da última instância em um cluster do Amazon DocumentDB também excluirá o cluster, os snapshots automáticos e os backups contínuos associados a ele. O Amazon DocumentDB impõe proteção contra exclusão para um cluster, independentemente de você realizar a operação de exclusão usando o. ou o. Console de gerenciamento da AWS AWS CLI Se a proteção contra exclusão estiver habilitada, não será possível excluir um cluster.
Para excluir um cluster com a projeção contra exclusão habilitada, primeiro é necessário modificar o cluster e desabilitar a proteção contra exclusão. Para obter mais informações, consulte [Excluir um cluster do Amazon DocumentDB](db-cluster-delete.md).
# Gerenciar classes de instância
A classe de instância determina a capacidade de computação e de memória de uma instância do Amazon DocumentDB (compativel com MongoDB). A classe de instância da qual você precisa depende dos requisitos de energia e memória de processamento.
O Amazon DocumentDB oferece suporte às famílias de classes de instância R4, R5, R6G, R8G, T3 e T4G. Essas classes são de instâncias da geração atual que são otimizadas para aplicações com uso intensivo de memória. Para obter as especificações dessas classes, consulte [Especificações de classe de instância](#db-instance-class-specs).
**Topics**
+ [Determinar uma classe de instância](#db-instance-class-determining)
+ [Alterar a classe de uma instância](#db-instance-class-changing)
+ [Classes de instância compatíveis por região](#db-instance-classes-by-region)
+ [Especificações de classe de instância](#db-instance-class-specs)
## Determinar uma classe de instância
Para determinar a classe de uma instância, você pode usar a `describe-db-instances` AWS CLI operação Console de gerenciamento da AWS ou a.
------
#### [ Using the Console de gerenciamento da AWS ]
Para determinar a classe de instância para as instâncias do seu cluster, execute as etapas a seguir no console.
1. [Faça login no e abra Console de gerenciamento da AWS o console do Amazon DocumentDB em https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. No painel de navegação, escolha **Clusters** para encontrar a instância do seu interesse.
**dica**
Caso não visualize o painel de navegação à esquerda da tela, selecione o ícone do menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/docdb-menu-icon.png)) no canto superior esquerdo da página.
1. Na caixa de navegação Clusters, você verá a coluna **Identificador do Cluster**. Suas instâncias estão listadas em clusters, semelhante ao snapshot abaixo.
![\[Tabela de clusters mostrando como uma instância está aninhada sob um cluster.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/choose-clusters.png)
1. Na lista de instâncias, expanda o cluster para encontrar as instâncias de seu interesse. Encontre a instância desejada. Em seguida, verifique a coluna **Tamanho** da linha da instância para visualizar a classe de instância.
Na imagem a seguir, a classe da instância `robo3t` é `db.r5.4xlarge`.
![\[Lista de instâncias na tabela Clusters com a coluna Tamanho mostrando o tipo de instância.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/instance-class.png)
------
#### [ Using the AWS CLI ]
Para determinar a classe de uma instância usando o AWS CLI, use a `describe-db-instances` operação com os parâmetros a seguir.
+ **--db-instance-identifier**: opcional. Especifica a instância para a qual você deseja localizar a classe da instância. Se o parâmetro for omitido, `describe-db-instances` retornará uma descrição para até 100 das suas instâncias.
+ **--query**: opcional. Especifica os membros da instância a serem incluídos nos resultados. Se esse parâmetro for omitido, todos os membros da instância serão retornados.
**Example**
O exemplo a seguir localiza o nome e a classe da instância para a instância `sample-instance-1`.
Para Linux, macOS ou Unix:
```
aws docdb describe-db-instances \
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' \
--db-instance-identifier sample-instance-1
```
Para Windows:
```
aws docdb describe-db-instances ^
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' ^
--db-instance-identifier sample-instance-1
```
A saída dessa operação é semelhante à seguinte.
```
[
[
"sample-instance-1",
"db.r5.large"
]
```
**Example**
O exemplo a seguir localiza o nome e a classe de até 100 instâncias do Amazon DocumentDB.
Para Linux, macOS ou Unix:
```
aws docdb describe-db-instances \
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' \
--filter Name=engine,Values=docdb
```
Para Windows:
```
aws docdb describe-db-instances ^
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' ^
--filter Name=engine,Values=docdb
```
A saída dessa operação é semelhante à seguinte.
```
[
[
"sample-instance-1",
"db.r5.large"
],
[
"sample-instance-2",
"db.r5.large"
],
[
"sample-instance-3",
"db.r5.4xlarge"
],
[
"sample-instance-4",
"db.r5.4xlarge"
]
]
```
Para obter mais informações, consulte [Descrever instâncias do Amazon DocumentDB](db-instance-view-details.md).
------
## Alterar a classe de uma instância
Você pode alterar a classe da instância usando o Console de gerenciamento da AWS ou AWS CLI o. Para obter mais informações, consulte [Modificar uma instância do Amazon DocumentDB](db-instance-modify.md).
## Classes de instância compatíveis por região
O Amazon DocumentDB é compatível com as classes de instância a seguir:
+ `R8G`—A última geração de instâncias otimizadas para memória com processadores AWS Graviton4 baseados em ARM que oferecem desempenho até 30% melhor do que as instâncias R6G.
+ `R6G`—Instâncias otimizadas para memória baseadas em processadores AWS Graviton2 baseados em ARM que oferecem desempenho até 30% melhor em relação às instâncias R5 a um custo 5% menor.
+ `R6GD`—Instâncias R6G otimizadas para memória com armazenamento local de unidade de estado sólido (SSDNVMe) baseado em memória expressa () não volátil para dados efêmeros.
+ `R5`: instâncias otimizadas para memória que oferecem desempenho até 100% melhor em relação às instâncias R4 pelo mesmo custo de instância.
+ `R4`: geração anterior de instâncias otimizadas para memória.
+ `T4G`— Tipo de instância de uso geral intermitente e de baixo custo de última geração, alimentada por processadores AWS Graviton2 baseados em ARM, que fornece um nível básico de desempenho de CPU, oferecendo um desempenho de preço até 35% melhor em relação às instâncias T3 e ideal para executar aplicativos com uso moderado de CPU que apresentam picos temporários no uso.
+ `T3`: instância de uso geral de baixo custo com capacidade de expansão que fornecem um nível de linha de base de performance de CPU com a capacidade de expansão para uso de CPU a qualquer momento e pelo tempo necessário.
Para obter especificações dessas classes de instância, consulte [Especificações de classe de instância](#db-instance-class-specs).
**nota**
O armazenamento otimizado para E/S só está disponível nas versões 5.0 e 8.0 do mecanismo (clusters baseados em instâncias).
Uma classe de instância específica pode ou não ser compatível em uma região. A tabela a seguir especifica quais classes de instância são compatíveis com o Amazon DocumentDB em cada região.
**Classes de instância compatíveis por região**
| | Classes de instância | Região | R8G | R6GD | R6G | R5 | R4 | T4G | T3 | Sem servidor |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| Leste dos EUA (Ohio) | Compatível | Compatível | Compatível | Compatível | Compatível | Compatível | Compatível | Compatível |
| Leste dos EUA (Norte da Virgínia) | Compatível | Compatível | Compatível | Compatível | Compatível | Compatível | Compatível | Compatível |
| Oeste dos EUA (Oregon) | Compatível | Compatível | Compatível | Compatível | Compatível | Compatível | Compatível | Compatível |
| África (Cidade do Cabo) | | | Compatível | Compatível | | Compatível | Compatível | Compatível |
| América do Sul (São Paulo) | | Compatível | Compatível | Compatível | | Compatível | Compatível | Compatível |
| Ásia-Pacífico (Hong Kong) | | | Compatível | Compatível | | Compatível | Compatível | Compatível |
| Ásia-Pacífico (Hyderabad) | | | Compatível | Compatível | | Compatível | Compatível | Compatível |
| Ásia-Pacífico (Malásia) | | | Compatível | | | Compatível | Compatível | |
| Ásia-Pacífico (Mumbai) | Compatível | Compatível | Compatível | Compatível | | Compatível | Compatível | Compatível |
| Ásia-Pacífico (Osaka) | | Compatível | Compatível | Compatível | | Compatível | Compatível | |
| Ásia-Pacífico (Seul) | Compatível | Compatível | Compatível | Compatível | | Compatível | Compatível | Compatível |
| Ásia-Pacífico (Sydney) | Compatível | Compatível | Compatível | Compatível | | Compatível | Compatível | Compatível |
| Ásia-Pacífico (Jacarta) | Compatível | Compatível | Compatível | Compatível | | Compatível | Compatível | |
| Ásia-Pacífico (Melbourne) | | | Compatível | Compatível | | Compatível | Compatível | |
| Ásia-Pacífico (Singapura) | Compatível | Compatível | Compatível | Compatível | | Compatível | Compatível | Compatível |
| Ásia-Pacífico (Tailândia) | | | Compatível | | | Compatível | Compatível | |
| Ásia-Pacífico (Tóquio) | Compatível | Compatível | Compatível | Compatível | | Compatível | Compatível | Compatível |
| Canadá (Central) | | Compatível | Compatível | Compatível | | Compatível | Compatível | Compatível |
| Europa (Frankfurt) | Compatível | Compatível | Compatível | Compatível | | Compatível | Compatível | Compatível |
| Europa (Zurique) | | Compatível | Compatível | Compatível | | Compatível | Compatível | |
| Europa (Irlanda) | Compatível | Compatível | Compatível | Compatível | Compatível | Compatível | Compatível | Compatível |
| Europa (Londres) | | Compatível | Compatível | Compatível | | Compatível | Compatível | Compatível |
| Europa (Milão) | | | Compatível | Compatível | | Compatível | Compatível | Compatível |
| Europa (Paris) | | Compatível | Compatível | Compatível | | Compatível | Compatível | Compatível |
| Europa (Espanha) | Compatível | Compatível | Compatível | Compatível | | Compatível | Compatível | Compatível |
| Europa (Estocolmo) | Compatível | Compatível | Compatível | Compatível | | Compatível | Compatível | |
| México (Centro) | | | Compatível | | | Compatível | Compatível | |
| Oriente Médio (Emirados Árabes Unidos) | | | Compatível | Compatível | | Compatível | Compatível | Compatível |
| China (Pequim) | | Compatível | Compatível | Compatível | | Compatível | Compatível | Compatível |
| China (Ningxia) | | | Compatível | Compatível | | Compatível | Compatível | Compatível |
| Israel (Tel Aviv) | | | Compatível | Compatível | | Compatível | Compatível | Compatível |
| AWS GovCloud (Oeste dos EUA) | Compatível | Compatível | Compatível | Compatível | | Compatível | Compatível | Compatível |
| AWS GovCloud (Leste dos EUA) | | Compatível | Compatível | Compatível | | Compatível | Compatível | Compatível |
## Especificações de classe de instância
A tabela a seguir fornece detalhes das classes de instância do Amazon DocumentDB, incluindo quais tipos de instância são aceitos em cada classe. É possível encontrar explicações para cada coluna da tabela abaixo da tabela.
| Classe de instância | vCPU1 | Memória (GiB)2 | NVMe Cache SSD em camadas (GiB) 3 | Temperatura máxima de armazenamento (GiB) 4 | Largura de banda de linha de base / rajada (Gbps) 5 | Motores de apoio 6 |
| --- | --- | --- | --- | --- | --- | --- |
| R8G — Classe de instância otimizada para memória da geração atual com base no Graviton4 O R8G é a mais nova família de instâncias (Graviton4), disponível somente nas versões 5.0 e 8.0 do motor. Os tamanhos db.r8g.24xlarge e db.r8g.48xlarge ainda não estão disponíveis. |
| 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 de instância otimizada para memória da geração atual com base no 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 de instância NVMe suportada pela geração atual baseada em Graviton2 |
| 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 | 1024 | 25 | 5.0.0 e 8.0.0 |
| R5: classes de instância da geração anterior otimizadas para memória |
| 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: classes de instância da geração anterior otimizadas para memória As instâncias R4 só são compatíveis com a versão 3.6 do mecanismo. Observe que o Amazon DocumentDB 3.6 chega ao fim do suporte padrão em 30 de março de 2026. O Extended Support (pago) está disponível até março de 2029. |
| db.r4.large | 2 | 15.25 | - | 30 | 0,75/10 | 3.6.0 somente |
| db.r4.xlarge | 4 | 30.5 | - | 60 | 1,25/10 | 3.6.0 somente |
| db.r4.2xlarge | 8 | 61 | - | 120 | 2,5/10 | 3.6.0 somente |
| db.r4.4xlarge | 16 | 122 | - | 240 | 5,0/10 | 3.6.0 somente |
| db.r4.8xlarge | 32 | 244 | - | 480 | 10 | 3.6.0 somente |
| db.r4.16xlarge | 64 | 488 | - | 960 | 25 | 3.6.0 somente |
| T4G: classes de instância de desempenho expansível de última geração com base no Graviton2 As instâncias da série T são executadas no modo de intermitência ilimitada de CPU. O uso contínuo além da linha de base é cobrado extra. Não há suporte para clusters globais. |
| db.t4g.medium | 2 | 4 | - | 8.13 | 0,256/5 | 4.0.0, 5.0.0 e 8.0.0 |
| T3: classes de instância de desempenho expansível de geração anterior |
| 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/pt_br/documentdb/latest/developerguide/db-instance-classes.html) |
# Instâncias baseadas em NVMe
As instâncias baseadas em NVMe oferecem performance de consulta até 7 vezes mais rápida para aplicações com grandes conjuntos de dados que excedem a memória de uma instância comum. Essas instâncias utilizam o armazenamento local de unidade de estado sólido (SSD) baseado em memória não volátil expressa (NVMe) disponível em instâncias r6gd para armazenar dados efêmeros, reduzir o acesso ao armazenamento baseado em rede e melhorar a latência de leitura e throughput.
O espaço em SSD local é dividido em duas seções:
+ **Cache hierárquico**: aproximadamente 73% do SSD local é alocado como cache de banco de dados, permitindo que o sistema armazene até cinco vezes mais páginas do banco de dados do que somente a memória principal. O SSD local atua como um cache de segundo nível, enquanto o cache de buffer existente na memória continua sendo o cache de primeiro nível. A consulta só acessa o armazenamento externo se o cache do buffer e o cache de SSD falharem.
+ **Armazenamento temporário**: os 27% restantes são reservados para armazenamento não persistente de arquivos temporários, usado para consultas complexas envolvendo classificações ou operações que consomem muitos recursos, como compilações de índices. Em instâncias regulares, o espaço temporário reside em um volume de armazenamento do Amazon Elastic Block Store (EBS). O armazenamento temporário hospedado localmente no SSD reduz a latência de consultas envolvendo classificações em até duas vezes e acelera as operações que consomem muitos recursos, como a criação de índices.
Os detalhes sobre o tipo de instâncias com suporte pelo NVMe e suas especificações podem ser encontrados em [Especificações de classe de instância](db-instance-classes.md#db-instance-class-specs).
**Topics**
+ [Casos de uso recomendados para Instâncias baseadas em NVMe](#nvme-use-cases)
+ [Uso de instâncias baseadas em NVMe com o Amazon DocumentDB](#using-nvme)
+ [Monitoramento de Instâncias baseadas em NVMe](#monitoring-nvme)
## Casos de uso recomendados para Instâncias baseadas em NVMe
Recomendamos que você use insâncias baseadas em NVMe nos cenários a seguir:
+ **Workloads com muita leitura**: se sua workload exige muita leitura e seu conjunto de dados é maior que o cache de buffer, indicado por métricas `BufferCacheHitRatio` inferiores e `ReadIOPS` superiores, as instâncias baseadas em NVMe podem oferecer benefícios de performance.
+ **Workloads com muita atualização**: se sua workload exige muitas atualizações e a coleta de resíduos não consegue acompanhar devido à latência de leitura no armazenamento em rede, as instâncias baseadas em NVMe podem ajudar a mitigar o problema.
As instâncias baseadas em NVMe podem beneficiar vários casos de uso, incluindo:
+ **Aplicações em escala de Internet**: aplicações como processamento de pagamentos, cobrança e comércio eletrônico com acordos de serviço (SLAs) de performance rigorosa podem aproveitar as vantagens de performance das instâncias baseadas em NVMe.
+ **Painéis de relatórios em tempo real**: painéis que executam centenas de consultas para coleta de métricas/dados podem se beneficiar da baixa latência e do alto throughput de instâncias baseadas em NVMe.
+ **Aplicações generativas de IA**: as aplicações que usam a pesquisa vetorial para encontrar vizinhos exatos ou mais próximos em milhões de incorporações vetoriais podem aproveitar a alta performance de instâncias baseadas em NVMe.
## Uso de instâncias baseadas em NVMe com o Amazon DocumentDB
Para usar instâncias baseadas em NVMe com o Amazon DocumentDB:
+ Crie um cluster do Amazon DocumentDB e adicione uma das classes de instâncias baseada em NVMe. Para obter mais informações, consulte [Criar um cluster do Amazon DocumentDB](db-cluster-create.md).
+ Como alternativa, modifique um cluster do Amazon DocumentDB para utilizar uma das classes de instâncias baseada em NVMe. Para obter mais informações, consulte [Modificar um cluster do Amazon DocumentDB](db-cluster-modify.md).
Para verificar a disponibilidade de instâncias baseadas em NVMe em diferentes regiões da AWS, consulte [Classes de instância compatíveis por região](db-instance-classes.md#db-instance-classes-by-region).
Se você quiser voltar de uma instância baseada em NVMe para uma instância normal, modifique a classe de instância de banco de dados da sua instância Amazon DocumentDB para uma classe de instância similar sem o armazenamento NVMe. Por exemplo, se a sua classe de instância atual for db.r6gd.4xlarge, selecione ‘db.r6g.4xlarge’ para alternar de volta. Para obter mais informações, consulte [Modificar um cluster do Amazon DocumentDB](db-cluster-modify.md).
## Monitoramento de Instâncias baseadas em NVMe
Além das métricas de instância regulares disponíveis no Amazon CloudWatch, as instâncias baseadas em NVMe emitem métricas adicionais específicas para armazenamento SSD, IOPS e throughput baseados em NVMe.
```
NVMeStorageCacheHitRatio
FreeNVMeStorage
ReadIOPSNVMeStorage
ReadLatencyNVMeStorage
ReadThroughputNVMeStorage
WriteIOPSNVMeStorage
WriteLatencyNVMeStorage
WriteThroughputNVMeStorage
```
Para ter mais informações sobre essas métricas, consulte [NVMe- métricas de instância apoiadas](cloud_watch.md#nvme-metrics)