RestoreDBClusterToPointInTime

Restaura um cluster para um momento arbitrário. Os usuários podem restaurar para qualquer point-in-time antes de LatestRestorableTime por até BackupRetentionPeriod dias. O cluster de banco de destino é criado a partir do cluster de de origem com a mesma configuração do cluster original, exceto pelo fato de que o novo cluster será criado com o grupo de segurança padrão.

Parâmetros da solicitação

Para obter informações sobre os parâmetros comuns a todas as ações, consulte Parâmetros Comuns.

DBClusterIdentifier

O nome do novo cluster a ser criado.

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 podem terminar com um hífen ou conter dois hífens consecutivos.

Tipo: string

Obrigatório: Sim

SourceDBClusterIdentifier

O identificador do cluster de origem do qual restaurar.

Restrições:

• Deve corresponder ao identificador de um DBCluster existente.

Tipo: String

Obrigatório: Sim

DBSubnetGroupName

O nome do grupo de sub-redes de a ser usado para o novo cluster.

Restrições: se fornecidas, devem corresponder ao nome de um DBSubnetGroup existente.

Exemplo: mySubnetgroup

Tipo: string

Obrigatório: Não

DeletionProtection

Especifica se esse cluster pode ser excluído. Se DeletionProtection estiver ativado, o cluster não pode ser excluído, a menos que seja modificado e DeletionProtection esteja desabilitado. DeletionProtection protege clusters contra exclusão acidental.

Tipo: booliano

Obrigatório: Não

EnableCloudwatchLogsExports.member.N

Uma lista de tipos de log que precisam estar habilitados para exportação para o Amazon CloudWatch Logs.

Tipo: matriz de strings

Obrigatório: Não

KmsKeyId

O identificador da chave do AWS KMS a ser usada ao restaurar um cluster criptografado a partir de um cluster criptografado.

O identificador da chave do AWS KMS é o nome do recurso da Amazon (ARN) para a chave de criptografia do AWS KMS. Se você estiver restaurando um cluster com a mesma Conta da AWS que tem a chave de criptografia do AWS KMS usada para criptografar o novo cluster, use o alias da chave do AWS KMS em vez de o ARN da chave de criptografia do AWS KMS.

É possível restaurar para um novo cluster com uma chave AWS KMS que seja diferente da chave do AWS KMS usada para criptografar o cluster de origem. O novo cluster de banco de dados é criptografado com a chave do AWS KMS identificada pelo parâmetro KmsKeyId.

Se você não especificar um valor para o parâmetro KmsKeyId, ocorrerá o seguinte:

• Se o cluster for criptografado, o cluster restaurado será criptografado usando a chave do AWS KMS que foi utilizada para criptografar o cluster de origem.

• Se o cluster não estiver criptografado, o cluster restaurado não será criptografado.

Se DBClusterIdentifier referir-se a um cluster não criptografado, a solicitação de restauração será rejeitada.

Tipo: String

Obrigatório: Não

NetworkType

O tipo de rede do cluster.

O tipo de rede é determinado usando o DBSubnetGroup especificado para o cluster. Um DBSubnetGroup pode oferecer suporte somente para o protocolo IPv4 ou para os protocolos IPv4 e IPv6 (DUAL).

Para obter mais informações, consulte Clusters do DocumentDB em uma VPC no Guia do desenvolvedor do Amazon DocumentDB.

Valores válidos: IPV4 | DUAL

Tipo: String

Obrigatório: Não

Port

O número da porta na qual o novo cluster aceita conexões.

Restrições: deve ser um valor entre 1150 e 65535.

Padrão: A porta padrão do mecanismo.

Tipo: inteiro

Obrigatório: Não

RestoreToTime

A data e a hora para as quais restaurar o cluster.

Valores válidos: um horário no formato Universal Coordinated Time (UTC).

Restrições:

• Devem ser anteriores ao último horário restaurável da instância.

• Devem ser especificadas se o parâmetro UseLatestRestorableTime não for especificado.

• Não podem ser especificadas se o parâmetro UseLatestRestorableTime for true.

• Não podem ser especificadas se o parâmetro RestoreType for copy-on-write.

Exemplo: 2015-03-07T23:45:00Z

Tipo: carimbo de hora

Obrigatório: Não

RestoreType

O tipo de restauração a ser realizada. É possível especificar um dos seguintes valores:

• full-copy - o novo cluster de banco de dados é restaurado como uma cópia completa do cluster de banco de dados de origem.

