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á. # Ciclo de vida da instância do Amazon DocumentDB O ciclo de vida de uma instância do Amazon DocumentDB inclui a criação, a modificação, a manutenção e a atualização, a realização de backups e restaurações, a reinicialização e a exclusão dessa instância. Esta seção fornece informações sobre como concluir esses processos. **Topics** + [Adicionar uma instância](db-instance-add.md) + [Descrever instâncias](db-instance-view-details.md) + [Modificar uma instância](db-instance-modify.md) + [Reinicializar uma instância](db-instance-reboot.md) + [Excluir uma instância](db-instance-delete.md) Você pode criar uma nova instância do Amazon DocumentDB usando o Console de gerenciamento da AWS ou o. AWS CLI Para adicionar uma instância a um cluster, o cluster deve estar no estado *disponível*. Não é possível adicionar uma instância a um cluster que foi interrompido. Se o cluster foi interrompido, primeiro inicie-o, aguarde até que fique *disponível* e adicione uma instância. Para obter mais informações, consulte [Interromper e iniciar um cluster do Amazon DocumentDB](db-cluster-stop-start.md). **nota** Se você criar um cluster do Amazon DocumentDB usando o console, uma instância será criada automaticamente para você ao mesmo tempo. Se você deseja criar instâncias adicionais, use um dos procedimentos a seguir. # Adicionar uma instância do Amazon DocumentDB a um cluster ------ #### [ Using the Console de gerenciamento da AWS ] Use o procedimento a seguir para criar uma instância para o cluster usando o console 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. Para escolher o cluster ao qual você deseja adicionar uma instância, selecione o botão à esquerda do nome do cluster. 1. Escolha **Ações** e escolha **Adicionar instâncias**. 1. Na página **Adicionar instância a: **, repita as etapas a seguir para cada instância a ser adicionada ao cluster. É possível ter até 15. 1. **Identificador da instância**: você pode inserir um identificador exclusivo para essa instância ou permitir que o Amazon DocumentDB forneça o identificador da instância com base no identificador do cluster. Restrições de nomenclatura da instância: + 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 todas as instâncias do Amazon RDS, Neptune e Amazon DocumentDB por região. Conta da AWS 1. **Classe da instância**: na lista suspensa, escolha o tipo de instância desejado para essa instância. 1. **Nível de promoção**: na lista suspensa, escolha o nível de promoção da instância ou selecione *Nenhuma preferência* para permitir que o Amazon DocumentDB defina o nível de promoção para a instância. Números mais baixos significam maior prioridade. Para obter mais informações, consulte [Controlar o destino de failover](failover.md#failover-target_control). 1. Para adicionar mais instâncias, escolha **Adicionar outras instâncias** e repita as etapas a, b e c. 1. Conclua a operação. + Para adicionar instâncias ao seu cluster, escolha **Criar**. + Para cancelar a operação, escolha **Cancelar**. Leva alguns minutos para criar uma instância. Você pode usar o console ou AWS CLI visualizar o status da instância. Para obter mais informações, consulte [Monitorar o status de uma instância](monitoring_docdb-instance_status.md). ------ #### [ Using the AWS CLI ] Use a `create-db-instance` AWS CLI operação com os parâmetros a seguir para criar a instância primária para seu cluster. + **--db-instance-class** — Obrigatório. A capacidade de computação e memória da instância, por exemplo, `db.m4.large`. Nem todas as classes de instâncias estão disponíveis em todas as Regiões da AWS. + **--db-instance-identifier** — Obrigatório. Uma string que identifica a instância. Restrições de nomenclatura da instância: + 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 todas as instâncias do Amazon RDS, Neptune e Amazon DocumentDB por região. Conta da AWS + **--engine** — Obrigatório. Deve ser `docdb`. + **--availability-zone** — Opcional. A zona de disponibilidade na qual você deseja que essa instância seja criada. Use esse parâmetro para localizar suas instâncias em diferentes zonas de disponibilidade para aumentar a tolerância a falhas. Para obter mais informações, consulte [Alta disponibilidade e replicação do Amazon DocumentDB](replication.md). + **--promotion-tier** — Opcional. O nível de prioridade de failover dessa instância. Deve estar entre 0 e 15, com números mais baixos sendo prioridade mais alta. Para obter mais informações, consulte [Controlar o destino de failover](failover.md#failover-target_control). 1. **Primeiro, determine em quais zonas de disponibilidade você pode criar a instância. ** Se quiser especificar a zona de disponibilidade antes de criar a instância, execute o seguinte comando para determinar quais zonas de disponibilidade estão disponíveis para o cluster do Amazon DocumentDB. Para Linux, macOS ou Unix: ``` aws docdb describe-db-clusters \ --query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]' ``` Para Windows: ``` aws docdb describe-db-clusters ^ --query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]' ``` A saída dessa operação é semelhante à seguinte. ``` [ [ "sample-cluster", [ "us-east-1c", "us-east-1b", "us-east-1a" ] ] ] ``` 1. **Segundo, determine quais classes de instância você pode criar na região. ** Para determinar quais classes de instância estão disponíveis na sua região, execute o seguinte comando. Na saída, escolha uma classe de instância para a instância que deseja adicionar ao cluster do Amazon DocumentDB. Para Linux, macOS ou Unix: ``` aws docdb describe-orderable-db-instance-options \ --engine docdb \ --query 'OrderableDBInstanceOptions[*].DBInstanceClass' ``` Para Windows: ``` aws docdb describe-orderable-db-instance-options ^ --engine docdb ^ --query 'OrderableDBInstanceOptions[*].DBInstanceClass' ``` A saída dessa operação é semelhante à seguinte. ``` [ "db.r5.16xlarge", "db.r5.2xlarge", "db.r5.4xlarge", "db.r5.8xlarge", "db.r5.large", "db.r5.xlarge" ] ``` 1. **Por último, adicione uma instância ao cluster do Amazon DocumentDB.** Para adicionar uma instância ao cluster do Amazon DocumentDB, execute o seguinte comando. Para Linux, macOS ou Unix: ``` aws docdb create-db-instance \ --db-cluster-identifier sample-cluster \ --db-instance-identifier sample-instance-2 \ --availability-zone us-east-1b \ --promotion-tier 2 \ --db-instance-class db.r5.xlarge \ --engine docdb ``` Para Windows: ``` aws docdb create-db-instance ^ --db-cluster-identifier sample-cluster ^ --db-instance-identifier sample-instance-2 ^ --availability-zone us-east-1b ^ --promotion-tier 2 ^ --db-instance-class db.r5.xlarge ^ --engine docdb ``` A saída dessa operação é semelhante à seguinte. ``` { "DBInstance": { "DBInstanceIdentifier": "sample-instance-2", "DBInstanceClass": "db.r5.xlarge", "Engine": "docdb", "DBInstanceStatus": "creating", "PreferredBackupWindow": "02:00-02:30", "BackupRetentionPeriod": 1, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-abcd0123", "Status": "active" } ], "AvailabilityZone": "us-east-1b", "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-6242c31a", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-west-2a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-wxyz0123", "SubnetAvailabilityZone": { "Name": "us-west-2b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "sun:11:35-sun:12:05", "PendingModifiedValues": {}, "EngineVersion": "3.6.0", "AutoMinorVersionUpgrade": true, "PubliclyAccessible": false, "DBClusterIdentifier": "sample-cluster", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key", "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ", "CACertificateIdentifier": "rds-ca-2019", "PromotionTier": 2, "DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2" } } ``` Leva alguns minutos para criar a instância. Você pode usar o console ou AWS CLI visualizar o status da instância. Para obter mais informações, consulte [Monitoramento do status de uma instância do Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ # Descrever instâncias 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, autoridade de certificação e grupos VPCs de parâmetros relacionados às suas instâncias do Amazon DocumentDB. ------ #### [ Using the Console de gerenciamento da AWS ] Para visualizar os detalhes de suas instâncias usando o Console de gerenciamento da AWS, siga as etapas abaixo. 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 caixa de navegação Clusters, você verá a coluna **Identificador do Cluster**. Suas instâncias estão listadas em clusters, semelhante ao snapshot abaixo. ![\[Tabela de clusters mostrando a lista de clusters na coluna Identificador de cluster, com instâncias aninhadas dentro de clusters.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/choose-clusters.png) 1. Na lista de instâncias, escolha o nome da instância da qual você deseja ver os detalhes. As informações sobre a instância são organizadas nos seguintes agrupamentos: + **Resumo**: informações gerais sobre a instância, incluindo a versão do mecanismo, a classe, o status e todas as manutenções pendentes. + **Conectividade e segurança**: a seção **Conecte-se** lista os endpoints de conexão para se conectar a essa instância com o shell do mongo ou com uma aplicação. A seção **Grupos de segurança** lista os grupos de segurança associados a essa instância e suas descrições e ID da VPC. + **Configuração**: a seção **Detalhes** lista as configurações e o status da instância, incluindo o nome do recurso da Amazon (ARN), o endpoint, o perfil, a classe e a autoridade certificadora da instância. Ela também lista as configurações de segurança e de rede da instância e as informações de backup. A seção **Detalhes do cluster** lista os detalhes do cluster ao qual essa instância pertence. A seção **Instâncias de cluster** lista todas as instâncias que pertencem ao cluster com cada função e status de grupo de parâmetros de cluster de cada instância. **nota** É possível modificar o cluster associado à sua instância selecionando **Modificar** ao lado do cabeçalho **Detalhes do cluster**. Para obter mais informações, consulte [Modificar um cluster do Amazon DocumentDB](db-cluster-modify.md). + **Monitoramento** — as métricas de CloudWatch registros dessa instância. 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 dessa instância. O Amazon DocumentDB mantém um registro de eventos que se relacionam a seus clusters, instâncias, snapshots, 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. Para obter mais informações, consulte [Marcação de recursos do Amazon DocumentDB](tagging.md). ------ #### [ Using the AWS CLI ] Para visualizar os detalhes de suas instâncias 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_DescribeDBInstances.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.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 parâmetro de filtro `filterName=engine,Values=docdb` só retorna clusters do Amazon DocumentDB. 1. **Liste todas as instâncias do Amazon DocumentDB.** O AWS CLI código a seguir lista os detalhes de todas as instâncias do Amazon DocumentDB em uma região. Para Linux, macOS ou Unix: ``` aws docdb describe-db-instances \ --filter Name=engine,Values=docdb ``` Para Windows: ``` aws docdb describe-db-instances \ --filter Name=engine,Values=docdb ``` 1. **Listar todos os detalhes de uma instância especificada do Amazon DocumentDB** O código a seguir lista os detalhes para `sample-cluster-instance`. Incluir o parâmetro `--db-instance-identifier` com o nome de uma instância restringe a saída às informações sobre essa instância específica. Para Linux, macOS ou Unix: ``` aws docdb describe-db-instances \ --db-instance-identifier sample-cluster-instance ``` Para Windows: ``` aws docdb describe-db-instances \ --db-instance-identifier sample-cluster-instance ``` A saída dessa operação é semelhante à seguinte. ``` { "DBInstances": [ { "DbiResourceId": "db-BJKKB54PIDV5QFKGVRX5T3S6GM", "DBInstanceArn": "arn:aws:rds:us-east-1:012345678901:db:sample-cluster-instance-00", "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-77186e0d", "Status": "active" } ], "DBInstanceClass": "db.r5.large", "DBInstanceStatus": "creating", "AutoMinorVersionUpgrade": true, "PreferredMaintenanceWindow": "fri:09:32-fri:10:02", "BackupRetentionPeriod": 1, "StorageEncrypted": true, "DBClusterIdentifier": "sample-cluster", "EngineVersion": "3.6.0", "AvailabilityZone": "us-east-1a", "Engine": "docdb", "PromotionTier": 2, "DBInstanceIdentifier": "sample-cluster-instance", "PreferredBackupWindow": "00:00-00:30", "PubliclyAccessible": false, "DBSubnetGroup": { "DBSubnetGroupName": "default", "Subnets": [ { "SubnetIdentifier": "subnet-4e26d263", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-afc329f4", "SubnetAvailabilityZone": { "Name": "us-east-1c" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-b3806e8f", "SubnetAvailabilityZone": { "Name": "us-east-1e" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-53ab3636", "SubnetAvailabilityZone": { "Name": "us-east-1d" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-991cb8d0", "SubnetAvailabilityZone": { "Name": "us-east-1b" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-29ab1025", "SubnetAvailabilityZone": { "Name": "us-east-1f" }, "SubnetStatus": "Active" } ], "VpcId": "vpc-91280df6", "DBSubnetGroupDescription": "default", "SubnetGroupStatus": "Complete" }, "PendingModifiedValues": {}, "KmsKeyId": "arn:aws:kms:us-east-1:012345678901:key/0961325d-a50b-44d4-b6a0-a177d5ff730b" } ] } ``` ------ # Modificar uma instância do Amazon DocumentDB Você pode modificar sua instância do Amazon DocumentDB usando o Console de gerenciamento da AWS ou o. AWS CLI Para modificar uma instância, ela deve estar no estado *disponível*. Você não pode modificar uma instância que foi interrompida. Se o cluster foi interrompido, primeiro inicie-o, aguarde até que a instância 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 ] Para modificar uma instância específica do Amazon DocumentDB usando o console, siga as etapas a seguir. 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 caixa de navegação Clusters, você verá a coluna **Identificador do Cluster**. Suas instâncias estão listadas em clusters, semelhante ao snapshot abaixo. ![\[Tabela de clusters mostrando a lista de clusters na coluna Identificador de cluster, com instâncias aninhadas dentro de clusters.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/choose-clusters.png) 1. Marque a caixa à esquerda da instância que você deseja modificar. 1. Escolha **Ações** e, em seguida, **Modificar**. 1. No painel **Modificar instância: **, faça as alterações desejadas. É possível fazer as alterações a seguir: + **Especificações da instância**: o identificador e a classe da instância. Restrições de nomenclatura de identificador de instância: + **Identificador da instância** — insira um nome exclusivo para todas as instâncias de sua propriedade Conta da AWS na região atual. O identificador da instância deve conter [1 a 63] caracteres alfanuméricos ou hifens, ter uma letra como primeiro caractere e não pode terminar com um hífen nem conter dois hifens consecutivos. + **Classe de instância**: no menu suspenso, selecione uma classe de instância para sua instância do Amazon DocumentDB. Para obter mais informações, consulte [Gerenciar classes de instância](db-instance-classes.md). + **Autoridade de certificação**: certificado do servidor para essa instância. Para obter mais informações, consulte [Atualizar seus certificados TLS do Amazon DocumentDB](ca_cert_rotation.md). + **Failover**: durante o failover, a instância com o nível de promoção mais alto será promovida para primária. Para obter mais informações, consulte [Failover do Amazon DocumentDB](failover.md). + **Manutenção**: a janela de manutenção na qual modificações ou patches pendentes são aplicados às instâncias no cluster. 1. Ao concluir, escolha **Continuar** para ver um resumo das alterações. 1. Depois de verificar suas alterações, é possível aplicá-las imediatamente, ou durante a próxima janela de manutenção em **Programação de modificações**. Selecione **Modificar instância** para salvar as alterações. Como alternativa, você pode escolher **Cancelar** para descartar as alterações. Levará alguns minutos para que suas alterações sejam aplicadas. É possível usar a instância somente quando seu status for *disponível*. É possível monitorar o status da instância usando o console ou a AWS CLI. Para obter mais informações, consulte [Monitoramento do status de uma instância do Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ #### [ Using the AWS CLI ] Para modificar uma instância específica do Amazon DocumentDB usando o AWS CLI, use o `modify-db-instance` com os seguintes parâmetros. Para obter mais informações, consulte [Modificar DBInstance](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBInstance.html). O código a seguir modifica a classe de instância para `db.r5.large` para a instância `sample-instance`. **Parâmetros** + **--db-instance-identifier** — Obrigatório. O identificador da instância a ser modificada. + **--db-instance-class** — Opcional. A nova capacidade de computação e memória da instância. Por exemplo, `db.r5.large`. Nem todas as classes de instância estão disponíveis em todos os Regiões da AWS. Se você modificar a classe da instância, ocorrerá uma interrupção durante a alteração. A alteração será aplicada durante a próxima janela de manutenção, a menos que `ApplyImmediately` seja especificado como verdadeiro para essa solicitação. + **--apply-immediately** ou **--no-apply-immediately**: opcional. Especifica se essa modificação deve ser aplicada imediatamente ou se deve aguardar até a próxima janela de manutenção. Se esse parâmetro for omitido, a modificação será executada durante a próxima janela de manutenção. **Example** Para Linux, macOS ou Unix: ``` aws docdb modify-db-instance \ --db-instance-identifier sample-instance \ --db-instance-class db.r5.large \ --apply-immediately ``` Para Windows: ``` aws docdb modify-db-instance ^ --db-instance-identifier sample-instance ^ --db-instance-class db.r5.large ^ --apply-immediately ``` A saída dessa operação é semelhante à seguinte. ``` { "DBInstances": [ { "DBInstanceIdentifier": "sample-instance-1", "DBInstanceClass": "db.r5.large", "Engine": "docdb", "DBInstanceStatus": "modifying", "Endpoint": { "Address": "sample-instance-1.node.us-east-1.docdb.amazonaws.com", "Port": 27017, "HostedZoneId": "ABCDEFGHIJKLM" }, "InstanceCreateTime": "2020-01-10T22:18:55.921Z", "PreferredBackupWindow": "02:00-02:30", "BackupRetentionPeriod": 1, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-abcd0123", "Status": "active" } ], "AvailabilityZone": "us-east-1a", "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-abcd0123", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-east-1b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "sun:10:57-sun:11:27", "PendingModifiedValues": { "DBInstanceClass": "db.r5.large" }, "EngineVersion": "3.6.0", "AutoMinorVersionUpgrade": true, "PubliclyAccessible": false, "DBClusterIdentifier": "sample-cluster", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY", "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ", "CACertificateIdentifier": "rds-ca-2019", "PromotionTier": 1, "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:sample-instance-1", "EnabledCloudwatchLogsExports": [ "profiler" ] } ] } ``` Leva alguns minutos para que suas modificações sejam aplicadas. É possível usar a instância somente quando seu status for *disponível*. Você pode monitorar o status da instância usando o Console de gerenciamento da AWS ou AWS CLI. Para obter mais informações, consulte [Monitoramento do status de uma instância do Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ # Reinicializar uma instância do Amazon DocumentDB Ocasionalmente, você pode precisar reinicializar sua instância do Amazon DocumentDB, geralmente por motivos de manutenção. Se você fizer determinadas alterações, como alterar o grupo de parâmetros de cluster associado a um cluster, será necessário reinicializar as instâncias no cluster para que as alterações sejam implantadas. Você pode reinicializar uma instância específica usando o Console de gerenciamento da AWS ou o. AWS CLI Reinicializar uma instância reinicia o serviço de mecanismo de banco de dados. A reinicialização resulta em uma interrupção momentânea, durante a qual o status da instância é definido como `rebooting`. Um evento do Amazon DocumentDB é criado quando a reinicialização é concluída. A reinicialização de uma instância não resulta em um failover. Para fazer o failover de um cluster do Amazon DocumentDB, use Console de gerenciamento da AWS a ou AWS CLI a operação. `failover-db-cluster` Para obter mais informações, consulte [Failover do Amazon DocumentDB](failover.md). Você não poderá reinicializar sua instância se ela não estiver no estado *disponível*. Seu banco de dados pode se tornar indisponível por vários motivos, como uma modificação solicitada anteriormente ou uma ação no intervalo de manutenção. Para obter mais informações sobre os estados da instância, consulte [Monitoramento do status de uma instância do Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ #### [ Using the Console de gerenciamento da AWS ] O procedimento a seguir reinicializa uma instância especificada 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 caixa de navegação Clusters, você verá a coluna **Identificador do Cluster**. Suas instâncias estão listadas em clusters, semelhante ao snapshot abaixo. ![\[Tabela de clusters mostrando a lista de clusters na coluna Identificador de cluster, com instâncias aninhadas dentro de clusters.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/choose-clusters.png) 1. Marque a caixa à esquerda da instância que você deseja reinicializar. 1. Escolha **Ações**, escolha **Reinicializar** e depois **Reinicializar** para confirmar a reinicialização. Demora alguns minutos para sua instância reinicializar. É possível usar a instância somente quando seu status for *disponível*. É possível monitorar o status da instância usando o console ou a AWS CLI. Para obter mais informações, consulte [Monitoramento do status de uma instância do Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ #### [ Using the AWS CLI ] Para reinicializar uma instância do Amazon DocumentDB, use a operação `reboot-db-instance` com o parâmetro `--db-instance-identifier`. Esse parâmetro especifica o identificador da instância a ser reinicializada. O código a seguir reinicializa a instância `sample-instance`. **Example** Para Linux, macOS ou Unix: ``` aws docdb reboot-db-instance \ --db-instance-identifier sample-instance ``` Para Windows: ``` aws docdb reboot-db-instance ^ --db-instance-identifier sample-instance ``` A saída dessa operação é semelhante à seguinte. ``` { "DBInstance": { "DBInstanceIdentifier": "sample-instance", "DBInstanceClass": "db.r5.large", "Engine": "docdb", "DBInstanceStatus": "rebooting", "Endpoint": { "Address": "sample-instance.node.us-east-1.docdb.amazonaws.com", "Port": 27017, "HostedZoneId": "ABCDEFGHIJKLM" }, "InstanceCreateTime": "2020-03-27T08:05:56.314Z", "PreferredBackupWindow": "02:00-02:30", "BackupRetentionPeriod": 1, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-abcd0123", "Status": "active" } ], "AvailabilityZone": "us-east-1c", "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-abcd0123", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-wxyz0123", "SubnetAvailabilityZone": { "Name": "us-east-1b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "sun:06:53-sun:07:23", "PendingModifiedValues": {}, "EngineVersion": "3.6.0", "AutoMinorVersionUpgrade": true, "PubliclyAccessible": false, "DBClusterIdentifier": "sample-cluster", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key", "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ", "CACertificateIdentifier": "rds-ca-2019", "PromotionTier": 1, "DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance", "EnabledCloudwatchLogsExports": [ "profiler" ] } } ``` Demora alguns minutos para sua instância reinicializar. É possível usar a instância somente quando seu status for *disponível*. É possível monitorar o status da instância usando o console ou a AWS CLI. Para obter mais informações, consulte [Monitoramento do status de uma instância do Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ # Excluir uma instância do Amazon DocumentDB Você pode excluir sua instância do Amazon DocumentDB usando o Console de gerenciamento da AWS ou o. AWS CLI Para excluir uma instância, ela deve estar no estado *disponível*. Você não pode excluir uma instância que foi interrompida. Se o cluster do Amazon DocumentDB que contém a instância for interrompido, primeiro inicie o cluster, aguarde até que a instância fique *disponível* e, depois, exclua-a. Para obter mais informações, consulte [Interromper e iniciar um cluster do Amazon DocumentDB](db-cluster-stop-start.md). **nota** O Amazon DocumentDB armazena todos os dados no volume do cluster. Os dados persistem nesse volume de cluster, mesmo se você remover todas as instâncias do cluster. Se precisar acessar os dados novamente, adicione uma instância ao cluster a qualquer momento e continue de onde parou. ------ #### [ Using the Console de gerenciamento da AWS ] O procedimento a seguir excluir uma instância do Amazon DocumentDB especificada 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 caixa de navegação Clusters, você verá a coluna **Identificador do Cluster**. Suas instâncias estão listadas em clusters, semelhante ao snapshot abaixo. ![\[Tabela de clusters mostrando a lista de clusters na coluna Identificador de cluster, com instâncias aninhadas dentro de clusters.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/choose-clusters.png) 1. Marque a caixa à esquerda da instância que você deseja excluir. 1. Selecione **Ações** e escolha **Excluir**. 1. Se você estiver excluindo a última instância no cluster: + **Criar snapshot final do cluster?** — Escolha **Sim** se você quiser criar um snapshot final antes do cluster ser excluído. Caso contrário, escolha **Não**. + **Nome do snapshot final**: se você escolher criar um snapshot final, insira o identificador do novo snapshot do cluster. + **Excluir instância ?** — Insira a frase **excluir cluster inteiro** no campo para confirmar a exclusão. 1. Se você não estiver excluindo a última instância no cluster: + **Excluir instância ?** — Insira a frase **exclua-me** no campo para confirmar a exclusão. 1. Selecione **Excluir** para excluir a instância. Leva alguns minutos para uma instância ser excluída. Para monitorar o status de uma instância, consulte [Monitoramento do status de uma instância do Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ #### [ Using the AWS CLI ] O procedimento a seguir exclui uma instância do Amazon DocumentDB usando a AWS CLI. 1. **Primeiro, determine quantas instâncias estão no cluster do Amazon DocumentDB:** Para determinar quantas instâncias estão no cluster, execute o comando `describe-db-clusters` da seguinte forma. ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' ``` A saída dessa operação é semelhante à seguinte. ``` [ [ "sample-cluster", [ "sample-instance-1", "sample-instance-2" ] ] ] ``` 1. **Se houver mais de uma instância no cluster do Amazon DocumentDB:** Para excluir uma instância do Amazon DocumentDB especificada, use o comando `delete-db-instance` com o parâmetro `--db-instance-identifier`, conforme mostrado abaixo. Leva alguns minutos para uma instância ser excluída. Para monitorar o status de uma instância, consulte [Monitoramento do status de uma instância do Amazon DocumentDB](monitoring_docdb-instance_status.md). ``` aws docdb delete-db-instance \ --db-instance-identifier sample-instance-2 ``` A saída dessa operação é semelhante à seguinte. ``` { "DBInstance": { "DBInstanceIdentifier": "sample-instance-2", "DBInstanceClass": "db.r5.large", "Engine": "docdb", "DBInstanceStatus": "deleting", "Endpoint": { "Address": "sample-instance-2.node.us-east-1.docdb.amazonaws.com", "Port": 27017, "HostedZoneId": "ABCDEFGHIJKLM" }, "InstanceCreateTime": "2020-03-27T08:05:56.314Z", "PreferredBackupWindow": "02:00-02:30", "BackupRetentionPeriod": 1, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-abcd0123", "Status": "active" } ], "AvailabilityZone": "us-east-1c", "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-6242c31a", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-wxyz0123", "SubnetAvailabilityZone": { "Name": "us-east-1b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "sun:06:53-sun:07:23", "PendingModifiedValues": {}, "EngineVersion": "3.6.0", "AutoMinorVersionUpgrade": true, "PubliclyAccessible": false, "DBClusterIdentifier": "sample-cluster", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key", "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ", "CACertificateIdentifier": "rds-ca-2019", "PromotionTier": 1, "DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2", "EnabledCloudwatchLogsExports": [ "profiler" ] } } ``` 1. **Se a instância que deseja excluir for a última instância no cluster do Amazon DocumentDB: ** Se você excluir a última instância em um cluster do Amazon DocumentDB, você também excluirá esse cluster e os snapshots automáticos e backups contínuos associados a ele. Para excluir a última instância no cluster, é possível excluí-lo e opcionalmente criar um snapshot final. Para obter mais informações, consulte [Excluir um cluster do Amazon DocumentDB](db-cluster-delete.md). ------ ## Proteção contra exclusão A exclusão da última instância em um cluster do Amazon DocumentDB também excluirá o cluster, os snapshots automáticos e os backups contínuos associados a ele. O Amazon DocumentDB impõe proteção contra exclusão para um cluster, independentemente de você realizar a operação de exclusão usando o. ou o. Console de gerenciamento da AWS 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. Para obter mais informações, consulte [Excluir um cluster do Amazon DocumentDB](db-cluster-delete.md).