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á.
# ModifyDBInstance
Modifica as configurações de uma instância. É possível alterar um ou mais parâmetros de configuração do banco de dados especificando esses parâmetros e os novos valores na solicitação.
## Parâmetros de solicitação
Para obter informações sobre os parâmetros que são comuns a todas as ações, consulte [Parâmetros comuns](CommonParameters.md).
** DBInstanceIdentifier **
O identificador da instância. Esse valor é armazenado como uma string em minúsculas.
Restrições:
+ Deve corresponder ao identificador de um `DBInstance` existente.
Tipo: String
Obrigatório: Sim
** ApplyImmediately **
Especifica se as modificações feitas nessa solicitação e todas as modificações pendentes serão aplicadas de maneira assíncrona logo que possível, independentemente da configuração `PreferredMaintenanceWindow` da instância de banco de dados.
Caso esse parâmetro seja definido como `false`, as alterações feitas na instância de banco de dados serão aplicadas durante a próxima janela de manutenção. Algumas alterações de parâmetro podem causar uma interrupção e serão aplicadas na próxima reinicialização.
Padrão: `false`
Tipo: booliano
Obrigatório: Não
** AutoMinorVersionUpgrade **
Esse parâmetro não é aplicável ao Amazon DocumentDB. O Amazon DocumentDB não faz atualizações de versões inferiores, independente do valor definido.
Tipo: Booliano
Obrigatório: Não
** CACertificateIdentifier **
Indica o certificado que deve ser associado à instância.
Tipo: String
Obrigatório: não
** CertificateRotationRestart **
Especifica se a instância de banco de dados é reiniciada quando você alterna seu certificado. SSL/TLS
Por padrão, a instância de banco de dados é reiniciada quando você alterna seu SSL/TLS certificado. O certificado não é atualizado até que a instância de banco de dados seja reiniciada.
Defina esse parâmetro somente se você *não* estiver usando SSL/TLS para se conectar à instância de banco de dados.
*Se você estiver usando SSL/TLS para se conectar à instância de banco de dados, consulte [Como atualizar seus certificados TLS do Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/ca_cert_rotation.html) e [criptografar dados em trânsito no](https://docs.aws.amazon.com/documentdb/latest/developerguide/security.encryption.ssl.html) Guia do desenvolvedor do Amazon DocumentDB.*
Tipo: booliano
Obrigatório: Não
** CopyTagsToSnapshot **
Um valor que indica se todas as tags da instância de BD devem ser copiadas para snapshots da instância de BD. Por padrão, as tags não são copiadas.
Tipo: Booliano
Obrigatório: Não
** DBInstanceClass **
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 `true` para essa solicitação.
Padrão: usa a configuração existente
Tipo: String
Obrigatório: Não
** EnablePerformanceInsights **
Um valor que indica se deve ser ativado o Performance Insights para a instância de BD. Para obter mais informações, consulte [Usando insights de desempenho da Amazon](https://docs.aws.amazon.com/documentdb/latest/developerguide/performance-insights.html).
Tipo: Booliano
Obrigatório: Não
** NewDBInstanceIdentifier **
O novo identificador da instância de banco de dados durante a renomeação de uma instância de banco de dados. Quando você altera o identificador da instância, a reinicialização da instância ocorre imediatamente se você definir `Apply Immediately` para `true`. Isso ocorrerá durante a próxima janela de manutenção se você definir `Apply Immediately` para `false`. Esse valor é armazenado como uma string em minúsculas.
Restrições:
+ Deve conter de 1 a 63 caracteres, incluindo 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.
Exemplo: `mydbinstance`
Tipo: string
Obrigatório: não
** PerformanceInsightsKMSKeyId **
O identificador AWS KMS chave para criptografia dos dados do Performance Insights.
O identificador da AWS KMS chave é o ARN da chave, o ID da chave, o ARN do alias ou o nome do alias da chave KMS.
Se você não especificar um valor para PerformanceInsights KMSKey Id, o Amazon DocumentDB usará sua chave KMS padrão. Há uma chave KMS padrão para sua conta do Amazon Web Services. Sua conta do Amazon Web Services tem uma chave KMS padrão diferente para cada região do Amazon Web Services.
Tipo: String
Obrigatório: Não
** PreferredMaintenanceWindow **
O período semanal (em UTC) durante o qual pode ocorrer a manutenção do sistema, o que pode resultar em uma interrupção. A alteração desse parâmetro não resultará em uma interrupção, exceto na situação a seguir, e a alteração será aplicada de maneira assíncrona logo que possível. Se houver ações pendentes que causem uma reinicialização e a janela de manutenção for alterada para incluir a hora atual, a alteração desse parâmetro causará uma reinicialização da instância. Se essa janela for mudada para a hora atual, deverá haver pelo menos 30 minutos entre a hora atual e o final da janela para garantir que as alterações pendentes sejam aplicadas.
Padrão: Usa a configuração existente
Formato: `ddd:hh24:mi-ddd:hh24:mi`.
Dias válidos: Seg, Ter, Qua, Qui, Sex, Sáb, Dom
Restrições: deve ser, pelo menos, 30 minutos
Tipo: String
Obrigatório: Não
** PromotionTier **
Um valor que especifica a ordem em que uma réplica do Amazon DocumentDB é promovida para a instância primária após uma falha da instância primária existente.
Padrão: 1
Valores válidos: 0 a 15
Tipo: Inteiro
Obrigatório: Não
## Elementos de Resposta
O elemento a seguir é retornado pelo serviço.
** DBInstance **
Informações detalhadas sobre uma instância.
Tipo: objeto [DBInstance](API_DBInstance.md)
## Erros
Para obter informações sobre os erros comuns que todas as ações retornam, consulte [Erros comuns](CommonErrors.md).
** AuthorizationNotFound **
O IP CIDR ou o grupo de segurança do Amazon EC2 especificado não está autorizado para o grupo de segurança especificado.
O Amazon DocumentDB também pode não estar autorizado a executar as ações necessárias em seu nome usando o IAM.
Código de Status HTTP: 404
** CertificateNotFound **
`CertificateIdentifier` não se refere a um certificado existente.
Código de Status HTTP: 404
** DBInstanceAlreadyExists **
Você já tem uma instância com o identificador informado.
Código de Status HTTP: 400
** DBInstanceNotFound **
`DBInstanceIdentifier` não se refere a uma instância existente.
Código de Status HTTP: 404
** DBParameterGroupNotFound **
`DBParameterGroupName` não se refere a um grupo de parâmetros existente.
Código de Status HTTP: 404
** DBSecurityGroupNotFound **
`DBSecurityGroupName` não se refere a um grupo de segurança existente.
Código de status HTTP: 404
** DBUpgradeDependencyFailure **
O upgrade falhou porque um recurso do qual ele depende não pode ser modificado.
Código de Status HTTP: 400
** InsufficientDBInstanceCapacity **
A classe de instância especificada não está disponível na Zona de Disponibilidade especificada.
Código de Status HTTP: 400
** InvalidDBInstanceState **
A instância especificada não está no estado *disponível*.
Código de Status HTTP: 400
** InvalidDBSecurityGroupState **
O estado do grupo de segurança não permite a exclusão.
Código de Status HTTP: 400
** InvalidVPCNetworkStateFault **
O grupo de sub-rede não cobre todas as zonas de disponibilidade depois de ter sido criado devido às alterações feitas.
Código de Status HTTP: 400
** StorageQuotaExceeded **
A solicitação faria com que você excedesse a quantidade permitida de armazenamento disponível em todas as instâncias.
Código de status HTTP: 400
** StorageTypeNotSupported **
O armazenamento do `StorageType` especificado não pode ser associado à instância do banco de dados.
Código de Status HTTP: 400
## Consulte também
Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+ [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/ModifyDBInstance)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/ModifyDBInstance)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/ModifyDBInstance)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/ModifyDBInstance)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/ModifyDBInstance)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/ModifyDBInstance)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/ModifyDBInstance)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/ModifyDBInstance)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/ModifyDBInstance)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/ModifyDBInstance)