Reinicializando 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. AWS Management Console 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 AWS Management Console a ou AWS CLI a operação. failover-db-cluster Para ter mais informações, consulte Failover do Amazon DocumentDB.

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.

Using the AWS Management Console

O procedimento a seguir reinicializa uma instância especificada usando o console.

1. Faça login no e abra AWS Management Console o console do Amazon DocumentDB em https://console.aws.amazon.com/docdb.

2. 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 () no canto superior esquerdo da página.

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

   

4. Marque a caixa à esquerda da instância que você deseja reinicializar.

5. Escolha Actions (Ações), escolha Reboot (Reinicializar) e depois Reboot (Reinicializar) para confirmar a reinicialização.

Demora alguns minutos para sua instância reinicializar. Você pode usar a instância somente quando seu status for disponível. Você pode monitorar o status da instância usando o console ou a AWS CLI. Para ter mais informações, consulte Monitoramento do status de uma instância do Amazon DocumentDB.

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.

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:<accountID>:key/sample-key",
        "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
        "CACertificateIdentifier": "rds-ca-2019",
        "PromotionTier": 1,
        "DBInstanceArn": "arn:aws:rds:us-east-1:<accountID>:db:sample-instance",
        "EnabledCloudwatchLogsExports": [
            "profiler"
        ]
    }
}
                    

Demora alguns minutos para sua instância reinicializar. Você pode usar a instância somente quando seu status for disponível. Você pode monitorar o status da instância usando o console ou a AWS CLI. Para ter mais informações, consulte Monitoramento do status de uma instância do Amazon DocumentDB.