

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**  
[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/db-instance-classes.html)

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

[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/db-instance-classes.html)