Modificando uma instância do Amazon DocumentDB

Você pode modificar sua instância do Amazon DocumentDB usando o AWS Management Console ou o. AWS CLI Para modificar uma instância, ela deve estar no estado available (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 available (disponível) e faça as modificações desejadas. Para ter mais informações, consulte Interrompendo e iniciando um cluster Amazon DocumentDB.

Using the AWS Management Console

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

5. Escolha Ações e, em seguida, Modificar.

6. No painel Modify instance: <instance-name> (Modificar instância: <nome-da-instância>), faça as alterações desejadas. Você pode 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 ter mais informações, consulte Gerenciamento de métricas de instância.

   • Autoridade de certificação: certificado do servidor para essa instância. Para ter mais informações, consulte Atualizar seus certificados TLS do Amazon DocumentDB.

   • Failover: durante o failover, a instância com o nível de promoção mais alto será promovida para primária. Para ter mais informações, consulte Failover do Amazon DocumentDB.

   • Manutenção: a janela de manutenção na qual modificações ou patches pendentes são aplicados às instâncias no cluster.

7. Ao concluir, escolha Continuar para ver um resumo das alterações.

8. 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 Modify instance (Modificar instância) para salvar as alterações. Como alternativa, você pode escolher Cancel (Cancelar) para descartar as alterações.

Levará alguns minutos para que suas alterações sejam aplicadas. 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 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 ModifyDBInstance. 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.

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. Você pode usar a instância somente quando seu status for disponível. Você pode monitorar o status da instância usando o AWS Management Console ou AWS CLI. Para ter mais informações, consulte Monitoramento do status de uma instância do Amazon DocumentDB.