• copy-on-write - o novo cluster de banco de dados é restaurado como um clone do cluster de banco de dados de origem.

Restrições: você não pode especificar copy-on-write se a versão do mecanismo do cluster de banco de dados de origem for anterior à 1.11.

Se você não especificar um valor RestoreType, o novo cluster de banco de dados será restaurado como uma cópia completa do cluster de banco de dados de origem.

Tipo: String

Obrigatório: Não

ServerlessV2ScalingConfiguration

Contém a configuração de escalabilidade de um cluster do Amazon DocumentDB Sem Servidor.

Tipo: objeto ServerlessV2ScalingConfiguration

Obrigatório: Não

StorageType

O tipo de armazenamento a ser associado ao cluster de banco de dados.

Para obter informações sobre os tipos de armazenamento para clusters do Amazon DocumentDB, consulte Configurações de armazenamento do cluster no Guia do desenvolvedor do Amazon DocumentDB.

Valores válidos para o tipo de armazenamento - standard | iopt1

O valor padrão é . standard

Tipo: String

Obrigatório: Não

Tags.Tag.N

As tags a serem atribuídas ao cluster restaurado.

Tipo: matriz de objetos Tag

Obrigatório: Não

UseLatestRestorableTime

Um valor que é definido como true para restaurar o cluster para o horário do backup restaurável mais recente. Caso contrário, false.

Padrão: false

Restrições: não poderão ser especificadas se o parâmetro RestoreToTime for fornecido.

Tipo: booliano

Obrigatório: Não

VpcSecurityGroupIds.VpcSecurityGroupId.N

Uma lista de grupos de segurança da VPC à qual o novo cluster pertence.

Tipo: matriz de strings

Obrigatório: Não

Elementos de Resposta

O elemento a seguir é retornado pelo serviço.

DBCluster

Informações detalhadas sobre um cluster.

Tipo: objeto DBCluster

Erros

Para obter informações sobre os erros que são comuns a todas as ações, consulte Erros comuns.

DBClusterAlreadyExistsFault

Você já tem um cluster com o identificador determinado.

Código de status HTTP: 400

DBClusterNotFoundFault

DBClusterIdentifier não se refere a um cluster existente.

Código de Status HTTP: 404

DBClusterQuotaExceededFault

O cluster não pode ser criado porque você atingiu a cota máxima permitida de clusters.

Código de Status HTTP: 403

DBClusterSnapshotNotFoundFault

DBClusterSnapshotIdentifier não se refere a um snapshot de cluster existente.

Código de Status HTTP: 404

DBSubnetGroupNotFoundFault

DBSubnetGroupName não se refere a um grupo de sub-redes existente.

Código de Status HTTP: 404

InsufficientDBClusterCapacityFault

O cluster não tem capacidade suficiente para a operação atual.

Código de Status HTTP: 403

InsufficientStorageClusterCapacity

Não há armazenamento suficiente disponível para a ação atual. É possível resolver esse erro atualizando seu grupo de sub-redes para usar outras zonas de disponibilidade que tenham mais espaço de armazenamento disponível.

Código de Status HTTP: 400

InvalidDBClusterSnapshotStateFault

O valor fornecido não é um estado de snapshot de cluster válido.

Código de Status HTTP: 400

InvalidDBClusterStateFault

O cluster não está em um estado válido.

Código de Status HTTP: 400

InvalidDBSnapshotState

O estado do snapshot não permite a exclusão.

Código de Status HTTP: 400

InvalidRestoreFault

Não é possível restaurar de um backup de nuvem privada virtual (VPC) para uma instância de banco de dados que não seja da VPC.

Código de Status HTTP: 400

InvalidSubnet

A sub-rede solicitada é inválida ou foram solicitadas várias sub-redes que não estão em uma nuvem privada virtual (VPC) comum.

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

KMSKeyNotAccessibleFault

Ocorreu um erro ao acessar uma chave do AWS KMS.

Código de Status HTTP: 400

NetworkTypeNotSupported

Não há suporte para o tipo de rede em nenhuma das versões do DBSubnetGroup ou do mecanismo de banco de dados.

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

Consulte Também

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:

• AWS Command Line Interface V2

• AWS SDK para .NET

• AWS SDK para C++

• AWS SDK para Go v2

• AWS SDK for Java v2

• AWS SDK para JavaScript V3

• AWS SDK para Kotlin

• AWS SDK for PHP V3

• AWS SDK for Python

• AWS SDK para Ruby V3