

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 classes de instância
<a name="db-instance-classes"></a>

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
<a name="db-instance-class-determining"></a>

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
<a name="db-instance-class-changing"></a>

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
<a name="db-instance-classes-by-region"></a>

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 name="db-instance-class-specs"></a>

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)  | 