Selecione suas preferências de cookies

Usamos cookies essenciais e ferramentas semelhantes que são necessárias para fornecer nosso site e serviços. Usamos cookies de desempenho para coletar estatísticas anônimas, para que possamos entender como os clientes usam nosso site e fazer as devidas melhorias. Cookies essenciais não podem ser desativados, mas você pode clicar em “Personalizar” ou “Recusar” para recusar cookies de desempenho.

Se você concordar, a AWS e terceiros aprovados também usarão cookies para fornecer recursos úteis do site, lembrar suas preferências e exibir conteúdo relevante, incluindo publicidade relevante. Para aceitar ou recusar todos os cookies não essenciais, clique em “Aceitar” ou “Recusar”. Para fazer escolhas mais detalhadas, clique em “Personalizar”.

Modificar uma instância do Amazon DocumentDB

Modo de foco
Modificar uma instância do Amazon DocumentDB - Amazon DocumentDB

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

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

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

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 (Hamburger menu icon with three horizontal lines.) 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.

    Tabela de clusters mostrando a lista de clusters na coluna Identificador de cluster, com instâncias aninhadas dentro de clusters.
  4. Marque a caixa à esquerda da instância que você deseja modificar.

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

  6. No painel 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 obter mais informações, consulte Gerenciar classes de instância.

    • Autoridade de certificação: certificado do servidor para essa instância. Para obter 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 obter 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 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.

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. 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. É possível 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 obter mais informações, consulte Monitoramento do status de uma instância do Amazon DocumentDB.

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 (Hamburger menu icon with three horizontal lines.) 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.

    Tabela de clusters mostrando a lista de clusters na coluna Identificador de cluster, com instâncias aninhadas dentro de clusters.
  4. Marque a caixa à esquerda da instância que você deseja modificar.

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

  6. No painel 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 obter mais informações, consulte Gerenciar classes de instância.

    • Autoridade de certificação: certificado do servidor para essa instância. Para obter 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 obter 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 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.

PrivacidadeTermos do sitePreferências de cookies
© 2025, Amazon Web Services, Inc. ou suas afiliadas. Todos os direitos reservados.