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á.
# Gerenciamento do Amazon DocumentDB Sem Servidor
## Visualização e modificação da configuração do intervalo de capacidade de escalabilidade de um cluster
O argumento `ServerlessV2ScalingConfiguration` especifica a faixa de capacidade de escalabilidade de suas instâncias do DocumentDB Sem Servidor. Ele consiste nos valores mínimo e máximo de unidade de capacidade do DocumentDB (DCU) que se aplicam a todas as instâncias do DocumentDB Sem Servidor no cluster.
+ **`MinCapacity`**: a capacidade mínima de escalabilidade de qualquer instância com tecnologia sem servidor do DocumentDB no cluster.
+ **`MaxCapacity`**: a capacidade máxima de escalabilidade de qualquer instância com tecnologia sem servidor do DocumentDB no cluster.
**nota**
As modificações na configuração de escalabilidade a seguir exigem a reinicialização da instância para refletir os novos valores `MinCapacity` e `MaxCapacity`:
Quaisquer alterações no valor `MaxCapacity`
Alteração do valor de `MinCapacity` para 1,0 ou inferior a partir de um valor maior
Alteração do valor de `MinCapacity` para um maior que 1,0 a partir de um valor menor
Para obter mais informações sobre a configuração de escalabilidade e como selecionar os limites adequados de capacidade de escalabilidade, consulte [Configuração de escalabilidade do Amazon DocumentDB Sem Servidor](docdb-serverless-scaling-config.md).
------
#### [ Using the Console de gerenciamento da AWS ]
O exemplo de Console de gerenciamento da AWS configuração a seguir mostra como visualizar e editar as configurações de escalabilidade de um cluster sem servidor DocumentDB.
1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1) e abra o console do Amazon DocumentDB.
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.
A tabela **Clusters** será exibida.
1. Na tabela **Clusters**, marque a caixa de seleção do cluster para o qual você deseja modificar a capacidade de escalabilidade.
1. Escolha **Ações** e, em seguida, **Modificar**.
A caixa de diálogo **Modificar cluster** será exibida.
1. Localize a seção **Configuração de capacidade de tecnologia sem servidor e defina** a configuração de escalabilidade (**Intervalo de capacidade**) com base na descrição da capacidade na caixa de diálogo.
Para obter mais informações sobre escalabilidade e intervalos de capacidade, consulte [Configuração de escalabilidade do Amazon DocumentDB Sem Servidor](docdb-serverless-scaling-config.md).
1. Escolha **Continue**.
1. Em **Scheduling of modifications (Programação de modificações)**, selecione **Apply immediately (Aplicar imediatamente)**.
1. Escolha **Modificar Cluster**.
1. Depois que a modificação for concluída, cada instância com tecnologia sem servidor deverá ser reinicializada. Para minimizar a indisponibilidade do gravador, execute a sequência de operações a seguir:
1. Reinicialize cada instância de leitor com tecnologia sem servidor.
1. Selecione a instância do leitor, escolha **Ações** e, em seguida, **Reinicializar**.
1. Aguarde até que o status da instância retorne para **Disponível**.
1. Execute uma operação de failover em uma instância com tecnologia sem servidor reinicializada.
1. Selecione o cluster, escolha **Ações** e, em seguida, **Failover**.
1. Aguarde a conclusão da operação de failover.
1. Reinicialize a instância com tecnologia sem servidor restante.
1. Selecione a instância restante, escolha **Ações** e, em seguida, **Reinicializar**.
1. Aguarde até que o status da instância retorne para **Disponível**.
------
#### [ Using the AWS CLI ]
O exemplo AWS CLI de configuração a seguir mostra a configuração de escalabilidade atual.
No exemplo a seguir, substitua cada um *user input placeholder* por suas próprias informações ou parâmetros de configuração.
A configuração de escalabilidade atual do cluster pode ser visualizada usando o `describe-db-clusters` AWS CLI comando:
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[0].ServerlessV2ScalingConfiguration'
```
Veja a seguir a saída desse comando:
```
{
"MinCapacity": 0.5,
"MaxCapacity": 16.0
}
```
A configuração de escalabilidade do cluster pode ser modificada usando o comando `modify-db-cluster`:
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--serverless-v2-scaling-configuration MinCapacity=0.5,MaxCapacity=32
```
Após a conclusão, cada instância com tecnologia sem servidor deverá ser reinicializada. Para minimizar a indisponibilidade do gravador, podemos executar a sequência de operações a seguir:
```
aws docdb reboot-db-instance \
--db-instance-identifier sample-serverless-instance-reader
aws docdb wait db-instance-available \
--db-instance-identifier sample-serverless-instance-reader
aws docdb failover-db-cluster \
--db-cluster-identifier sample-cluster \
--target-db-instance-identifier sample-serverless-instance-reader
aws docdb reboot-db-instance \
--db-instance-identifier sample-serverless-instance-writer
aws docdb wait db-instance-available \
--db-instance-identifier sample-serverless-instance-writer
aws docdb failover-db-cluster \
--db-cluster-identifier sample-cluster \
--target-db-instance-identifier sample-serverless-instance-writer
```
------
## Visualização e modificação do nível de promoção de leitores com tecnologia sem servidor
No caso de clusters que contenham várias instâncias do DocumentDB Sem Servidor ou uma mistura de instâncias com tecnologia sem servidor e provisionadas, preste atenção à configuração do nível de promoção de cada instância com tecnologia sem servidor. Essa configuração controla mais aspectos do comportamento das instâncias com tecnologia sem servidor do que das instâncias provisionadas.
No caso de instâncias provisionadas, a escolha do nível de 0 a 15 determina apenas a ordem na qual o Amazon DocumentDB escolhe qual instância de leitor promover a gravador durante uma operação de failover. Contudo, para instâncias com tecnologia sem servidor, o número do nível também determina se a escala da instância será aumentada verticalmente para corresponder à capacidade da instância do gravador ou se será escalada independentemente, com base somente na própria workload. As instâncias de leitor com tecnologia sem servidor no nível 0 ou 1 são mantidas em uma capacidade mínima pelo menos tão alta quanto a instância do gravador. Dessa forma, elas estarão prontas para assumir o controle da instância do gravador em caso de failover. Se a instância do gravador for uma instância provisionada, o Amazon DocumentDB estimará a capacidade do DocumentDB Sem Servidor equivalente. Ele usa essa estimativa como a capacidade mínima para a instância do leitor com tecnologia sem servidor.
As instâncias de leitor do DocumentDB Sem Servidor nos níveis 2 a 15 não têm a mesma restrição em sua capacidade mínima. Quando estiverem ociosas, elas poderão ter a escala reduzida na vertical para o valor mínimo da unidade de capacidade do DocumentDB (DCU) especificado no intervalo de capacidade do cluster.
------
#### [ Using the Console de gerenciamento da AWS ]
O exemplo de Console de gerenciamento da AWS configuração a seguir mostra como visualizar e modificar as configurações de nível promocional do leitor de instâncias sem servidor do DocumentDB.
1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1) e abra o console do Amazon DocumentDB.
Os níveis de promoção de cada instância são exibidos na coluna **Nível de promoção**, no Console de gerenciamento da AWS.
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.
A tabela **Clusters** será exibida.
1. Na tabela **Clusters**, marque a caixa de seleção da instância para a qual você deseja modificar o nível de promoção.
1. Escolha **Ações** e, em seguida, **Modificar**.
A caixa de diálogo **Modificar instância** será exibida.
1. Localize a seção **Failover** e defina **Nível de promoção** para o nível desejado.
1. Escolha **Continue**.
1. Em **Scheduling of modifications (Programação de modificações)**, selecione **Apply immediately (Aplicar imediatamente)**.
1. Escolha **Modify instance (Modificar instância)**.
------
#### [ Using the AWS CLI ]
O exemplo AWS CLI de configuração a seguir mostra a configuração de escalabilidade atual.
No exemplo a seguir, substitua cada um *user input placeholder* por suas próprias informações ou parâmetros de configuração.
Os níveis de promoção de todas as instâncias em um cluster podem ser visualizados usando o `describe-db-clusters` AWS CLI comando:
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[0].DBClusterMembers' \
--output table
```
Veja a seguir a saída desse comando:
```
--------------------------------------------------------------------------------------------------------
| DescribeDBClusters |
+--------------------------------+---------------------------------+------------------+----------------+
| DBClusterParameterGroupStatus | DBInstanceIdentifier | IsClusterWriter | PromotionTier |
+--------------------------------+---------------------------------+------------------+----------------+
| in-sync | sample-serverless-instance-2 | False | 1 |
| in-sync | sample-serverless-instance-1 | True | 1 |
+--------------------------------+---------------------------------+------------------+----------------+
```
O nível de promoção de uma instância específica pode ser modificado usando o comando `modify-db-instance`:
```
aws docdb modify-db-instance \
--db-instance-identifier sample-serverless-instance-2 \
--promotion-tier 3
```
------