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 (![Menu button.](http://docs.aws.amazon.com/pt_br/documentdb/latest/devguide/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 à captura de tela a seguir.  
![Tabela de clusters mostrando como uma instância está aninhada sob um cluster.](http://docs.aws.amazon.com/pt_br/documentdb/latest/devguide/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/devguide/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 Arm-based AWS Graviton4 que oferecem desempenho até 30% melhor do que as instâncias R6G.
+ `R6G`— Memory-optimized instâncias alimentadas por processadores Arm-based AWS Graviton2 que oferecem desempenho até 30% melhor em relação às instâncias R5 a um custo 5% menor.
+ `R6GD`— Instâncias Memory-optimized R6G com armazenamento local em Solid-State drive (SSD) baseado em memória expressa não volátil (NVMe) para dados efêmeros.
+ `R5`— Memory-optimized instâncias que oferecem desempenho até 100% melhor do que as 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 de Latest-generation baixo custo com processadores Arm-based AWS Graviton2 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**  
I/O-Optimized o armazenamento 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**  

<table>
<thead>
  <tr><th></th><th colspan="8">Classes de instância</th></tr>
  <tr><th>Região</th><th>R8G</th><th>R6GD</th><th>R6G</th><th>R5</th><th>R4</th><th>T4G</th><th>T3</th><th>Sem servidor</th></tr>
</thead>
<tbody>
  <tr><td>Leste dos EUA (Ohio)</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td></tr>
  <tr><td>Leste dos EUA (Norte da Virgínia)</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td></tr>
  <tr><td>Oeste dos EUA (Oregon)</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td></tr>
  <tr><td>África (Cidade do Cabo)</td><td></td><td></td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td></tr>
  <tr><td>América do Sul (São Paulo)</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td></tr>
  <tr><td>Ásia-Pacífico (Hong Kong)</td><td></td><td></td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td></tr>
  <tr><td>Ásia-Pacífico (Hyderabad)</td><td></td><td></td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td></tr>
  <tr><td>Ásia-Pacífico (Malásia)</td><td></td><td></td><td>Compatível</td><td></td><td></td><td>Compatível</td><td>Compatível</td><td></td></tr>
  <tr><td>Ásia-Pacífico (Mumbai)</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td></tr>
  <tr><td>Ásia-Pacífico (Osaka)</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td></td></tr>
  <tr><td>Ásia-Pacífico (Seul)</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td></tr>
  <tr><td>Ásia-Pacífico (Sydney)</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td></tr>
  <tr><td>Ásia-Pacífico (Jacarta)</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td></td></tr>
  <tr><td>Ásia-Pacífico (Melbourne)</td><td></td><td></td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td></td></tr>
  <tr><td>Ásia-Pacífico (Singapura)</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td></tr>
  <tr><td>Ásia-Pacífico (Tailândia)</td><td></td><td></td><td>Compatível</td><td></td><td></td><td>Compatível</td><td>Compatível</td><td></td></tr>
  <tr><td>Ásia-Pacífico (Tóquio)</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td></tr>
  <tr><td>Canadá (Central)</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td></tr>
  <tr><td>Oeste do Canadá (Calgary)</td><td></td><td></td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td></td></tr>
  <tr><td>Europa (Frankfurt)</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td></tr>
  <tr><td>Europa (Zurique)</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td></td></tr>
  <tr><td>Europa (Irlanda)</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td></tr>
  <tr><td>Europa (Londres)</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td></tr>
  <tr><td>Europa (Milão)</td><td></td><td></td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td></tr>
  <tr><td>Europa (Paris)</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td></tr>
  <tr><td>Europa (Espanha)</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td></tr>
  <tr><td>Europa (Estocolmo)</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td></td></tr>
  <tr><td>México (Centro)</td><td></td><td></td><td>Compatível</td><td></td><td></td><td>Compatível</td><td>Compatível</td><td></td></tr>
  <tr><td>Oriente Médio (Emirados Árabes Unidos)</td><td></td><td></td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td></tr>
  <tr><td>China (Pequim)</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td></tr>
  <tr><td>China (Ningxia)</td><td></td><td></td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td></tr>
  <tr><td>Israel (Tel Aviv)</td><td></td><td></td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td></td></tr>
  <tr><td>AWS GovCloud (US-West)</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td></td><td></td><td>Compatível</td><td>Compatível</td></tr>
  <tr><td>AWS GovCloud (US-East)</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td><td></td><td>Compatível</td><td>Compatível</td><td>Compatível</td></tr>
</tbody>
</table>


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


<table>
<thead>
  <tr><th>Classe de instância</th><th>vCPU1</th><th>Memória (GiB)2</th><th>Cache hierárquico SSD NVMe (GiB) 3</th><th>Temperatura máxima de armazenamento (GiB) 4</th><th>Largura de banda de linha de base / rajada (Gbps) 5</th><th>Motores de apoio 6</th></tr>
</thead>
<tbody>
  <tr><td colspan="7">R8G — Classe de Memory-Optimized instância da geração atual baseada em Graviton4O R8G é a mais nova família de instâncias (Graviton4), disponível somente nas versões 5.0 e 8.0 do motor. O tamanho db.r8g.48xlarge ainda não está disponível.</td></tr>
  <tr><td>db.r8g.large</td><td>2</td><td>16</td><td>-</td><td>30</td><td>0.937/12.5</td><td>5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r8g.xlarge</td><td>4</td><td>32</td><td>-</td><td>60</td><td>1.875/12.5</td><td>5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r8g.2xlarge</td><td>8</td><td>64</td><td>-</td><td>121</td><td>3.75/15.0</td><td>5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r8g.4xlarge</td><td>16</td><td>128</td><td>-</td><td>243</td><td>7.5/15.0</td><td>5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r8g.8xlarge</td><td>32</td><td>256</td><td>-</td><td>488</td><td>15</td><td>5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r8g.12xlarge</td><td>48</td><td>384</td><td>-</td><td>732</td><td>22</td><td>5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r8g.16xlarge</td><td>64</td><td>512</td><td>-</td><td>987</td><td>30</td><td>5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r8g.24xlarge</td><td>96</td><td>768</td><td>-</td><td>1484</td><td>40</td><td>5.0.0 e 8.0.0</td></tr>
  <tr><td colspan="7">R6G — Classe de Memory-Optimized instância da geração atual baseada em Graviton2</td></tr>
  <tr><td>db.r6g.large</td><td>2</td><td>16</td><td>-</td><td>32</td><td>0,75/10</td><td>4.0.0, 5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r6g.xlarge</td><td>4</td><td>32</td><td>-</td><td>63</td><td>1,25/10</td><td>4.0.0, 5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r6g.2xlarge</td><td>8</td><td>64</td><td>-</td><td>126</td><td>2,5/10</td><td>4.0.0, 5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r6g.4xlarge</td><td>16</td><td>128</td><td>-</td><td>252</td><td>5,0/10</td><td>4.0.0, 5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r6g.8xlarge</td><td>32</td><td>256</td><td>-</td><td>504</td><td>12</td><td>4.0.0, 5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r6g.12xlarge</td><td>48</td><td>384</td><td>-</td><td>756</td><td>20</td><td>4.0.0, 5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r6g.16xlarge</td><td>64</td><td>512</td><td>-</td><td>1008</td><td>25</td><td>4.0.0, 5.0.0 e 8.0.0</td></tr>
  <tr><td colspan="7">R6GD — Classe de NVMe-backed instância da geração atual baseada em Graviton2</td></tr>
  <tr><td>db.r6gd.xlarge</td><td>4</td><td>32</td><td>173</td><td>64</td><td>1,25/10</td><td>5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r6gd.2xlarge</td><td>8</td><td>64</td><td>346</td><td>128</td><td>2,5/10</td><td>5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r6gd.4xlarge</td><td>16</td><td>128</td><td>694</td><td>256</td><td>5,0/10</td><td>5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r6gd.8xlarge</td><td>32</td><td>256</td><td>1388</td><td>512</td><td>12</td><td>5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r6gd.12xlarge</td><td>48</td><td>384</td><td>2082</td><td>768</td><td>20</td><td>5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r6gd.16xlarge</td><td>64</td><td>512</td><td>2776</td><td>1024</td><td>25</td><td>5.0.0 e 8.0.0</td></tr>
  <tr><td colspan="7">R5 — Classe de Memory-Optimized instância da geração anterior</td></tr>
  <tr><td>db.r5.large</td><td>2</td><td>16</td><td>-</td><td>31</td><td>0,75/10</td><td>3.6.0, 4.0.0, 5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r5.xlarge</td><td>4</td><td>32</td><td>-</td><td>62</td><td>1,25/10</td><td>3.6.0, 4.0.0, 5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r5.2xlarge</td><td>8</td><td>64</td><td>-</td><td>124</td><td>2,5/10</td><td>3.6.0, 4.0.0, 5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r5.4xlarge</td><td>16</td><td>128</td><td>-</td><td>249</td><td>5,0/10</td><td>3.6.0, 4.0.0, 5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r5.8xlarge</td><td>32</td><td>256</td><td>-</td><td>504</td><td>10</td><td>3.6.0, 4.0.0, 5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r5.12xlarge</td><td>48</td><td>384</td><td>-</td><td>748</td><td>12</td><td>3.6.0, 4.0.0, 5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r5.16xlarge</td><td>64</td><td>512</td><td>-</td><td>1008</td><td>20</td><td>3.6.0, 4.0.0, 5.0.0 e 8.0.0</td></tr>
  <tr><td>db.r5.24xlarge</td><td>96</td><td>768</td><td>-</td><td>1500</td><td>25</td><td>3.6.0, 4.0.0, 5.0.0 e 8.0.0</td></tr>
  <tr><td colspan="7">R4 — Classe de Memory-Optimized instância da geração anteriorAs 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.</td></tr>
  <tr><td>db.r4.large</td><td>2</td><td>15.25</td><td>-</td><td>30</td><td>0,75/10</td><td>3.6.0 somente</td></tr>
  <tr><td>db.r4.xlarge</td><td>4</td><td>30.5</td><td>-</td><td>60</td><td>1,25/10</td><td>3.6.0 somente</td></tr>
  <tr><td>db.r4.2xlarge</td><td>8</td><td>61</td><td>-</td><td>120</td><td>2,5/10</td><td>3.6.0 somente</td></tr>
  <tr><td>db.r4.4xlarge</td><td>16</td><td>122</td><td>-</td><td>240</td><td>5,0/10</td><td>3.6.0 somente</td></tr>
  <tr><td>db.r4.8xlarge</td><td>32</td><td>244</td><td>-</td><td>480</td><td>10</td><td>3.6.0 somente</td></tr>
  <tr><td>db.r4.16xlarge</td><td>64</td><td>488</td><td>-</td><td>960</td><td>25</td><td>3.6.0 somente</td></tr>
  <tr><td colspan="7">T4G: classes de instância de desempenho expansível de última geração com base no Graviton2T-series as instâncias 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.</td></tr>
  <tr><td>db.t4g.medium</td><td>2</td><td>4</td><td>-</td><td>8.13</td><td>0,256/5</td><td>4.0.0, 5.0.0 e 8.0.0</td></tr>
  <tr><td colspan="7">T3: classes de instância de desempenho expansível de geração anterior</td></tr>
  <tr><td>db.t3.medium</td><td>2</td><td>4</td><td>-</td><td>7,5</td><td>0,256/5</td><td>3.6.0, 4.0.0, 5.0.0 e 8.0.0</td></tr>
  <tr><td colspan="7"> [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/documentdb/latest/devguide/db-instance-classes.html) </td></tr>
</tbody>
</table>