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

CopyDBClusterSnapshot

Copia um snapshot de um cluster.

Para copiar um snapshot de um snapshot manual do cluster de banco de dados compartilhado, SourceDBClusterSnapshotIdentifier deve ser o nome do recurso da Amazon (ARN) do snapshot do cluster compartilhado. Só é possível copiar um snapshot de cluster de banco de dados compartilhado, criptografado ou não, na mesma Região da AWS.

Para cancelar uma operação de cópia depois que ela estiver em andamento, exclua o snapshot do cluster de banco de dados de destino identificado por TargetDBClusterSnapshotIdentifier enquanto ele estiver no status cópia.

Parâmetros da solicitação

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

SourceDBClusterSnapshotIdentifier

O identificador do snapshot de cluster a ser copiado. Esse parâmetro não diferencia maiúsculas de minúsculas.

Restrições:

  • É necessário especificar um snapshot de cluster válido no estado disponível.

  • Se o snapshot do cluster de origem estiver na mesma Região da AWS que a cópia, especifique um identificador de snapshot válido.

  • Se o snapshot de origem estiver em uma Região da AWS diferente ou de propriedade de outra conta da AWS, especifique o ARN do snapshot.

Exemplo: my-cluster-snapshot1

Tipo: String

Obrigatório: Sim

TargetDBClusterSnapshotIdentifier

O identificador do novo snapshot de cluster a ser criado a partir do snapshot de cluster de origem. Esse parâmetro não diferencia maiúsculas de 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 podem terminar com um hífen ou conter dois hífens consecutivos.

Exemplo: my-cluster-snapshot2

Tipo: String

Obrigatório: Sim

CopyTags

Defina como true para copiar todas as tags do snapshot do cluster de origem no snapshot do cluster do cluster de destino. Caso contrário, false. O padrão é “”. false.

Tipo: booliano

Obrigatório: Não

KmsKeyId

O ID da chave do AWS KMS para um snapshot do cluster criptografado. O ID da chave do AWS KMS é o nome de recurso da Amazon (ARN), o identificador da chave do AWS KMS ou o alias da chave do AWS KMS para a chave de criptografia do AWS KMS.

Se você copiar um snapshot do cluster criptografado de seu Conta da AWS, pode especificar um valor para KmsKeyId a fim de criptografar a cópia com uma nova chave de criptografia de AWS KMS. Se você não especificar um valor para KmsKeyId, a cópia do snapshot do cluster será criptografada com a mesma chave AWS KMS que o snapshot do cluster de origem.

Se você copiar um snapshot de cluster criptografado compartilhado de outra Conta da AWS, deverá especificar um valor para KmsKeyId.

Para copiar um snapshot de cluster criptografado para outro snapshot de clusterRegião da AWS, defina KmsKeyId para o ID de chave AWS KMS que você deseja usar para criptografar a cópia do snapshot de cluster na região de destino. Chaves de criptografia AWS KMS são específicas da Região da AWS em que são criadas. Não é possível usar chaves de criptografia de uma Região da AWS em outra Região da AWS.

Se você copiar um snapshot de cluster não criptografado e especificar um valor para o parâmetro KmsKeyId, um erro será retornado.

Tipo: String

Obrigatório: Não

PreSignedUrl

A URL que contém uma solicitação assinada do Signature Versão 4 para a ação da API CopyDBClusterSnapshot no Região da AWS que contém a captura instantânea de cluster de origem a ser copiada. É necessário usar o parâmetro PreSignedUrl ao copiar um snapshot de cluster de outro Região da AWS.

Se você estiver usando uma ferramenta AWS SDK ou a AWS CLI, poderá especificar SourceRegion (ou --source-region para a AWS CLI) em vez de especificar PreSignedUrl manualmente. A especificação SourceRegion gera automaticamente um URL pré-assinado que é uma solicitação válida para a operação que pode ser executada na Região da AWS de origem.

O URL pré-assinado deve ser uma solicitação válida para a ação de API CopyDBClusterSnapshot, que pode ser executada na Região da AWS de origem que contém o snapshot de cluster criptografado a ser copiado. A solicitação de URL pré-assinada deve conter os seguintes valores de parâmetros:

  • SourceRegion - O ID da região que contém o instantâneo a ser copiado.

  • SourceDBClusterSnapshotIdentifier - O identificador do snapshot do cluster criptografado a ser copiado. Esse identificador deve estar no formato de nome do recurso da Amazon (ARN) da de origem Região da AWS. Por exemplo, se você estiver copiando um snapshot de cluster criptografado da região us-east-1 Região da AWS, seu SourceDBClusterSnapshotIdentifier se parecerá com o seguinte exemplo: arn:aws:rds:us-east-1:12345678012:sample-cluster:sample-cluster-snapshot.

  • TargetDBClusterSnapshotIdentifier - o identificador para o novo snapshot de cluster de cluster a ser criado. Esse parâmetro não diferencia maiúsculas de minúsculas.

Tipo: String

Obrigatório: Não

Tags.Tag.N

As tags a serem atribuídas ao snapshot do cluster.

Tipo: matriz de objetos Tag

Obrigatório: Não

Elementos de Resposta

O elemento a seguir é retornado pelo serviço.

DBClusterSnapshot

Informações detalhadas sobre um snapshot de cluster.

Tipo: objeto DBClusterSnapshot

Erros

Para obter informações sobre os erros comuns retornados pelas ações, consulte Erros comuns.

DBClusterSnapshotAlreadyExistsFault

O usuário já tem um snapshot de cluster com o identificador determinado.

Código de Status HTTP: 400

DBClusterSnapshotNotFoundFault

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

Código de Status HTTP: 404

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

KMSKeyNotAccessibleFault

Ocorreu um erro ao acessar uma chave do AWS KMS.

Código de Status HTTP: 400

SnapshotQuotaExceeded

A solicitação faria com que você excedesse o número de snapshots permitidos.

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: