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 clusters do Amazon DocumentDB
Para gerenciar um cluster do Amazon DocumentDB, é necessário ter uma política do IAM com as permissões de ambiente de gerenciamento apropriadas do Amazon DocumentDB. Essas permissões permitem criar, modificar e excluir clusters e instâncias. A política `AmazonDocDBFullAccess` fornece todas as permissões necessárias para administrar um cluster do Amazon DocumentDB.
Os tópicos a seguir mostram como executar várias tarefas ao trabalhar com clusters do Amazon DocumentDB, inclusive criação, exclusão, modificação, conexão e visualização.
**Topics**
+ [Noções básicas de clusters](db-clusters-understanding.md)
+ [Configurações do cluster](db-cluster-parameters.md)
+ [Configurações de armazenamento de cluster](db-cluster-storage-configs.md)
+ [Determinar o status de um cluster](db-cluster-status.md)
+ [Ciclo de vida do cluster](db-cluster-life-cycle.md)
+ [Escalar clusters](db-cluster-manage-performance.md)
+ [Clonar um volume para um cluster](db-cluster-cloning.md)
+ [Entender a tolerância a falhas de cluster](db-cluster-fault-tolerance.md)
# Noções básicas de clusters
O Amazon DocumentDB separa computação de armazenamento, transfere replicação de dados e backup para o volume do cluster. Um volume de cluster fornece uma camada de armazenamento durável, confiável e altamente disponível, que replica dados de seis maneiras em três Zonas de Disponibilidade. As réplicas permitem maior disponibilidade de dados e leitura em escala. Cada cluster pode ter sua escala aumentada verticalmente em até 15 réplicas.
| Substantivo | Description | Operações de API (verbos) |
| --- | --- | --- |
| Cluster | Consiste em uma ou mais instâncias e em um volume de armazenamento de cluster que gerencia os dados para essas instâncias. | `create-db-cluster` `delete-db-cluster` `describe-db-clusters` `modify-db-cluster` |
| Instância | A leitura e a gravação de dados no volume de armazenamento do cluster são feitas por meio de instâncias. Em um determinado cluster, há dois tipos de instâncias: principal e de réplica. Um cluster sempre tem uma instância principal e pode ter entre 0 e 15 réplicas. | `create-db-instance` `delete-db-instance` `describe-db-instances` `modify-db-instance` `describe-orderable-db-instance-options` `reboot-db-instance` |
| Volume do cluster | Um volume de armazenamento de banco de dados virtual que abrange três Zonas de Disponibilidade, no qual cada Zona de Disponibilidade conta com duas cópias dos dados do cluster. | N/D |
| Instância principal | Oferece suporte a operações de leitura e gravação, além de realizar todas as modificações de dados no volume do cluster. Cada cluster tem uma instância principal. | N/D |
| Instância de réplica | É compatível apenas com operações de leitura. Cada cluster do Amazon DocumentDB pode ter até 15 instâncias de réplica além da instância principal. Várias réplicas distribuem workloads de leitura. Ao localizar réplicas em Zonas de Disponibilidade separadas, você também pode aumentar a disponibilidade do banco de dados. | N/D |
| Endpoint do cluster | Um endpoint para um cluster do Amazon DocumentDB que se conecta à instância principal atual do mesmo. Cada cluster do Amazon DocumentDB tem um endpoint de cluster e uma instância principal. | N/D |
| Endpoint de leitor | Um endpoint para um cluster do Amazon DocumentDB que se conecta a uma das réplicas disponíveis para esse cluster. Cada cluster do Amazon DocumentDB tem um endpoint de leitor. Se houver mais de uma réplica, o endpoint de leitor direcionará cada solicitação de conexão para uma das réplicas do Amazon DocumentDB. | N/D |
| Endpoint da instância | Um endpoint para uma instância em um cluster do Amazon DocumentDB que se conecta a uma instância específica. Cada instância em um cluster, independente do tipo, tem seu próprio endpoint de instância exclusivo. | N/D |
# Configurações de cluster do Amazon DocumentDB
Ao criar ou modificar um cluster, é importante entender quais parâmetros são imutáveis e quais podem ser modificados após o cluster ser criado. A tabela a seguir lista todos as configurações ou os parâmetros que são específicos de um cluster. Conforme especificado na tabela, alguns são modificáveis, outros não.
**nota**
Essas configurações não devem ser confundidas com grupos de parâmetros de cluster do Amazon DocumentDB e seus parâmetros. Para obter mais informações sobre parameter groups de cluster, consulte [Gerenciando grupos de parâmetros de cluster do Amazon DocumentDB](cluster_parameter_groups.md).
| Parâmetro | Modificável | Observações |
| --- | --- | --- |
| DBClusterIdentifier | Sim | Restrições de nomenclatura: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/db-cluster-parameters.html) |
| Engine | Não | Deve ser docdb. |
| BackupRetentionPeriod | Sim | Defina um período entre [1 e 35] dias. |
| DBClusterParameterGroupName | Sim | Restrições de nomenclatura: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/db-cluster-parameters.html) |
| DBSubnetGroupName | Não | Depois que um cluster for criado, você não poderá modificar a sub-rede do cluster. |
| EngineVersion | Não | O valor pode ser 5.0.0 (padrão), 4.0.0 ou 3.6.0. |
| KmsKeyId | Não | Se você optar por criptografar seu cluster, não poderá alterar a AWS KMS chave usada para criptografar seu cluster. |
| MasterUsername | Não | Depois que um cluster for criado, você não poderá modificar o `MasterUsername`. Restrições de nomenclatura: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/db-cluster-parameters.html) |
| MasterUserPassword | Sim | Restrições: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/db-cluster-parameters.html) |
| Port | Sim | O número da porta se aplica a todas as instâncias no cluster. |
| PreferredBackupWindow | Sim | |
| PreferredMaintenanceWindow | Sim | |
| StorageEncrypted | Não | Se você optar por criptografar seu cluster, ele não poderá ser descriptografado. |
| StorageType | Sim | O tipo de armazenamento do cluster de banco de dados: Padrão (`standard`) ou Otimizado para E/S (`iopt1`). Padrão: `standard` Esse parâmetro pode ser configurado com `CreateDBCluster` e `ModifyDBCluster`. Para obter mais informações, consulte [Configurações de armazenamento de cluster do Amazon DocumentDB](db-cluster-storage-configs.md). |
| Tags | Sim | |
| VpcSecurityGroupIds | Não | Depois que um cluster for criado, você não poderá modificar a VPC em que o cluster reside. |
# Configurações de armazenamento de cluster do Amazon DocumentDB
A partir do Amazon DocumentDB 5.0, os clusters baseados em instâncias oferecem suporte a dois tipos de configurações de armazenamento:
+ **Armazenamento padrão do Amazon DocumentDB**: projetado para clientes com consumo baixo a moderado I/O . Se você espera que seus I/O custos sejam inferiores a 25% do seu cluster total do Amazon DocumentDB, essa opção pode ser ideal para você. Com a configuração de armazenamento padrão do Amazon DocumentDB, você é cobrado pay-per-request I/O com base nas cobranças de instância e armazenamento. Isso significa que seu faturamento pode variar de um ciclo para outro com base no uso. A configuração é personalizada para acomodar I/O as demandas flutuantes de sua aplicação.
+ **Armazenamento otimizado para E/S do Amazon DocumentDB**: projetado para clientes que priorizam a previsibilidade de preços ou têm aplicativos intensivos. I/O As I/O-optimized configuration offers improved performance, increased throughput, and reduced latency for customers with I/O intensive workloads. If you expect your I/O costs to exceed 25% of your total Amazon DocumentDB cluster costs, this option offers enhanced price performance. With the Amazon DocumentDB I/O-optimized storage configuration, you won't be charged based on I/O operações, garantindo custos previsíveis em cada ciclo de faturamento. A configuração estabiliza os custos e, ao mesmo tempo, melhora a performance.
Você pode mudar seus clusters de banco de dados existentes uma vez a cada 30 dias para o Amazon DocumentDB. Os clusters I/O-optimized storage. You can switch back to Amazon DocumentDB standard storage at any time. The next date to modify the storage configuration to I/O otimizados podem ser rastreados com o `describe-db-clusters` comando usando AWS CLI ou por meio da página de Console de gerenciamento da AWS configuração do cluster.
Você pode criar um novo cluster de banco de dados, incluindo a configuração otimizada para E/S do Amazon DocumentDB, ou converter seus clusters de banco de dados existentes com alguns cliques [Console de gerenciamento da AWS](https://console.aws.amazon.com/docdb/), com uma única alteração de parâmetro no [AWS Command Line Interface ()AWS CLI](https://aws.amazon.com/cli/) ou por meio dele. [AWS SDKs](https://aws.amazon.com/developer/tools/) Não é necessário tempo de inatividade ou reinicialização das instâncias durante ou após a modificação da configuração de armazenamento.
![\[Imagem: uma tabela descrevendo as diferenças entre o armazenamento padrão e o armazenamento otimizado do Amazon DocumentDB.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/io-diagram-1.png)
## Criar um cluster otimizado para E/S
------
#### [ Using the Console de gerenciamento da AWS ]
Para criar ou modificar um cluster otimizado para E/S usando o Console de gerenciamento da AWS:
1. No console de gerenciamento do Amazon DocumentDB, em **Clusters**, escolha **Criar** ou selecione o cluster e escolha **Ações** e, em seguida, escolha **Modificar**.
1. Se você estiver criando um novo cluster, escolha **Cluster baseado em instância** na seção **Tipo de cluster** (essa é a opção padrão).
![\[Imagem: uma captura de tela do console das opções de tipo de cluster.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/create-cluster/cc-type.png)
1. Na seção **Configuração**, em **Configuração de armazenamento do cluster**, escolha **Amazon DocumentDB Otimizado para E/S**.
![\[Imagem: uma captura de tela do console das opções de configuração de armazenamento em cluster.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/storage-config-1.png)
1. Conclua a criação ou modificação do cluster e escolha **Criar cluster** ou **Modificar cluster**.
Para obter o processo completo de criação de cluster, consulte [Criação de um cluster e de uma instância primária usando o Console de gerenciamento da AWS](db-cluster-create.md#db-cluster-create-con).
Para obter o processo completo de modificação de cluster, consulte [Modificar um cluster do Amazon DocumentDB](db-cluster-modify.md).
------
#### [ Using the AWS CLI ]
Para criar um cluster otimizado para E/S usando a AWS CLI:
Nos exemplos a seguir, substitua cada um *user input placeholder* por suas próprias informações.
Para Linux, macOS ou Unix:
```
aws docdb create-db-cluster \
--db-cluster-identifier sample-cluster \
--engine docdb \
--engine-version 5.0.0 \
--storage-type iopt1 \
--deletion-protection \
--master-username username \
--master-user-password password
```
Para Windows:
```
aws docdb create-db-cluster ^
--db-cluster-identifier sample-cluster ^
--engine docdb ^
--engine-version 5.0.0 ^
--storage-type iopt1 ^
--deletion-protection ^
--master-username username ^
--master-user-password password
```
------
## Análise de custos para determinar a configuração de armazenamento
Com o Amazon DocumentDB, você tem a flexibilidade de escolher a configuração de armazenamento para todos os seus clusters de banco de dados. Para alocar adequadamente seus clusters entre o padrão e o otimizado para E/S, você pode monitorar seus custos do Amazon DocumentDB em termos de cluster. Para fazer isso, você pode adicionar tags aos clusters existentes, habilitar a marcação de alocação de custos em seu [painel do Gerenciamento de Faturamento e Custos da AWS](https://aws.amazon.com/pricing/) e analisar os custos de um determinado cluster no [AWS Cost Explorer Service](https://aws.amazon.com/aws-cost-management/aws-cost-explorer/). Para obter informações sobre análise de custos, consulte nosso blog [Usar tags de alocação de custos](https://aws.amazon.com/blogs/database/using-cost-allocation-tags-with-amazon-documentdb-with-mongodb-compatibility/).
# Determinar o status de um cluster
Você pode determinar o status de um cluster usando o Console de gerenciamento da AWS ou AWS CLI.
------
#### [ Using the Console de gerenciamento da AWS ]
Use o procedimento a seguir para ver o status do seu cluster Amazon DocumentDB usando o Console de gerenciamento da AWS
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**.
1. Na coluna **Identificador de cluster**, encontre o nome do cluster desejado. Depois, para descobrir o status do cluster, leia essa linha até a coluna **Status**, conforme mostrado abaixo.
![\[Captura de tela da página de clusters com exemplo de cluster mostrando o status ativo.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/db-cluster-status-con.png)
------
#### [ Using the AWS CLI ]
Use a operação `describe-db-clusters` para ver o status do cluster do Amazon DocumentDB utilizando AWS CLI.
O código a seguir descobre o status do cluster `sample-cluster`.
Para Linux, macOS ou Unix:
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,Status]'
```
Para Windows:
```
aws docdb describe-db-clusters ^
--db-cluster-identifier sample-cluster ^
--query 'DBClusters[*].[DBClusterIdentifier,Status]'
```
A saída dessa operação é semelhante ao seguinte (formato JSON).
```
[
[
"sample-cluster",
"available"
]
]
```
------
# Ciclo de vida do cluster do Amazon DocumentDB
O ciclo de vida de um cluster do Amazon DocumentDB inclui a criação, a descrição, a modificação e a exclusão do cluster. Esta seção fornece informações sobre como concluir esses processos.
**Topics**
+ [Criação de um cluster](db-cluster-create.md)
+ [Descrever clusters](db-cluster-view-details.md)
+ [Modificar um cluster](db-cluster-modify.md)
+ [Determinar manutenção pendente](db-cluster-determine-pending-maintenance.md)
+ [Atualizar patch da versão do mecanismo de um cluster](db-cluster-version-upgrade.md)
+ [Interromper e iniciar um cluster](db-cluster-stop-start.md)
+ [Excluir um cluster](db-cluster-delete.md)
# Criar um cluster do Amazon DocumentDB
Um cluster do Amazon DocumentDB consiste em instâncias e em um volume de cluster que representa os dados para o mesmo. O volume do cluster é replicado de seis maneiras em três Zonas de Disponibilidade, como volume único e virtual. O cluster contém uma instância principal e, como opção, até 15 instâncias de réplica.
As seções a seguir mostram como criar um cluster Amazon DocumentDB usando o Console de gerenciamento da AWS ou o. AWS CLI Em seguida, você pode adicionar instâncias de réplica adicionais para esse cluster. Quando o console é usado para criar o cluster do Amazon DocumentDB, uma instância primária é criada automaticamente ao mesmo tempo. Se você usar o AWS CLI para criar seu cluster Amazon DocumentDB, depois que o status do cluster estiver *disponível*, você deverá criar a instância primária para esse cluster.
## Pré-requisitos
Veja a seguir os pré-requisitos para a criação de um cluster do Amazon DocumentDB.
Se você não tiver um Conta da AWS, conclua as etapas a seguir para criar um.
**Para se inscrever em um Conta da AWS**
1. Abra a [https://portal.aws.amazon.com/billing/inscrição.](https://portal.aws.amazon.com/billing/signup)
1. Siga as instruções online.
Parte do procedimento de inscrição envolve receber uma chamada telefônica ou uma mensagem de texto e inserir um código de verificação pelo teclado do telefone.
Quando você se inscreve em um Conta da AWS, um *Usuário raiz da conta da AWS*é criado. O usuário-raiz tem acesso a todos os Serviços da AWS e recursos na conta. Como prática recomendada de segurança, atribua o acesso administrativo a um usuário e use somente o usuário-raiz para executar [tarefas que exigem acesso de usuário-raiz](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).
### Pré-requisitos da VPC
É possível criar apenas um cluster do Amazon DocumentDB em uma Amazon Virtual Private Cloud (Amazon VPC). Seu Amazon VPC deve ter no mínimo uma sub-rede em pelo menos duas Zonas de Disponibilidade para que você possa usá-la com um cluster de banco de dados do Amazon DocumentDB. Ao distribuir suas instâncias de cluster por Zonas de Disponibilidade, você garante que as instâncias estejam disponíveis em seu cluster no improvável caso de ocorrer uma falha na Zona de Disponibilidade.
### Pré-requisitos de sub-rede
Ao criar um cluster do Amazon DocumentDB, você deve escolher uma VPC e um grupo de sub-rede correspondente dentro dessa VPC para iniciar o seu cluster. Sub-redes determinam a Zona de Disponibilidade e o intervalo de IP dentro dela para executar uma instância. Para essa discussão, usaremos os termos *sub-rede* e *Zona de Disponibilidade* alternadamente. Um grupo de sub-redes é um conjunto nomeado de sub-redes (ou Zonas de Disponibilidade). Um grupo de sub-redes permite que você especifique as Zonas de Disponibilidade que deseja usar para executar instâncias do Amazon DocumentDB. Por exemplo, em um cluster com três instâncias, a fim de manter a disponibilidade alta, é recomendável que cada uma dessas instâncias seja provisionada em Zonas de Disponibilidade separadas. Dessa forma, se uma única Zona de Disponibilidade falhar, ela só afetará uma única instância.
As instâncias do Amazon DocumentDB podem ser provisionadas atualmente em até três Zonas de Disponibilidade. Mesmo que um grupo tenha mais de três sub-redes, você só pode usar três dessas sub-redes para criar um cluster do Amazon DocumentDB. Como resultado, é recomendável que, ao criar um grupo de sub-redes, você escolha somente as três sub-redes nas quais deseja implantar suas instâncias. No Leste dos EUA (Norte da Virgínia), seu grupo de sua sub-rede pode ter seis sub-redes (ou Zonas de Disponibilidade). No entanto, quando um cluster do Amazon DocumentDB é fornecido, o Amazon DocumentDB escolhe três dessas Zonas de Disponibilidade e as utiliza para fornecer instâncias.
Por exemplo, suponha que, ao criar um cluster, o Amazon DocumentDB escolhe as Zonas de Disponibilidade \$11A, 1B e 1C\$1. Se você tentar criar uma instância na Zona de Disponibilidade \$11D\$1, a chamada de API não será bem-sucedida. Porém, se você optar por criar uma instância sem especificar uma Zona de Disponibilidade específica, o Amazon DocumentDB escolherá uma Zona de Disponibilidade em seu nome. O Amazon DocumentDB usa um algoritmo para balancear a carga das instâncias em todas as Zonas de Disponibilidade, para ajudar a alcançar alta disponibilidade. Por exemplo, se três instâncias forem fornecidas, por padrão, todas serão fornecidas em três Zonas de Disponibilidade, não em uma única Zona de Disponibilidade.
**Recomendações:**
+ A menos que você tenha um motivo específico, sempre crie um grupo de sub-rede com três sub-redes. Isso ajuda a garantir que clusters com três ou mais instâncias alcancem maior disponibilidade, pois as instâncias são provisionadas em três Zonas de Disponibilidade.
+ Sempre distribua instâncias em várias Zonas de Disponibilidade para obter alta disponibilidade. Nunca coloque todas as instâncias de um cluster em uma única Zona de Disponibilidade.
+ Como eventos de failover podem acontecer a qualquer momento, você não deve presumir que uma instância primária ou de réplica estará sempre em uma determinada Zona de Disponibilidade.
### Pré-requisitos adicionais
Veja a seguir alguns pré-requisitos adicionais para criar um cluster do Amazon DocumentDB:
+ Se você estiver se conectando AWS usando credenciais AWS Identity and Access Management (IAM), sua conta do IAM deve ter políticas do IAM que concedam as permissões necessárias para realizar operações do Amazon DocumentDB.
Se você estiver usando uma conta do IAM para acessar o console do Amazon DocumentDB, primeiro faça login Console de gerenciamento da AWS com sua conta do IAM. [Em seguida, acesse o console do Amazon DocumentDB em https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
+ Se quiser personalizar os parâmetros de configuração do seu cluster, você deverá especificar um grupo de parâmetros do cluster e um grupo de parâmetros com as configurações de parâmetro obrigatórias. Para obter informações sobre como criar ou modificar um grupo de parâmetros de cluster ou um grupo de parâmetros, consulte [Gerenciando grupos de parâmetros de cluster do Amazon DocumentDB](cluster_parameter_groups.md).
+ Você deve determinar o número da TCP/IP porta que deseja especificar para seu cluster. Em algumas empresas, os firewalls bloqueiam conexões com as portas padrão do Amazon DocumentDB. Se o firewall da sua empresa bloquear a porta padrão, escolha outra porta para o cluster. Todas as instâncias em um cluster usam a mesma porta.
## Criação de um cluster e de uma instância primária usando o Console de gerenciamento da AWS
Os procedimentos a seguir descrevem como usar o console para iniciar um cluster do Amazon DocumentDB com uma ou mais instâncias.
### Criar um cluster: uso das configurações padrão
**Para criar um cluster com instâncias usando as configurações padrão usando o Console de gerenciamento da AWS**
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. Se você quiser criar seu cluster em Região da AWS outra região que não seja o Leste dos EUA (Norte da Virgínia), escolha a Região na lista na seção superior direita do console.
1. No painel de navegação, selecione **Clusters** e, em seguida, **Criar**.
**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 página **Criar cluster Amazon DocumentDB**, complete o painel **Configuração**.
1. **Identificador de cluster:** aceite o nome fornecido pelo Amazon DocumentDB ou insira um nome para o seu cluster, como, por exemplo, **sample-cluster**.
Restrições de nomeação de cluster:
+ 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 todos os clusters no Amazon RDS, Neptune e Amazon DocumentDB por região. Conta da AWS
1. **Versão do mecanismo** — aceite a versão padrão do mecanismo 5.0.0 ou, opcionalmente, escolha 8.0.0, 4.0.0 ou 3.6.0.
1. **Classe da instância:** aceite o padrão `db.r5.large` ou escolha a classe da instância que deseja usar na lista.
1. **Número de instâncias**— na lista, escolha o número de instâncias que você deseja criar com esse cluster. A primeira instância é a instância primária e todas as outras instâncias são instâncias de réplica somente leitura. É possível adicionar e excluir instâncias posteriormente, se necessário. Por padrão, um cluster do Amazon DocumentDB é iniciado com três instâncias (uma primária e duas réplicas).
1. Preencha a seção **Configuração de armazenamento do cluster**.
Escolha **Amazon DocumentDB Padrão** ou **Amazon DocumentDB Otimizado para E/S**. Para obter mais informações, consulte [Configurações de armazenamento de cluster do Amazon DocumentDB](db-cluster-storage-configs.md).
1. Complete o painel **Autenticação**.
1. **Nome de usuário**: insira um nome para o usuário principal. Para fazer login no cluster, você deve usar o nome do usuário principal.
Restrições de nomenclatura de usuário principal:
+ O comprimento é de [1–63] caracteres alfanuméricos.
+ O primeiro caractere deve ser uma letra.
+ Não pode ser uma palavra reservada pelo mecanismo de banco de dados.
1. Escolha uma das opções de senha a seguir:
+ **Gerenciado em AWS Secrets Manager** —Escolha essa opção se quiser AWS Secrets Manager gerenciar automaticamente sua senha de usuário principal.
Se você escolher essa opção, configure a chave do KMS criando sua própria chave ou usando uma chave criada pelo Secrets Manager.
+ **Autogerenciado**: escolha essa opção se quiser autogerenciar sua senha de usuário principal. Se você escolher essa opção, insira uma senha para o usuário principal e, em seguida, confirme-a. Para fazer login no cluster, você deve usar a senha do usuário principal.
Restrições de senha:
+ O comprimento é de [8–100] caracteres ASCII imprimíveis.
+ Pode usar quaisquer caracteres ASCII imprimíveis, exceto:
+ **/** (barra)
+ **"** (aspas duplas)
+ **@** (arroba)
1. Na parte inferior da tela, escolha uma das seguintes opções:
+ Para criar o cluster agora, escolha **Criar cluster**.
+ Para não criar o cluster, escolha **Cancelar**.
+ Para continuar a configurar o cluster antes de criá-lo, escolha **Mostrar configurações adicionais** e, em seguida, [Criar um cluster: configurações adicionais](#db-cluster-create-con-additional-configs).
As configurações incluídas na seção **Configurações adicionais** são as seguintes:
+ **Configurações de rede**— o padrão é usar o grupo de segurança da VPC `default`.
+ **Opções do cluster**— o padrão é utilizar a porta 27017 e o grupo parâmetro padrão.
+ **Criptografia**— o padrão é habilitar a criptografia usando a chave `(default) aws/rds`.
**Importante**
Depois que um cluster é criptografado, ele não pode ser descriptografado.
+ **Backup**— o padrão é reter os backups por 1 dia e permitir que o Amazon DocumentDB selecione a janela de backup.
+ **Exportações de registros** — o padrão é não exportar registros de auditoria para o CloudWatch Logs.
+ **Manutenção**— o padrão é permitir que o Amazon DocumentDB selecione a janela de manutenção.
+ **Proteção contra exclusão**— protege o seu cluster contra a exclusão acidental. O padrão para cluster criado usando o console é *habilitado*.
Se você aceitar os configurações padrão agora, poderá alterar a maioria delas posteriormente modificando o cluster.
1. Habilite a conexão de entrada para o grupo de segurança do cluster.
Se não alterou as configurações padrão do seu cluster, você criou um cluster usando o grupo de segurança padrão para a VPC padrão na região determinada. Para conectar-se ao Amazon DocumentDB, você deve habilitar conexões de entrada na porta 27017 (ou na porta de sua escolha) para o grupo de segurança do cluster.
**Para adicionar uma conexão de entrada ao seu grupo de segurança do cluster**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon EC2 em. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)
1. Na seção **Recursos** da janela principal, escolha **Grupos de segurança**.
![\[Imagem: lista de recursos destacando a opção de link Grupos de Segurança.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/docdb-ec2-security-groups.png)
1. Na lista de grupos de segurança, localize o grupo de segurança que você usou ao criar o cluster (é mais provável o grupo de segurança *padrão*) e escolha a caixa à esquerda do nome do grupo de segurança.
![\[Imagem: lista de grupos de segurança destacando um grupo de segurança com a caixa selecionada.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/docdb-ec2-default-sg.png)
1. No menu **Ações**, escolha **Editar regras de entrada** e, em seguida, escolha ou insira as restrições de regras.
1. **Tipo**— na lista, escolha o protocolo para abrir para o tráfego de rede.
1. **Protocolo**— na lista, escolha o tipo de protocolo.
1. **Intervalo de porta**— para uma regra personalizada, insira um número ou um intervalo de porta. Certifique-se de que o número ou o intervalo de porta inclui a porta que você especificou quando criou o cluster (padrão: 27017).
1. **Origem**— especifica o tráfego que pode alcançar sua instância. Na lista, escolha a origem do tráfego. Se você escolher **Personalizado**, especifique um único endereço IP ou um intervalo de endereços IP em notação CIDR (por exemplo, 203.0.113.5/32).
1. **Descrição**— insira uma descrição para essa regra.
1. Quando terminar de criar a regra, escolha **Salvar**.
### Criar um cluster: configurações adicionais
Se você deseja aceitar as configurações padrão para o seu cluster, pode ignorar as etapas a seguir e escolher **Criar cluster**.
1. Conclua o painel **Configurações de rede**.
![\[Captura de tela mostrando o painel de configurações de rede e as etapas para definir as configurações de rede.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/create-db-cluster-console-network-settings.png)
1. **Nuvem privada virtual (VPC)**— na lista, escolha a nuvem privada virtual Amazon que deseja iniciar nesse cluster.
1. **Grupo de sub-rede**— na lista, escolha o grupo de sub-rede que deseja usar para esse cluster.
1. **Grupos de segurança da VPC**— na lista, escolha o grupo de segurança da VPC para esse cluster.
1. Conclua o painel **Opções do cluster**.
![\[Captura de tela mostrando o painel de opções do cluster com as etapas para definir as configurações do cluster.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/create-db-cluster-console-cluster-options.png)
1. **Porta do banco de dados** — Use as setas para cima e para baixo para definir a TCP/IP porta que os aplicativos usarão para se conectar à sua instância.
1. **Grupo de parâmetros do cluster**— na lista de grupos de parâmetros, escolha o grupo de parâmetros para esse cluster.
1. Preencha o painel **Criptografia**.
![\[Captura de tela do painel de criptografia mostrando as etapas para configurar a criptografia do cluster.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/encrypt-at-rest.png)
1. **E ncryption-at-rest** — Escolha uma das seguintes opções:
+ **Habilitar criptografia**— padrão. Todos os dados em repouso são criptografados. Se optar por criptografar seus dados, você não poderá desfazer essa ação.
+ **Desabilitar criptografia**— seus dados não estão criptografados.
1. **AWS Chave KMS** — Isso só está disponível se você estiver criptografando seus dados. Na lista, escolha a chave que você deseja usar para criptografar os dados desse cluster. O padrão é `(default) aws/rds`.
Se você escolher **Inserir o ARN da chave**, deverá inserir o nome do recurso da Amazon (ARN) da chave.
1. Preencha o painel **Backup**.
![\[Captura de tela do painel Backup mostrando as etapas para configurar a janela de backup do cluster.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/create-db-cluster-console-backup.png)
1. **Período de retenção de backup**— na lista, selecione o número de dias para manter os backups automáticos desse cluster antes de excluí-los.
1. **Janela de backup**— defina o tempo e duração diários durante os quais o Amazon DocumentDB fará backups desse cluster.
1. **Hora de início**: na primeira lista, escolha a hora de início (UTC) para seus backups automáticos. Na segunda lista, escolha o minuto da hora em que você deseja que os backups automáticos sejam iniciados.
1. **Duração**— na lista, selecione a quantidade de horas a serem alocadas na criação de backups automáticos.
1. Preencha o painel **Exportações de registros** selecionando os tipos de registros que você deseja exportar para o CloudWatch Logs.
![\[Captura de tela do painel Exportações de log mostrando as etapas para configurar o registro em log do DML do cluster.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/create-db-cluster-console-log-exports.png)
+ **Registros de auditoria** — Selecione essa opção para permitir a exportação de registros de auditoria para o Amazon CloudWatch Logs. Se você selecionar **Logs de auditoria**, deverá habilitar `audit_logs` no grupo de parâmetros personalizado do cluster. Para obter mais informações, consulte [Auditar eventos do Amazon DocumentDB](event-auditing.md).
+ **Registros do profiler** — Selecione essa opção para permitir a exportação dos logs do profiler da operação para o Amazon Logs. CloudWatch Se você selecionar **Logs do profiler**, deverá também modificar os seguintes parâmetros no grupo de parâmetros personalizado do cluster:
+ `profiler`— defina como `enabled`.
+ `profiler_threshold_ms`— defina como um valor `[0-INT_MAX]` para configurar o limite para operações de criação de perfil.
+ `profiler_sampling_rate`— defina como um valor `[0.0-1.0]` para configurar o percentual de operações lentas para perfilar.
Para obter mais informações, consulte [Definir o perfil das operações do Amazon DocumentDB](profiling.md).
1. Complete o painel **Manutenção**.
![\[Captura de tela do painel Manutenção mostrando as etapas para configurar a janela de manutenção do cluster.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/create-db-cluster-console-maintenance.png)
1. Selecione uma das seguintes opções
+ **Selecionar janela**— você pode especificar o dia da semana, a hora de início em UTC e a duração do Amazon DocumentDB para executar a manutenção do seu cluster.
1. **Dia de início**— na lista, escolha o dia da semana para início da manutenção do cluster.
1. **Hora de início**: nas listas, escolha a hora e minuto (UTC) para iniciar a manutenção.
1. **Duração**— na lista, escolha quanto tempo alocar para a manutenção do cluster. Se a manutenção não puder ser concluída no horário especificado, o processo de manutenção continuará após o horário especificado, até que seja concluída.
+ **Sem preferência**— o Amazon DocumentDB seleciona o dia da semana, o horário de início e a duração para executar a manutenção.
1. Se quiser adicionar uma ou mais tags a esse cluster, preencha o painel **Tags**.
![\[Captura de tela da caixa de seleção Habilitar proteção contra exclusão, que está selecionada.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/create-db-cluster-console-tags.png)
Para cada tag que quiser adicionar ao cluster, repita as etapas a seguir. É possível ter até 10 em um cluster.
1. Selecione **Adicionar tags**.
1. Digite a **Chave** da tag.
1. Opcionalmente, digite o **Valor** da tag.
Para remover uma tag, selecione **Remover tag**.
1. **Proteção contra exclusão** está habilitada por padrão ao criar um cluster usando o console. Para desabilitar a proteção contra exclusão, desmarque **Habilitar proteção contra exclusão**. Quando habilitada, a proteção contra exclusão impede que um cluster seja excluído. Para excluir um cluster protegido contra a exclusão, primeiro é necessário modificar o cluster para desabilitar a proteção contra exclusão.
![\[Captura de tela da caixa de seleção Habilitar proteção contra exclusão, que está selecionada.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/create-db-cluster-console-deletion-protection.png)
Para obter mais informações sobre a proteção contra exclusão, consulte [Excluir um cluster do Amazon DocumentDB](db-cluster-delete.md).
1. Para criar o cluster, escolha **Criar cluster**. Caso contrário, escolha **Cancelar**.
## Criando um cluster usando o AWS CLI
Os procedimentos a seguir descrevem como usar o AWS CLI para iniciar um cluster do Amazon DocumentDB e criar uma réplica do Amazon DocumentDB.
**Parâmetros**
+ **--db-cluster-identifier**—Obrigatório. Uma string com letras minúsculas que identifica esse cluster.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/db-cluster-create.html)
+ **--engine**—Obrigatório. Deve ser **docdb**.
+ **--deletion-protection \$1 --no-deletion-protection**— opcional. Quando a proteção contra exclusão estiver habilitada, ela impede que um cluster seja excluído. Quando você usa o AWS CLI, a configuração padrão é ter a proteção contra exclusão desativada.
Para obter mais informações sobre a proteção contra exclusão, consulte [Excluir um cluster do Amazon DocumentDB](db-cluster-delete.md).
+ **--storage-type standard \$1 iopt1**—Opcional. Padrão: **standard**. Configuração de armazenamento do cluster. Os valores válidos são `standard` (Padrão) ou `iopt1` (Otimizado para E/S).
+ **--master-username**—Obrigatório. O nome do usuário usado para autenticar o usuário.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/db-cluster-create.html)
+ **--master-user-password**—Opcional. A senha do usuário usada para autenticar o usuário.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/db-cluster-create.html)
+ **--manage-master-user-password**— opcional. O Amazon DocumentDB gera a senha do usuário principal e a gerencia durante todo o ciclo de vida no Secrets Manager.
Para ver parâmetros adicionais, consulte [CreateDBCluster](API_CreateDBCluster.md).
**Para iniciar um cluster do Amazon DocumentDB usando o AWS CLI**
Para criar um cluster Amazon DocumentDB, chame o. `create-db-cluster` AWS CLI O AWS CLI comando a seguir cria um cluster Amazon DocumentDB chamado `sample-cluster` com a proteção contra exclusão ativada. Para obter mais informações sobre a proteção contra exclusão, consulte [Excluir um cluster do Amazon DocumentDB](db-cluster-delete.md).
Além disso, `--engine-version` é um parâmetro opcional padrão para a versão mais recente do mecanismo principal. A versão padrão atual do mecanismo é 5.0.0 (observação: o Amazon DocumentDB 8.0 está disponível, mas deve ser explicitamente especificado). Quando novas versões principais do mecanismo forem lançadas, a versão padrão `--engine-version` será atualizada para refletir a última versão principal do mecanismo. Como resultado, para cargas de trabalho de produção, especialmente aquelas que dependem de scripts, automação ou CloudFormation modelos, recomendamos que você especifique explicitamente a `--engine-version` para a versão principal pretendida.
**nota**
Se um `db-subnet-group-name` ou `vpc-security-group-id` não forem especificados, o Amazon DocumentDB usará o grupo de sub-rede padrão e o grupo de segurança do Amazon VPC para a região em questão.
Para Linux, macOS ou Unix:
```
aws docdb create-db-cluster \
--db-cluster-identifier sample-cluster \
--engine docdb \
--engine-version 5.0.0 \
--deletion-protection \
--master-username masteruser \
--master-user-password password
```
Para Windows:
```
aws docdb create-db-cluster ^
--db-cluster-identifier sample-cluster ^
--engine docdb ^
--engine-version 5.0.0 ^
--deletion-protection ^
--master-username masteruser ^
--master-user-password password
```
A saída dessa operação é semelhante ao seguinte (formato JSON).
```
{
"DBCluster": {
"StorageEncrypted": false,
"DBClusterMembers": [],
"Engine": "docdb",
"DeletionProtection" : "enabled",
"ClusterCreateTime": "2018-11-26T17:15:19.885Z",
"DBSubnetGroup": "default",
"EngineVersion": "5.0.0",
"MasterUsername": "masteruser",
"BackupRetentionPeriod": 1,
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"DBClusterIdentifier": "sample-cluster",
"MultiAZ": false,
"DBClusterParameterGroup": "default.docdb5.0",
"PreferredBackupWindow": "09:12-09:42",
"DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY",
"PreferredMaintenanceWindow": "tue:04:17-tue:04:47",
"Port": 27017,
"Status": "creating",
"ReaderEndpoint": "sample-cluster.cluster-ro-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com",
"AssociatedRoles": [],
"HostedZoneId": "ZNKXTT8WH85VW",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"AvailabilityZones": [
"us-east-1a",
"us-east-1c",
"us-east-1e"
],
"Endpoint": "sample-cluster.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com"
}
}
```
Leva alguns minutos para criar o cluster. Você pode usar o Console de gerenciamento da AWS ou AWS CLI para monitorar o status do seu cluster. Para obter mais informações, consulte [Monitoramento do status de um cluster do Amazon DocumentDB](monitoring_docdb-cluster_status.md).
**Importante**
Quando você usa o AWS CLI para criar um cluster Amazon DocumentDB, nenhuma instância é criada. Consequentemente, é necessário criar explicitamente uma instância principal e qualquer instância de réplica de que precise. Você pode usar o console ou AWS CLI criar as instâncias. Para obter mais informações, consulte [Adicionar uma instância do Amazon DocumentDB a um cluster](db-instance-add.md).
Para mais informações, consulte [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_CreateDBCluster.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_CreateDBCluster.html) na *Referência de API do Amazon DocumentDB*.
# Descrever Clusters 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 e grupos de parâmetros relacionados aos seus clusters do Amazon DocumentDB. VPCs
Para saber mais, consulte:
+ [Monitoramento do status de um cluster do Amazon DocumentDB](monitoring_docdb-cluster_status.md)
+ [Localizar os endpoints de um cluster](db-cluster-endpoints-find.md)
------
#### [ Using the Console de gerenciamento da AWS ]
Use o procedimento a seguir para visualizar os detalhes de um cluster especificado do Amazon DocumentDB 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 lista de clusters, escolha o nome do cluster do qual você deseja ver os detalhes. As informações sobre o cluster estão organizadas nos seguintes agrupamentos:
+ **Resumo** — informações gerais sobre o cluster, incluindo a versão do mecanismo, o status do cluster, a manutenção pendente e o status do grupo de parâmetros.
+ **Conectividade e Segurança**: a seção **Conectar** lista os endpoints de conexão para conectar-se a este cluster, com o shell do mongo ou uma aplicação. A seção **Grupos de segurança** lista os grupos de segurança associados a esse cluster, suas descrições e ID da VPC.
+ **Configuração**: a seção **Detalhes do cluster** lista detalhes sobre o cluster, como nome do recurso da Amazon (ARN), o endpoint e o grupo de parâmetros do cluster. Ela também lista as informações de backup do cluster, os detalhes de manutenção e as configurações de segurança e de rede. A seção **Instâncias de cluster** lista as instâncias que pertencem a esse cluster com a função de cada instância e o status do grupo de parâmetros do cluster.
+ **Monitoramento** — As métricas do Amazon CloudWatch Logs para esse cluster. 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 desse cluster. O Amazon DocumentDB mantém um registro de eventos que se relacionam a seus clusters, instâncias, capturas de tela, 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.
------
#### [ Using the AWS CLI ]
Para visualizar os detalhes dos seus clusters 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_DescribeDBClusters.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBClusters.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 filtro `filterName=engine,Values=docdb` retorna somente clusters do Amazon DocumentDB.
**Example**
**Exemplo 1: listar todos os clusters do Amazon DocumentDB**
O AWS CLI código a seguir lista os detalhes de todos os clusters do Amazon DocumentDB em uma região.
```
aws docdb describe-db-clusters --filter Name=engine,Values=docdb
```
A saída dessa operação é semelhante a seguinte.
```
{
"DBClusters": [
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-1",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
},
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-2",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
},
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-3",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
}
]
}
```
**Example**
**Exemplo 2: listar todos os detalhes de um cluster especificado do Amazon DocumentDB**
O AWS CLI código a seguir lista os detalhes do cluster`sample-cluster`.
Para Linux, macOS ou Unix:
```
aws docdb describe-db-clusters \
--filter Name=engine,Values=docdb \
--db-cluster-identifier sample-cluster
```
Para Windows:
```
aws docdb describe-db-clusters ^
--filter Name=engine,Values=docdb ^
--db-cluster-identifier sample-cluster
```
A saída dessa operação é semelhante à seguinte.
```
{
"DBClusters": [
{
"AllocatedStorage": 1,
"AvailabilityZones": [
"us-east-1c",
"us-east-1a",
"us-east-1d"
],
"BackupRetentionPeriod": 2,
"DBClusterIdentifier": "sample-cluster",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
"EarliestRestorableTime": "2023-11-07T22:34:08.148000+00:00",
"Endpoint": "sample-cluster.node.us-east-1.amazon.com",
"ReaderEndpoint": "sample-cluster.node.us-east-1.amazon.com",
"MultiAZ": false,
"Engine": "docdb",
"EngineVersion": "5.0.0",
"LatestRestorableTime": "2023-11-10T07:21:16.772000+00:00",
"Port": 27017,
"MasterUsername": "chimeraAdmin",
"PreferredBackupWindow": "22:22-22:52",
"PreferredMaintenanceWindow": "sun:03:01-sun:03:31",
"ReadReplicaIdentifiers": [],
"DBClusterMembers": [
{
"DBInstanceIdentifier": "sample-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "sample-instance-2",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-9084c2ec",
"Status": "active"
}
],
"HostedZoneId": "Z06853723JYKYBXTJ49RB",
"StorageEncrypted": false,
"DbClusterResourceId": "cluster-T4LGLANHVAPGQYYULWUDKLVQL4",
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"AssociatedRoles": [],
"IAMDatabaseAuthenticationEnabled": false,
"ClusterCreateTime": "2023-11-06T18:05:41.568000+00:00",
"EngineMode": "provisioned",
"DeletionProtection": false,
"HttpEndpointEnabled": false,
"CopyTagsToSnapshot": false,
"CrossAccountClone": false,
"DomainMemberships": [],
"TagList": [],
"StorageType": "iopt1",
"AutoMinorVersionUpgrade": false,
"NetworkType": "IPV4",
"IOOptimizedNextAllowedModificationTime": "2023-12-07T18:05:41.580000+00:00"
}
]
}
```
**Example**
**Exemplo 3: listar os detalhes específicos de um cluster Amazon DocumentDB**
Para listar um subconjunto dos detalhes dos clusters usando o AWS CLI, adicione um `--query` que especifique quais membros do cluster a `describe-db-clusters` operação deve listar. O parâmetro `--db-cluster-identifier` é o identificador do cluster específico do qual você deseja exibir os detalhes. Para obter mais informações, consulte [Como Filtrar a Saída com a Opção `--query`](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output.html#controlling-output-filter) no * Guia de Usuário AWS Command Line Interface *.
O exemplo a seguir lista as instâncias em um cluster do Amazon DocumentDB.
Para Linux, macOS ou Unix:
```
aws docdb describe-db-clusters \
--filter Name=engine,Values=docdb \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterMembers]'
```
Para Windows:
```
aws docdb describe-db-clusters ^
--filter Name=engine,Values=docdb ^
--db-cluster-identifier sample-cluster ^
--query 'DBClusters[*].[DBClusterMembers]'
```
A saída dessa operação é semelhante à seguinte.
```
[
[
[
{
"DBInstanceIdentifier": "sample-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "sample-instance-2",
"IsClusterWriter": false,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
}
]
]
]
```
------
# Modificar um cluster do Amazon DocumentDB
Para modificar um cluster, o mesmo deve estar no estado *disponível*. Você não pode modificar um cluster interrompido. Se o cluster for interrompido, primeiro inicie-o, aguarde até que 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 ]
Use o procedimento a seguir para modificar um cluster Amazon DocumentDB específico usando o console.
**Para modificar um cluster 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. Especifique o cluster que você deseja modificar escolhendo o botão à esquerda do nome do cluster.
1. Escolha **Ações** e, em seguida, **Modificar**.
1. No painel **Modificar cluster: **, faça as alterações desejadas. É possível fazer alterações nas seguintes áreas:
+ **Especificações do cluster**: o nome, os grupos de segurança e o gerenciamento de credenciais do cluster.
+ **Configuração de armazenamento do cluster** — o modo de armazenamento de dados do cluster. Escolha entre a configuração Padrão e Otimizado para E/S.
+ **Opções do cluster**— a porta e o grupo de parâmetros do cluster.
+ **Backup**— o período de retenção e a janela de backup do cluster.
+ **Exportações de log**— habilite ou desabilite exportação dos logs de auditoria ou de profiler.
+ **Manutenção**— defina a janela de manutenção do cluster.
+ **Proteção contra exclusão**— habilite ou desabilite a proteção contra exclusão no cluster. Por padrão, a proteção contra exclusão está habilitada.
1. Ao concluir, escolha **Continuar** para ver um resumo das alterações.
1. Se estiver satisfeito com suas alterações, poderá escolher **Modificar cluster** para modificar o cluster. Como alternativa, você pode escolher **Voltar** ou **Cancelar** para editar ou cancelar as alterações, respectivamente.
Levará alguns minutos para que suas alterações sejam aplicadas. É possível usar o cluster somente quando seu status for *disponível*. É possível monitorar o status do cluster usando o console ou a AWS CLI. Para obter mais informações, consulte [Monitoramento do status de um cluster do Amazon DocumentDB](monitoring_docdb-cluster_status.md).
------
#### [ Using the AWS CLI ]
Use a operação `modify-db-cluster` para modificar o cluster especificado usando a AWS CLI. Para mais informações, consulte [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBCluster.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBCluster.html) na *Referência de API do Amazon DocumentDB*.
**Parâmetros**
+ **--db-cluster-identifier**—Obrigatório. O identificador do cluster do Amazon DocumentDB que você modificará.
+ **--backup-retention-period**— opcional. O número de dias durante os quais os backups automatizados são retidos. Os valores válidos são 1–35.
+ **--storage-type**— opcional. Configuração de armazenamento do cluster. Os valores válidos são `standard` (Padrão) ou `iopt1` (Otimizado para E/S).
+ **--db-cluster-parameter-group-name**— opcional. O nome do grupo de parâmetros do cluster a ser usado.
+ **--manage-master-user-password**— opcional. O Amazon DocumentDB gera a senha do usuário principal e a gerencia durante todo o ciclo de vida no Secrets Manager.
+ **--rotate-master-user-password**—Opcional. O Secrets Manager gera uma nova versão secreta para o segredo existente. A nova versão do segredo contém a nova senha do usuário principal. O Amazon DocumentDB altera a senha do usuário principal do cluster para corresponder à senha para a nova versão do segredo.
É necessário especificar a opção **--apply-immediately** ao alternar a senha principal.
+ **--master-user-password**—Opcional. A nova senha para o usuário do banco de dados primário.
Restrições de senha:
+ O comprimento é de [8–100] caracteres ASCII imprimíveis.
+ Pode usar quaisquer caracteres ASCII imprimíveis, exceto:
+ **/** (barra)
+ **"** (aspas duplas)
+ **@** (arroba)
+ **--new-db-cluster-identifier**— opcional. O novo identificador do cluster durante a renomeação de um cluster. Esse valor é armazenado como uma string em minúsculas.
Restrições de nomenclatura:
+ O comprimento é de [1 a 63] letras, números ou hifens.
+ O primeiro caractere deve ser uma letra.
+ Não pode terminar com um hífen ou conter dois hifens consecutivos.
+ Deve ser exclusivo para todos os clusters do Amazon RDS, Amazon Neptune e Amazon DocumentDB por região. Conta da AWS
+ **--preferred-backup-window**— opcional. O período diário durante o qual backups automatizados são criados, em formato Tempo Universal Coordenado (UTC).
+ Formato: `hh24:mm-hh24:mm`.
+ **--preferred-maintenance-window**— opcional. O intervalo de tempo semanal durante o qual pode ocorrer manutenção do sistema, em UTC.
+ Formato: `ddd:hh24:mm-ddd:hh24:mm`.
+ Dias válidos: `Sun`, `Mon`, `Tue`, `Wed`, `Thu`, `Fri` e `Sat`.
+ **--deletion-protection** ou **--no-deletion-protection**—opcional. Se a proteção contra exclusão deve ser habilitada neste cluster. A proteção contra exclusão impede que um cluster seja excluído acidentalmente até que o cluster seja modificado para desabilitar a proteção contra exclusão. Para obter mais informações, consulte [Excluir um cluster do Amazon DocumentDB](db-cluster-delete.md).
+ **--apply-immediately** ou **--no-apply-immediately**—use `--apply-immediately` para aplicar a alteração imediatamente. Use `--no-apply-immediately` para aplicar a alteração durante a próxima janela de manutenção do cluster.
**Example**
O código a seguir altera o período de retenção de backup para o cluster `sample-cluster`.
Para Linux, macOS ou Unix:
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--apply-immediately \
--backup-retention-period 7
```
Para Windows:
```
aws docdb modify-db-cluster ^
--db-cluster-identifier sample-cluster ^
--apply-immediately ^
--backup-retention-period 7
```
A saída dessa operação é semelhante à seguinte.
```
{
"DBCluster": {
"BackupRetentionPeriod": 7,
"DbClusterResourceId": "cluster-VDP53QEWST7YHM36TTXOPJT5YE",
"Status": "available",
"DBClusterMembers": [
{
"PromotionTier": 1,
"DBClusterParameterGroupStatus": "in-sync",
"DBInstanceIdentifier": "sample-cluster-instance",
"IsClusterWriter": true
}
],
"ReadReplicaIdentifiers": [],
"AvailabilityZones": [
"us-east-1b",
"us-east-1c",
"us-east-1a"
],
"ReaderEndpoint": "sample-cluster.cluster-ro-ctevjxdlur57.us-east-1.rds.amazonaws.com",
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"PreferredMaintenanceWindow": "sat:09:51-sat:10:21",
"EarliestRestorableTime": "2018-06-17T00:06:19.374Z",
"StorageEncrypted": false,
"MultiAZ": false,
"AssociatedRoles": [],
"MasterUsername": "",
"DBClusterIdentifier": "sample-cluster",
"VpcSecurityGroups": [
{
"Status": "active",
"VpcSecurityGroupId": "sg-77186e0d"
}
],
"HostedZoneId": "Z2SUY0A1719RZT",
"LatestRestorableTime": "2018-06-18T21:17:05.737Z",
"AllocatedStorage": 1,
"Port": 27017,
"Engine": "docdb",
"DBClusterParameterGroup": "default.docdb3.4",
"Endpoint": "sample-cluster.cluster-ctevjxdlur57.us-east-1.rds.amazonaws.com",
"DBSubnetGroup": "default",
"PreferredBackupWindow": "00:00-00:30",
"EngineVersion": "3.4",
"ClusterCreateTime": "2018-06-06T19:25:47.991Z",
"IAMDatabaseAuthenticationEnabled": false
}
}
```
Levará alguns minutos para que suas alterações sejam aplicadas. É possível usar o cluster somente quando seu status for *disponível*. É possível monitorar o status do cluster usando o console ou a AWS CLI. Para obter mais informações, consulte [Monitoramento do status de um cluster do Amazon DocumentDB](monitoring_docdb-cluster_status.md).
------
# Determinar manutenção pendente
É possível determinar se você tem a versão mais recente do mecanismo do Amazon DocumentDB determinando se tem manutenção de cluster pendente.
------
#### [ Using the Console de gerenciamento da AWS ]
Você pode usar o Console de gerenciamento da AWS para determinar se um cluster tem manutenção pendente.
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. Localize a coluna **Manutenção** para determinar se um cluster tem manutenção pendente.
![\[Snapshot do console mostrando o campo de manutenção do cluster do Amazon DocumentDB.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/docdb-cluster-pending-maintenance.png)
**Nenhum** indica que o cluster está executando a versão mais recente do mecanismo. **Disponível** indica que o cluster tem manutenção pendente, o que pode significar que é necessária uma atualização do mecanismo.
1. Se o seu cluster tiver a manutenção pendente, prossiga para as etapas em [Executar uma atualização de patch para a versão do mecanismo de um cluster](db-cluster-version-upgrade.md).
------
#### [ Using the AWS CLI ]
Você pode usar o AWS CLI para determinar se um cluster tem a versão mais recente do mecanismo usando a `describe-pending-maintenance-actions` operação com os parâmetros a seguir.
**Parâmetros**
+ **--resource-identifier**— opcional. O ARN do recurso (cluster). Se esse parâmetro for omitido, ações de manutenção pendentes para todos os clusters serão listadas.
+ **--region**— opcional. A Região da AWS na qual você deseja executar essa operação, por exemplo, `us-east-1`.
**Example**
Para Linux, macOS ou Unix:
```
aws docdb describe-pending-maintenance-actions \
--resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster \
--region us-east-1
```
Para Windows:
```
aws docdb describe-pending-maintenance-actions ^
--resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^
--region us-east-1
```
A saída dessa operação é semelhante à seguinte.
```
{
"PendingMaintenanceActions": [
{
"ResourceIdentifier": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"PendingMaintenanceActionDetails": [
{
"Description": "New feature",
"Action": "db-upgrade",
"ForcedApplyDate": "2019-02-25T21:46:00Z",
"AutoAppliedAfterDate": "2019-02-25T07:41:00Z",
"CurrentApplyDate": "2019-02-25T07:41:00Z"
}
]
}
]
}
```
Se o seu cluster tiver a manutenção pendente, prossiga para as etapas em [Executar uma atualização de patch para a versão do mecanismo de um cluster](db-cluster-version-upgrade.md).
------
# Executar uma atualização de patch para a versão do mecanismo de um cluster
Nesta seção, explicaremos como implantar uma atualização de patch usando Console de gerenciamento da AWS o. ou AWS CLI o. Uma atualização de patch é uma atualização dentro da mesma versão do mecanismo (por exemplo, uma versão do mecanismo 3.6 para uma versão mais recente). É possível atualizá-la imediatamente ou durante a próxima janela de manutenção do cluster. Para determinar se seu mecanismo precisa de uma atualização, consulte [Determinar manutenção pendente](db-cluster-determine-pending-maintenance.md). Observe que, ao aplicar a atualização, seu cluster passará por um tempo de inatividade.
**nota**
Se você estiver tentando atualizar a partir de uma versão principal do mecanismo para outra, como 3.6 para 5.0, consulte [Atualização da versão principal implementada do Amazon DocumentDB no local](docdb-mvu.md) ou [Atualizando seu cluster Amazon DocumentDB usando AWS Database Migration Service](docdb-migration.versions.md). Uma atualização local da versão principal oferece suporte apenas ao docdb 5.0 como versão do mecanismo de destino.
Há dois requisitos de configuração para obter as atualizações de patch mais recentes para a versão do mecanismo de um cluster:
+ O status do cluster precisa ser *disponível*.
+ O cluster deve estar executando uma versão de mecanismo mais antiga.
------
#### [ Using the Console de gerenciamento da AWS ]
O procedimento a seguir atualiza a versão de mecanismo do seu cluster para uma versão mais recente usando o console. Você tem a opção de atualizar imediatamente ou durante a próxima janela de manutenção do cluster.
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**. Na lista de clusters, escolha o botão à esquerda do cluster que você deseja atualizar. O status do cluster precisa ser *disponível*.
**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. No menu **Ações**, escolha uma das opções a seguir. Essas opções de menu são selecionáveis somente se o cluster que você escolheu não está executando a versão mais recente do mecanismo.
![\[Imagem: ações de atualização do Amazon DocumentDB\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/docdb-upgrade-action.png)
+ **Atualizar agora**— inicia imediatamente o processo de atualização. Seu cluster ficará offline por um momento, enquanto é atualizado para a versão mais recente do mecanismo.
+ **Atualizar na próxima janela**— inicia o processo de atualização durante a próxima janela de manutenção do cluster. O cluster ficará offline por um momento, enquanto é atualizado para a versão mais recente do mecanismo.
1. Quando a janela de confirmação for aberta, escolha uma das seguintes opções:
+ **Atualizar**— para atualizar seu cluster para a versão mais recente do mecanismo, de acordo com a programação escolhida na etapa anterior.
+ **Cancelar**— para cancelar a atualização do mecanismo do cluster e continuar com a versão atual.
------
#### [ Using the AWS CLI ]
Você pode aplicar atualizações de patch ao seu cluster usando a `apply-pending-maintenance-action` operação AWS CLI e a com os parâmetros a seguir.
**Parâmetros**
+ **--resource-identifier**—Obrigatório. O ARN do cluster do Amazon DocumentDB que você vai atualizar.
+ **--apply-action**—Obrigatório. Os valores a seguir são permitidos. Para atualizar a versão de mecanismo do cluster, use `db-upgrade`.
+ **db-upgrade**
+ **system-update**
+ **--opt-in-type**—Obrigatório. Os valores a seguir são permitidos.
+ `immediate`— aplique a ação de manutenção imediatamente.
+ `next-maintenance`— aplique a ação de manutenção durante a próxima janela de manutenção.
+ `undo-opt-in`— cancele quaisquer solicitações de inclusão `next-maintenance` existentes.
**Example**
O exemplo a seguir atualiza a versão do mecanismo `sample-cluster` para a versão 4.0.0.
Para Linux, macOS ou Unix:
```
aws docdb apply-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:123456789012\:cluster:sample-cluster \
--apply-action db-upgrade \
--opt-in-type immediate
```
Para Windows:
```
aws docdb apply-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^
--apply-action db-upgrade ^
--opt-in-type immediate
```
A saída dessa operação é semelhante à seguinte.
```
{
"ResourcePendingMaintenanceActions": {
"ResourceIdentifier": "arn:aws:rds:us-east-1:444455556666:cluster:docdb-2019-01-09-23-55-38",
"PendingMaintenanceActionDetails": [
{
"CurrentApplyDate": "2019-02-20T20:57:06.904Z",
"Description": "Bug fixes",
"ForcedApplyDate": "2019-02-25T21:46:00Z",
"OptInStatus": "immediate",
"Action": "db-upgrade",
"AutoAppliedAfterDate": "2019-02-25T07:41:00Z"
}
]
}
}
```
------
# Interromper e iniciar um cluster do Amazon DocumentDB
Interromper e iniciar os clusters do Amazon DocumentDB pode ajudar a gerenciar os custos dos ambientes de teste e desenvolvimento. Em vez de criar e excluir clusters e instâncias toda vez que você usar o Amazon DocumentDB, você pode interromper temporariamente todas as instâncias em seu cluster quando elas não forem necessárias. Depois, é possível iniciá-las novamente, ao retomar os testes.
**Topics**
+ [Visão geral de como interromper e iniciar um cluster](#db-cluster-stop-start-overview)
+ [Operações que você pode realizar em um cluster interrompido](#db-cluster-stopped-operations)
## Visão geral de como interromper e iniciar um cluster
Durante os períodos nos quais não precisar de um cluster do Amazon DocumentDB, você pode interromper todas as instâncias nesse cluster de uma só vez. Depois, você pode iniciar o cluster novamente a qualquer momento, sempre que precisar usá-lo. Iniciar e interromper simplifica os processos de configuração e destruição dos clusters usados em desenvolvimento, teste ou atividades afins que não exijam disponibilidade contínua. Você pode parar e iniciar um cluster usando o Console de gerenciamento da AWS ou o AWS CLI com uma única ação, independentemente de quantas instâncias estejam no cluster.
Enquanto o cluster estiver interrompido, o volume de armazenamento do cluster permanece inalterado. Serão cobrados somente o armazenamento, as captura de telas manuais e o armazenamento do backup automatizado dentro da janela de retenção especificada. Não haverá cobrança por horas de instância. O Amazon DocumentDB iniciará automaticamente seu cluster depois de sete dias para garantir que ele não perca nenhuma atualização de manutenção necessária. Quando o cluster reiniciar após sete dias, você será cobrado pelas instâncias novamente. Enquanto o cluster é interrompido, não é possível consultar o volume de armazenamento porque a consulta requer que as instâncias estejam no estado disponível.
Quando um cluster do Amazon DocumentDB é interrompido, nem o cluster nem suas instâncias podem ser modificados, de maneira alguma. Isso inclui adicionar ou remover instâncias, ou excluir o cluster.
------
#### [ Using the Console de gerenciamento da AWS ]
O procedimento a seguir mostra como interromper um cluster com uma ou mais instâncias no estado disponível ou iniciar um cluster interrompido.
**Para interromper ou iniciar um cluster 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. Na lista de clusters, escolha o botão à esquerda do nome do cluster que você deseja interromper ou iniciar.
1. Escolha **Ações** e selecione a ação que deseja executar no cluster.
+ Se você quiser interromper o cluster e ele estiver disponível:
1. Escolha **Parar**.
![\[Imagem: interromper um cluster\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/db-cluster-stop.png)
Para evitar a ativação do mecanismo de failover, a operação de interrupção interrompe primeiro as instâncias de réplica e, depois, a instância primária.
1. Na caixa de diálogo de confirmação, confirme se deseja interromper o cluster, escolhendo **Interromper cluster** ou, para manter o cluster em execução, escolha **Cancelar**.
![\[Imagem: Iniciar um cluster\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/db-cluster-stop-confirm.png)
+ Se quiser iniciar o cluster e o cluster estiver interrompido, escolha **Iniciar**.
![\[Imagem: Iniciar um cluster\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/db-cluster-start.png)
1. Monitore o status do cluster e suas instâncias. Se você iniciou o cluster, poderá retomar o uso do cluster quando ele e suas instâncias estiverem *disponíveis*. Para obter mais informações, consulte [Determinar o status de um cluster](db-cluster-status.md).
![\[Imagem: status de clusters em interrupção e início\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/db-cluster-stop-start-status.png)
------
#### [ Using the AWS CLI ]
Os exemplos de código a seguir mostram como interromper um cluster com uma ou mais instâncias no estado disponível ou iniciar um cluster interrompido.
Para interromper um cluster com uma ou mais instâncias disponíveis usando o AWS CLI, use a `stop-db-cluster` operação. Para iniciar um cluster interrompido, use a operação `start-db-cluster`. Ambas as operações usam o parâmetro `--db-cluster-identifier`.
**Parâmetro**
+ **--db-cluster-identifier**—Obrigatório. O nome do cluster a ser interrompido ou iniciado.
**Example — Para interromper um cluster usando o AWS CLI**
O código a seguir interrompe o cluster `sample-cluster`. O cluster deve ter uma ou mais instâncias no estado disponível.
Para Linux, macOS ou Unix:
```
aws docdb stop-db-cluster \
--db-cluster-identifier sample-cluster
```
Para Windows:
```
aws docdb stop-db-cluster ^
--db-cluster-identifier sample-cluster
```
**Example — Para iniciar um cluster usando o AWS CLI**
O código a seguir inicia o cluster `sample-cluster`. O cluster deve estar interrompido no momento.
Para Linux, macOS ou Unix:
```
aws docdb start-db-cluster \
--db-cluster-identifier sample-cluster
```
Para Windows:
```
aws docdb start-db-cluster ^
--db-cluster-identifier sample-cluster
```
------
## Operações que você pode realizar em um cluster interrompido
Enquanto um cluster do Amazon DocumentDB está parado, você pode fazer uma point-in-time restauração em qualquer ponto dentro da janela de retenção automática de backup especificada. Para obter detalhes sobre como fazer uma point-in-time restauração, consulte[Restauração para um ponto no tempo](backup_restore-point_in_time_recovery.md).
Não é possível modificar a configuração de um cluster do Amazon DocumentDB, ou de qualquer uma de suas instâncias, enquanto o cluster estiver interrompido. Também não é possível adicionar ou remover instâncias do cluster ou excluir o cluster, caso ainda tenha alguma instância associada. Será necessário iniciar o cluster antes de realizar uma dessas ações administrativas.
O Amazon DocumentDB aplicará as manutenções programadas em seu cluster interrompido somente depois que for reiniciado. Após sete dias, o Amazon DocumentDB inicia automaticamente um cluster interrompido, para que não fique muito atrasado em seu status de manutenção. Quando o cluster for reiniciado, você começará a ser cobrado pelas instâncias no cluster novamente.
Enquanto um cluster estiver interrompido, o Amazon DocumentDB não executa quaisquer backups automatizados, nem estende o período de retenção de backup.
# Excluir um cluster do Amazon DocumentDB
Você pode excluir um cluster do Amazon DocumentDB usando o Console de gerenciamento da AWS ou o. AWS CLI Para excluir um cluster, o cluster deve estar no estado *disponível* e não deve ter nenhuma instância associada a ele. Se o cluster foi interrompido, primeiro inicie-o, aguarde até que fique *disponível* e então, exclua-o. Para obter mais informações, consulte [Interromper e iniciar um cluster do Amazon DocumentDB](db-cluster-stop-start.md).
## Deletion protection (Proteção contra exclusão)
Para proteger seu cluster contra a exclusão acidental, você pode habilitar a *proteção contra exclusão*. A proteção contra exclusão está habilitada por padrão ao criar um cluster usando o console. No entanto, a proteção contra exclusão será desabilitada por padrão, se você criar um cluster usando a AWS CLI.
O Amazon DocumentDB aplicará a proteção contra exclusão para um cluster se você executar a operação de exclusão usando o console ou 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.
Ao usar o console com a proteção contra exclusão habilitada em um cluster, não será possível excluir a última instância do cluster, pois isso também excluirá o cluster. É possível excluir a última instância de um cluster protegido contra exclusão usando a AWS CLI. No entanto, o cluster em si ainda existirá e seus dados serão preservados. É possível acessar os dados criando novas instâncias para o cluster. Para obter mais informações sobre como habilitar e desabilitar a proteção contra exclusão, consulte:
+ [Criar um cluster do Amazon DocumentDB](db-cluster-create.md)
+ [Modificar um cluster do Amazon DocumentDB](db-cluster-modify.md)
------
#### [ Using the Console de gerenciamento da AWS ]
Para excluir um cluster usando o Console de gerenciamento da AWS, a proteção contra exclusão deve estar desativada.
**Para determinar se um cluster está com a proteção contra exclusão habilitada:**
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. Observe que, na caixa de navegação Clusters, a coluna **Identificador do cluster** mostra tanto os clusters quanto as instâncias. Suas instâncias estão listadas em clusters, semelhante ao snapshot abaixo.
![\[Imagem: a caixa de navegação Clusters mostrando uma lista dos links de cluster existentes e seus links de instância correspondentes.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/clusters.png)
1. Escolha o nome do cluster e selecione a guia **Configuração**. Na seção **Detalhes do cluster**, localize **Proteção contra exclusão**. Se a proteção contra exclusão estiver habilitada, modifique o cluster para desabilitar a proteção contra exclusão. Para obter informações sobre como modificar um cluster, consulte [Modificar um cluster do Amazon DocumentDB](db-cluster-modify.md).
Após desabilitar a **Proteção contra exclusão**, você estará pronto para excluir o cluster.
**Para excluir um cluster:**
1. No painel de navegação, escolha **Clusters**.
1. Determine se o cluster tem instâncias verificando a coluna **Identificador do cluster** para as instâncias lidas abaixo dele. Antes de excluir um cluster, é necessário excluir todas as instâncias. Para obter mais informações, consulte [Excluir uma instância do Amazon DocumentDB](db-instance-delete.md).
1. Dependendo de o cluster ter ou não instâncias, realize uma das seguintes etapas.
+ Se o cluster não tiver instâncias, selecione o botão à esquerda do nome do cluster e escolha **Ações**. No menu suspenso, escolha **Excluir**. Preencha a caixa de diálogo **Excluir ** e escolha **Excluir**.
+ Se o cluster tiver uma ou mais instâncias, faça o seguinte:
1. No painel de navegação, escolha **Clusters**.
1. Exclua cada uma das instâncias do cluster escolhendo a caixa de seleção à esquerda do nome do cluster. Selecione **Ações** e escolha **Excluir**. Preencha a caixa de diálogo **Excluir ** e escolha **Excluir**.
Ao excluir a última instância, o cluster também será excluído. Para obter informações sobre a exclusão de instâncias, consulte [Excluir uma instância do Amazon DocumentDB](db-instance-delete.md).
A exclusão do cluster demora alguns minutos. Para monitorar o status do cluster, consulte [Monitoramento do status de um cluster do Amazon DocumentDB](monitoring_docdb-cluster_status.md).
------
#### [ Using the AWS CLI ]
Não é possível excluir um cluster que tenha instâncias associadas a ele. Para determinar quais instâncias estão associadas ao cluster, execute o comando `describe-db-clusters` e exclua todas as instâncias do cluster. Depois, se necessário, desabilite a proteção contra exclusão no cluster e, finalmente, exclua o cluster.
1. **Primeiro, exclua todas as instâncias do cluster.**
Para determinar quais instâncias você precisa excluir, execute o comando a seguir.
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]'
```
A saída dessa operação é semelhante ao seguinte (formato JSON).
```
[
[
"sample-cluster",
[
"sample-instance-1",
"sample-instance-2"
]
]
]
```
Se o cluster que você deseja excluir tiver instâncias, exclua-as conforme abaixo.
```
aws docdb delete-db-instance \
--db-instance-identifier sample-instance
```
1. **Em segundo lugar, desabilite a proteção contra exclusão**.
Usar o AWS CLI para excluir todas as instâncias de um cluster não exclui o cluster. Também é necessário excluir o cluster, mas isso só poderá ser feito se a proteção contra exclusão estiver desabilitada.
Para determinar se o cluster está com a proteção contra exclusão habilitada, execute o comando a seguir.
**dica**
Para ver o status da proteção contra exclusão de todos os clusters do Amazon DocumentDB, omita o parâmetro `--db-cluster-identifier`.
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DeletionProtection]'
```
A saída dessa operação é semelhante à seguinte.
```
[
[
"sample-cluster",
"true"
]
]
```
Se o cluster estiver com a proteção contra exclusão habilitada, modifique o cluster e desabilite a proteção contra exclusão. Para desabilitar a proteção contra exclusão no cluster, use o comando a seguir.
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--no-deletion-protection \
--apply-immediately
```
1. **Para finalizar, exclua o cluster.**
Após desabilitar a proteção contra exclusão, você estará pronto para excluir o cluster. Para excluir um cluster, use a operação `delete-db-cluster` com os parâmetros a seguir.
+ **--db-cluster-identifier**—Obrigatório. O identificador do cluster que deseja excluir.
+ **--final-db-snapshot-identifier**— opcional. Se você quiser uma captura de tela final, inclua esse parâmetro com um nome para a captura de tela final. É necessário incluir `--final-db-snapshot-identifier` ou `--skip-final-snapshot`.
Restrições de nomenclatura:
+ O comprimento é de [1 a 63] letras, números ou hifens.
+ O primeiro caractere deve ser uma letra.
+ Não pode terminar com um hífen ou conter dois hifens consecutivos.
+ Deve ser exclusivo para todos os clusters do Amazon RDS, Amazon Neptune e Amazon DocumentDB por região. Conta da AWS
+ **--skip-final-snapshot**— opcional. Use esse parâmetro somente se não quiser obter um captura de tela final antes de excluir seu cluster. A configuração padrão é obter uma captura de tela final. É necessário incluir `--final-db-snapshot-identifier` ou `--skip-final-snapshot`.
O AWS CLI código a seguir exclui o cluster `sample-cluster` com um instantâneo final. A operação falhará se houver instâncias associadas ao cluster ou se a proteção contra exclusão estiver desabilitada.
**Example**
Para Linux, macOS ou Unix:
```
aws docdb delete-db-cluster \
--db-cluster-identifier sample-cluster \
--final-db-snapshot-identifier sample-cluster-final-snapshot
```
Para Windows:
```
aws docdb delete-db-cluster ^
--db-cluster-identifier sample-cluster ^
--final-db-snapshot-identifier sample-cluster-final-snapshot
```
**Example**
O AWS CLI código a seguir exclui o cluster `sample-cluster` sem tirar um instantâneo final.
Para Linux, macOS ou Unix:
```
aws docdb delete-db-cluster \
--db-cluster-identifier sample-cluster \
--skip-final-snapshot
```
Para Windows:
```
aws docdb delete-db-cluster ^
--db-cluster-identifier sample-cluster ^
--skip-final-snapshot
```
A saída da operação `delete-db-cluster` é o cluster que você está excluindo.
A exclusão do cluster demora alguns minutos. Para monitorar o status do cluster, consulte [Monitorar o status de um cluster](monitoring_docdb-cluster_status.md).
------
# Escalar clusters do Amazon DocumentDB
O Amazon DocumentDB permite escalar o armazenamento e a computação nos clusters com base em suas necessidades. Esta seção descreve como você pode escalar armazenamento, instância e leitura, para gerenciar o desempenho e a escala dos clusters e das instâncias do Amazon DocumentDB.
**Topics**
+ [Escalabilidade de armazenamento](#db-cluster-manage-scaling-storage)
+ [Escalabilidade de instâncias](#db-cluster-manage-scaling-instance)
+ [Escalabilidade de leitura](#db-cluster-manage-scaling-reads)
+ [Gravar escalabilidade](#db-cluster-manage-scaling-writes)
## Escalabilidade de armazenamento
O armazenamento do Amazon DocumentDB escala automaticamente com os dados no volume do cluster. À medida que seu volume de dados aumentar, o armazenamento do volume do cluster aumentará em incrementos de 10 GiB, até 128 TiB.
## Escalabilidade de instâncias
É possível escalar o cluster do Amazon DocumentDB conforme a necessidade e modificar a classe da instância para cada instância do cluster. O Amazon DocumentDB oferece suporte a várias classes de instância otimizadas.
Para obter mais informações, consulte [Modificar uma instância do Amazon DocumentDB](db-instance-modify.md).
## Escalabilidade de leitura
É possível obter uma escala de leitura para o cluster do Amazon DocumentDB criando até 15 réplicas do Amazon DocumentDB no cluster. Cada réplica do Amazon DocumentDB retornará os mesmos dados do volume de cluster com atraso de réplica mínimo — geralmente inferior a 100 milissegundos após a instância principal ter gravado uma atualização. Conforme o tráfego de leitura aumenta, você pode criar réplicas adicionais do Amazon DocumentDB e conectar-se a elas para distribuir a carga de leitura para o seu cluster. As réplicas do Amazon DocumentDB não precisam ser da mesma classe da instância primária.
Para obter mais informações, consulte [Adicionar uma instância do Amazon DocumentDB a um cluster](db-instance-add.md).
Para escalar leitura com o Amazon DocumentDB, recomendamos que você se conecte ao seu cluster como um conjunto de réplicas e distribua as leituras para instâncias de réplica usando os recursos internos de preferência de leitura do seu driver. Para obter mais informações, consulte [Conectar-se ao Amazon DocumentDB como um conjunto de réplicas](connect-to-replica-set.md).
## Gravar escalabilidade
É possível escalar a capacidade de gravação no cluster do Amazon DocumentDB aumentando o tamanho da instância principal do cluster. Esta seção fornece dois métodos para escalar a instância principal do cluster com base em suas necessidades. A primeira opção procura minimizar o impacto na aplicação, mas exige que mais etapas sejam concluídas. A segunda opção otimiza visando simplicidade, pois tem menos etapas, mas, em compensação, representa potencial impacto maior na aplicação.
De acordo com a aplicação, você pode escolher qual abordagem abaixo é a melhor para você. Para obter mais informações sobre custos e tamanhos de instância disponíveis, consulte a página [Definição de preço do Amazon DocumentDB Pricing](https://aws.amazon.com/documentdb/pricing/).
1. **Otimize para alta disponibilidade e desempenho**: se estiver se conectando ao cluster em [modo de conjunto de réplica](connect-to-replica-set.md) (recomendado), você pode usar o processo a seguir para minimizar o impacto na aplicação ao escalar a instância principal. Esse método minimiza o impacto porque mantém o cluster em alta disponibilidade ou acima, e os destinos em escala de leitura são adicionados ao cluster como instâncias, em vez de atualizados no local.
1. Adicione uma ou mais réplicas do tipo de instância maior ao seu cluster (consulte [Adicionar uma instância do Amazon DocumentDB a um cluster](db-instance-add.md)). Recomendamos que todas as réplicas sejam do mesmo tipo de instância ou maior que a principal. Isso evita que uma redução não intencional no desempenho de gravação execute failover para um tipo de instância menor. Para a maioria dos clientes, isso significa duplicar temporariamente o número de instâncias no cluster e, depois, remover as réplicas menores após a conclusão da escala.
1. Defina o nível de failover em todas as réplicas novas como prioridade zero, de forma a garantir que uma réplica do tipo de instância menor tenha a maior prioridade de failover. Para obter mais informações, consulte [Controlar o destino de failover](failover.md#failover-target_control).
1. Inicie um failover manual, o que promoverá uma das novas réplicas a instância principal. Para obter mais informações, consulte [Testar o failover](failover.md#failover-testing).
**nota**
Isso incorrerá em aproximadamente 30 segundos de tempo de inatividade para o cluster. Planeje adequadamente.
1. Remova do cluster todas as réplicas de um tipo de instância menor que a nova principal.
1. Defina o nível de failover de todas as instâncias de volta para a mesma prioridade (geralmente, isso significa defini-las de volta a 1).
Como exemplo, vamos supor que você tenha um cluster com três instâncias `r5.large` (uma principal e duas réplicas), e que deseje escalar para um tipo de instância `r5.xlarge`. Para fazê-lo, primeiro adicione três instâncias de réplica `r5.xlarge` ao seu cluster e defina o nível de failover das novas réplicas `r5.xlarge` como zero. Depois, inicie um failover manual (considerando que a aplicação terá aproximadamente 30 segundos de tempo de inatividade). Quando o failover for concluído, remova todas as três instâncias `r5.large` do cluster deixando-o escalado para instâncias `r5.xlarge`.
Para ajudar a otimizar os custos, as instâncias do Amazon DocumentDB são cobradas em incrementos de um segundo, com uma cobrança mínima de dez minutos após uma alteração no status de faturamento, como criação, modificação ou exclusão de uma instância. Para obter mais informações, consulte [Otimização de custos](best_practices.md#best_practices-cost_optimization) na documentação de práticas recomendadas.
1. **Otimize para simplificar** — essa abordagem otimiza para simplicidade. Ela não expande nem contrai o cluster, mas pode reduzir temporariamente sua capacidade de leitura.
É possível que a alteração da classe da instância de uma réplica faça com que a mesma não atenda as solicitações por um breve período, de alguns segundos a menos de 30 segundos. Se você estiver se conectando ao seu cluster no [modo de conjunto de réplicas](connect-to-replica-set.md) (recomendado), isso reduzirá sua capacidade de leitura em uma réplica (por exemplo, para 66% da capacidade em um cluster de 3 nós, ou 75% da capacidade em um cluster de 4 nós, etc.) durante a operação em escala.
1. Escale uma das instâncias de réplica no seu cluster. Para obter mais informações, consulte [Gerenciar classes de instância](db-instance-classes.md).
1. Espere até que a instância esteja disponível (consulte [Monitoramento do status de uma instância do Amazon DocumentDB](monitoring_docdb-instance_status.md)).
**nota**
Isso incorrerá em aproximadamente 30 segundos de tempo de inatividade para o cluster. Planeje adequadamente.
1. Continue executando as etapas 1 e 2 até que todas as instâncias de réplicas tenham sido escaladas, uma a uma.
1. Iniciar um failover manual. Isso promoverá uma das réplica à instância principal. Para obter mais informações, consulte [Failover do Amazon DocumentDB](failover.md).
**nota**
Isso resultará em até 30 segundos de inatividade para seu cluster, mas, geralmente leva menos tempo do que isso. Planeje adequadamente.
1. Escale a antiga instância primária (agora, uma réplica).
# Clonar um volume para um cluster Amazon DocumentDB
Com a clonagem do Amazon DocumentDB, você pode criar um cluster que use o mesmo volume de cluster do Amazon DocumentDB e contenha os mesmos dados do original. O processo foi projetado para ser rápido e econômico. O novo cluster e seu volume de dados associado é chamado de *clone*.. Criar um clone é mais rápido e eficiente em termos de espaço do que copiar fisicamente os dados usando outras técnicas, como restauração ou captura de tela.
O Amazon DocumentDB oferece suporte à criação de um clone provisionado do Amazon DocumentDB por meio de um cluster provisionado do Amazon DocumentDB. Quando você cria um clone usando uma configuração de implantação diferente da origem, o clone é criado usando a versão mais recente do mecanismo Amazon DocumentDB de origem.
Quando você cria clones a partir de seus clusters do Amazon DocumentDB, os clones são criados na AWS sua conta — a mesma conta que possui o cluster Amazon DocumentDB de origem.
**Topics**
+ [Visão geral da clonagem do Amazon DocumentDB](#db-cloning-overview)
+ [Limitações da clonagem do Amazon DocumentDB](#db-cloning-limitations)
+ [Como funciona a clonagem do Amazon DocumentDB](#db-how-db-cloning-works)
+ [Criar um clone do Amazon DocumentDB](#db-creating-db-clone)
## Visão geral da clonagem do Amazon DocumentDB
O Amazon DocumentDB usa um *copy-on-write protocolo* para criar um clone. Esse mecanismo usa um espaço adicional mínimo para criar um clone inicial. Quando o clone é criado pela primeira vez, o Amazon DocumentDB mantém uma única cópia dos dados usados pelo cluster de origem do Amazon DocumentDB e pelo novo cluster (clonado) do Amazon DocumentDB. O armazenamento adicional é alocado somente quando as alterações são feitas nos dados (no volume de armazenamento do Amazon DocumentDB) pelo cluster de origem do Amazon DocumentDB, ou pelo clone do cluster do Amazon DocumentDB. Para saber mais sobre o copy-on-write protocolo, consulte[Como funciona a clonagem do Amazon DocumentDB](#db-how-db-cloning-works).
A clonagem do Amazon DocumentDB é útil principalmente para configurar rapidamente ambientes de teste usando seus dados de produção, sem o risco de corromper dados. É possível utilizar clones para vários tipos de aplicações, como:
+ Experimente possíveis alterações (de esquema e de grupos de parâmetros, por exemplo) para avaliar todos os impactos.
+ Execute operações com workloads intensivas, como exportar dados ou executar consultas analíticas no clone.
+ Crie uma cópia do cluster de banco de dados de produção para desenvolvimento, teste ou outras finalidades.
É possível criar mais de um clone do mesmo cluster Amazon DocumentDB. Também é possível criar vários clones a partir de outro.
Depois de criar um clone do Amazon DocumentDB, você pode configurar suas instâncias de modo diferente do cluster de origem. Por exemplo, talvez você não precise que um clone para fins de desenvolvimento atenda aos mesmos requisitos de alta disponibilidade que o cluster de produção de origem Amazon DocumentDB. Nesse caso, é possível configurar o clone com uma única instância Amazon DocumentDB em vez de várias instâncias DB usadas pelo cluster Amazon DocumentDB.
Ao concluir o uso do clone para seus testes, desenvolvimento, ou outras finalidades, será possível excluí-lo.
## Limitações da clonagem do Amazon DocumentDB
Atualmente, a clonagem do Amazon DocumentDB; tem as seguintes limitações:
+ É possível criar quantos clones quiser, até o número máximo de clusters DB permitido na Região da AWS. No entanto, depois 15 clones, o próximo será uma cópia completa. A operação de clonagem funciona como uma point-in-time recuperação.
+ Você não pode criar um clone em uma AWS região diferente do cluster Amazon DocumentDB de origem.
+ Não é possível criar um clone a partir de um cluster Amazon DocumentDB sem instâncias. Só é possível clonar clusters Amazon DocumentDB que tenham pelo menos uma instância DB.
+ É possível criar um clone em uma nuvem privada virtual (VPC) diferente daquela do cluster Amazon DocumentDB. Se você fizer isso, as sub-redes do VPCs devem ser mapeadas para as mesmas zonas de disponibilidade.
## Como funciona a clonagem do Amazon DocumentDB
A clonagem do Amazon DocumentDB funciona na camada de armazenamento de um cluster do Amazon DocumentDB. Ele usa um *copy-on-write*protocolo que é rápido e economiza espaço em termos da mídia durável subjacente que suporta o volume de armazenamento do Amazon DocumentDB. Saiba mais sobre os volumes de cluster do Amazon DocumentDB em [Gerenciar clusters do Amazon DocumentDB](db-clusters.md).
**Topics**
+ [Entendendo o copy-on-write protocolo](#db-copy-on-write-protocol)
+ [Excluir um volume de cluster de origem](#db-deleting-source-cluster-volume)
### Entendendo o copy-on-write protocolo
Um cluster do Amazon DocumentDB armazena dados em páginas do volume de armazenamento subjacente Amazon DocumentDB.
Por exemplo, no diagrama a seguir, você descobre um cluster Amazon DocumentDB (A) com quatro páginas de dados: 1, 2, 3 e 4. Imagine que um clone, B, é criado a partir do cluster do Amazon DocumentDB. Quando o clone é criado, nenhum dado é copiado. Em vez disso, o clone aponta para o mesmo conjunto de páginas que o cluster Amazon DocumentDB de origem.
![\[O volume do cluster do Amazon DocumentDB, com 4 páginas para o cluster de origem A e o clone B\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-1.png)
Quando o clone é criado, geralmente não é necessário armazenamento adicional. O copy-on-write protocolo usa o mesmo segmento na mídia de armazenamento físico que o segmento de origem. O armazenamento adicional é necessário somente se a capacidade do segmento de origem não for suficiente para todo o segmento do clone. Se for esse o caso, o segmento de origem será copiado para outro dispositivo físico.
Nos diagramas a seguir, você pode encontrar um exemplo do copy-on-write protocolo em ação usando o mesmo cluster A e seu clone, B, conforme mostrado anteriormente. Digamos que você faça uma alteração no cluster do Amazon DocumentDB (A) que resulte em uma alteração nos dados mantidos na página 1. Em vez de gravar na página 1 original, o Amazon DocumentDB cria uma nova página, 1[A]. O volume do cluster Amazon DocumentDB para o cluster (A) agora aponta para a página 1[A], 2, 3 e 4, enquanto o clone (B) ainda faz referência às páginas originais.
![\[Volume de cluster de origem do Amazon DocumentDB e seu clone, ambos com alterações.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-2.png)
No clone, uma alteração é feita na página 4, no volume de armazenamento. Em vez de gravar na página 4 original, o Amazon DocumentDB cria uma nova página, 4[B]. O clone agora aponta para as páginas 1, 2, 3 e para a página 4[B], enquanto o cluster (A) continua apontando para 1[A], 2, 3 e 4.
![\[Volume de cluster de origem do Amazon DocumentDB e seu clone, ambos com alterações.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-3.png)
À medida que ocorrerem mais alterações ao longo do tempo no volume do cluster do Amazon DocumentDB original e no clone, será necessário mais armazenamento incremental para capturar e armazenar as alterações.
### Excluir um volume de cluster de origem
Quando você exclui um volume do cluster de origem com um ou mais clones associados a ele, os clones não são afetados. Os clones continuam a apontar para as páginas que pertenciam anteriormente ao volume do cluster de origem.
## Criar um clone do Amazon DocumentDB
Você pode criar um clone na mesma AWS conta do cluster Amazon DocumentDB de origem. Para fazer isso, você pode usar o Console de gerenciamento da AWS ou o AWS CLI e os procedimentos a seguir.
Ao usar a clonagem do Amazon DocumentDB, você pode criar um clone provisionado por meio de um cluster provisionado do Amazon DocumentDB.
------
#### [ Using the Console de gerenciamento da AWS ]
O procedimento a seguir descreve como clonar um cluster Amazon DocumentDB usando Console de gerenciamento da AWS.
Criação de um clone usando os Console de gerenciamento da AWS resultados em um cluster do Amazon DocumentDB com uma instância do Amazon DocumentDB.
Essas instruções se aplicam aos clusters de banco de dados pertencentes à mesma AWS conta que está criando o clone. O cluster de banco de dados deve pertencer à mesma AWS conta, pois a clonagem entre contas não é suportada no Amazon DocumentDB.
**Para criar um clone de um cluster de banco de dados de propriedade da sua AWS conta usando o Console de gerenciamento da AWS**
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**.
1. Escolha seu cluster Amazon DocumentDB da lista e em **Ações**, escolha **Criar clone**.
![\[A criação de um clone começa ao selecionar seu cluster Amazon DocumentDB.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/db-cloning-create-clone-1.png)
Na página Criar clone aberta, é possível configurar um **Identificador de Cluster** e uma **Classe de instância**, além de outras opções para o clone de cluster do Amazon DocumentDB.
1. Na seção **Configurações**, faça o seguinte:
1. Em **Identificador de cluster**, insira o nome que deseja dar ao cluster Amazon DocumentDB clonado.
1. Em **Configuração da instância**, selecione uma **Classe de instância** apropriada para seu cluster Amazon DocumentDB clonado.
![\[A criação de um clone começa selecionando seu cluster Amazon DocumentDB e especificando o tamanho da instância DB.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/db-cloning-create-clone-2.png)
1. Em **Configurações de rede**, escolha um **Grupo de sub-rede** para seu caso de uso e os grupos de segurança VPC associados.
1. Para **E ncryption-at-rest**, se o cluster de origem (o cluster que está sendo clonado) tiver a criptografia ativada, o cluster clonado também deverá ter a criptografia ativada. Se esse cenário for verdadeiro, as opções **Ativar criptografia** permanecerão na cor cinza (desativadas), mas com a opção **Ativar criptografia** selecionada. Por outro lado, se o cluster de origem não estiver com a criptografia habilitada, as opções **Ativar criptografia** estarão disponíveis e será possível optar por ativar ou desativar a criptografia.
![\[Especifique as configurações de rede e criptografia para seu clone de cluster do Amazon DocumentDB.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/db-cloning-create-clone-3-nw-encryption.png)
1. Conclua a nova configuração do clone do cluster selecionando os tipos de logs a serem exportados (opcional) e inserindo uma porta específica, usada para se conectar ao cluster e ativar a proteção contra a exclusão acidental do cluster (ativada por padrão).
![\[Conclua a nova configuração do clone do cluster selecionando opcionalmente os tipos de logs a serem exportados. Insira uma porta específica usada para se conectar ao cluster e ative a proteção contra a exclusão acidental do cluster.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/db-cloning-create-clone-4-log-options-del-prot-b.png)
1. Termine de inserir todas as configurações do clone do cluster Amazon DocumentDB. Para saber mais sobre as configurações de cluster e instância Amazon DocumentDB, consulte [Gerenciar clusters do Amazon DocumentDB](db-clusters.md).
1. Escolha **Criar clone** para iniciar o clone do Amazon DocumentDB do cluster Amazon DocumentDB escolhido.
Ao ser criado, o clone é listado com seus outros clusters Amazon DocumentDB na seção **Bancos de dados** do console e exibe seu estado atual. O clone estará pronto para uso quando o estado for **Disponível**.
------
#### [ Using the AWS CLI ]
Usar o AWS CLI para clonar seu cluster Amazon DocumentDB envolve algumas etapas.
O `restore-db-cluster-to-point-in-time` AWS CLI comando que você usa resulta em um cluster vazio do Amazon DocumentDB com 0 instâncias do Amazon DocumentDB. Ou seja, o comando restaura apenas o cluster Amazon DocumentDB, não as instâncias desse cluster. Faça isso separadamente depois que o clone estiver disponível. As duas etapas do processo são:
1. Crie o clone usando o comando [restore-db-cluster-to- point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html) CLI. Os parâmetros usados com esse comando controlam o tipo de capacidade e outros detalhes do cluster Amazon DocumentDB vazio (clone) sendo criado.
1. Crie a instância do Amazon DocumentDB para o clone usando o comando [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)CLI para recriar a instância do Amazon DocumentDB no cluster restaurado do Amazon DocumentDB.
Os comandos a seguir pressupõem que o AWS CLI esteja configurado com sua AWS região como padrão. Essa abordagem evita que você passe pelo nome `--region` em cada um dos comandos. Para obter mais informações, consulte [Configurar a AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html). Também é possível especificar `--region` em cada um dos comandos da CLI seguintes.
**Topics**
**Criar o clone**
Os parâmetros específicos que você passa para o comando `[restore-db-cluster-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html)` da CLI variam. O que será transmitido depende do tipo de clone que você quer criar.
Use o procedimento a seguir para criar um clone provisionado do Amazon DocumentDB de um cluster provisionado.
**Para criar um clone no mesmo modo de mecanismo que o cluster Amazon DocumentDB original**
+ Use o comando `[restore-db-cluster-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html)` da CLI e especifique valores para os seguintes parâmetros:
+ `--db-cluster-identifier` — escolha um nome significativo para o clone. Você nomeia o clone ao usar o comando [restore-db-cluster-to- point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html) CLI.
+ `--restore-type` — use `copy-on-write` para criar um clone do cluster DB de origem. Sem esse parâmetro, `restore-db-cluster-to-point-in-time` restaura o cluster Amazon DocumentDB em vez de criar um clone. O padrão para `restore-type` é `full-copy`.
+ `--source-db-cluster-identifier` — use o nome do cluster Amazon DocumentDB de origem que deseja clonar.
+ `--use-latest-restorable-time` — esse valor aponta para dados de volume restauráveis mais recentes para o clone. Esse parâmetro é necessário para `restore-type copy-on-write`. No entanto, você não pode usar o `restore-to-time parameter` com ele.
O exemplo a seguir mostra a criação de um clone chamado `my-clone` a partir de um cluster chamado `my-source-cluster`.
Para Linux, macOS ou Unix:
```
aws docdb restore-db-cluster-to-point-in-time \
--source-db-cluster-identifier my-source-cluster \
--db-cluster-identifier my-clone \
--restore-type copy-on-write \
--use-latest-restorable-time
```
Para Windows:
```
aws docdb restore-db-cluster-to-point-in-time ^
--source-db-cluster-identifier my-source-cluster ^
--db-cluster-identifier my-clone ^
--restore-type copy-on-write ^
--use-latest-restorable-time
```
O comando retorna o objeto JSON que contém detalhes do clone. Verifique se o cluster clonado está disponível antes de tentar criar a instância DB para o seu clone. Para obter mais informações, consulte Verificar o status e obter detalhes do clone abaixo:
**Verificar o status e obter detalhes do clone**
É possível usar o comando a seguir para verificar o status do cluster dDB vazio recém-criado.
```
$ aws docdb describe-db-clusters --db-cluster-identifier my-clone --query '*[].[Status]' --output text
```
Ou você pode obter o status e os outros valores necessários para criar a instância de banco de dados para seu clone usando a seguinte AWS CLI consulta:
Para Linux, macOS ou Unix:
```
aws docdb describe-db-clusters --db-cluster-identifier my-clone \
--query '*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}'
```
Para Windows:
```
aws docdb describe-db-clusters --db-cluster-identifier my-clone ^
--query "*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}"
```
Essa consulta retorna uma saída semelhante à saída abaixo.
```
[
{
"Status": "available",
"Engine": "docdb",
"EngineVersion": "4.0.0",
}
]
```
**Criar a instância do Amazon DocumentDB para seu clone**
Use o comando [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)CLI para criar a instância de banco de dados para seu clone.
O parâmetro `--db-instance-class` é usado para provisionar apenas clusters Amazon DocumentDB.
Para Linux, macOS ou Unix:
```
aws docdb create-db-instance \
--db-instance-identifier my-new-db \
--db-cluster-identifier my-clone \
--db-instance-class db.r5.4xlarge \
--engine docdb
```
Para Windows:
```
aws docdb create-db-instance ^
--db-instance-identifier my-new-db ^
--db-cluster-identifier my-clone ^
--db-instance-class db.r5.4xlarge ^
--engine docdb
```
**Parâmetros a serem usados para clonagem**
A tabela a seguir resume os vários parâmetros usados com `restore-db-cluster-to-point-in-time` para clonar clusters Amazon DocumentDB.
| Parâmetro | Description |
| --- | --- |
| --source-db-cluster-identifier | Use o nome do cluster Amazon DocumentDB original que deseja clonar. |
| --db-cluster-identifier | Escolha um nome significativo para o clone. Nomeie seu clone com o comando ` restore-db-cluster-to-point-in-time`. Em seguida, passe esse nome para o comando `create-db-instance`. |
| --restore-type | Especifique `copy-on-write` como `--restore-type` para criar um clone do cluster Amazon DocumentDB original em vez de restaurar o cluster original. |
| --use-latest-restorable-time | Esse valor aponta para os dados de volume restauráveis mais recentes para o clone. |
------
# Entender a tolerância a falhas de cluster do Amazon DocumentDB
Os clusters do Amazon DocumentDB são tolerantes a falhas por design. O volume de cada cluster abrange várias zonas de disponibilidade em uma única Região da AWS, e cada zona de disponibilidade contém uma cópia dos dados do volume do cluster. Esta funcionalidade significa que seu cluster pode tolerar a falha de uma Zona de Disponibilidade sem perder dados, com apenas uma breve interrupção do serviço.
Se a instância primária em um cluster falhar, o Amazon DocumentDB fará failover automaticamente para uma nova instância primária, de uma dessas duas maneiras:
+ Ao promover uma réplica existente do Amazon DocumentDB para a nova instância principal e, em seguida, criar uma substituição para a réplica anterior. Um failover para a instância de réplica normalmente leva menos de 30 segundos. As operações de leitura e gravação poderão sofrer uma breve interrupção durante esse período. Para aumentar a disponibilidade do seu cluster, recomendamos que você crie pelo menos uma ou mais réplicas do Amazon DocumentDB em duas ou mais Zonas de Disponibilidade diferentes.
+ Criar uma nova instância principal. Isso só acontecerá se você não tiver uma instância de réplica em seu cluster, e pode levar alguns minutos para ser concluída.
Se o cluster tiver uma ou mais réplicas do Amazon DocumentDB, uma réplica do Amazon DocumentDB será promovida à instância principal durante um evento de falha. Um evento de falha resulta em uma breve interrupção, durante a qual as operações de leitura e gravação falham com uma exceção. No entanto, o serviço é restaurado normalmente em menos de 120 segundos, muitas vezes, em menos de 60 segundos. Para aumentar a disponibilidade do seu cluster, recomendamos que você crie pelo menos uma ou mais réplicas do Amazon DocumentDB em duas ou mais Zonas de Disponibilidade diferentes.
É possível personalizar a ordem na qual suas réplicas do Amazon DocumentDB são promovidas à instância primária após uma falha atribuindo uma prioridade a cada réplica. As prioridades variam de 0, para a prioridade mais alta, a 15, para a prioridade mais baixa. Se a instância principal falhar, a réplica do Amazon DocumentDB com a prioridade mais alta será promovida à nova instância principal. É possível modificar a prioridade de uma réplica do Amazon DocumentDB a qualquer momento. Modificar a prioridade não desencadeia um failover. É possível usar a operação `modify-db-instance` com o parâmetro `--promotion-tier`. Para obter mais informações sobre como personalizar a prioridade de failover de uma instância, consulte [Failover do Amazon DocumentDB](failover.md).
A mesma prioridade pode ser compartilhada por mais de uma réplica do Amazon DocumentDB, o que resulta em níveis de promoção. Se duas ou mais réplicas do Amazon DocumentDB compartilharem a mesma prioridade, a réplica maior será promovida à principal. Se duas ou mais réplicas do Amazon DocumentDB compartilharem a mesma prioridade e o mesmo tamanho, uma réplica arbitrária no mesmo nível de promoção será promovida.
Se o cluster não contiver quaisquer réplicas do Amazon DocumentDB, a instância principal será recriada durante um evento de falha. Um evento de falha resulta em uma interrupção, durante a qual as operações de leitura e gravação falharão com uma exceção. O serviço é reestabelecido quando a nova instância primária é criada, o que normalmente leva menos de 10 minutos. Promover uma réplica do Amazon DocumentDB à instância primária é muito mais rápido que criar uma nova instância primária.