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-snapshot1Tipo: 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-snapshot2Tipo: String
Obrigatório: Sim
-
- CopyTags
-
Defina como
truepara 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
KmsKeyIda fim de criptografar a cópia com uma nova chave de criptografia de AWS KMS. Se você não especificar um valor paraKmsKeyId, 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
KmsKeyIdpara 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
CopyDBClusterSnapshotno Região da AWS que contém a captura instantânea de cluster de origem a ser copiada. É necessário usar o parâmetroPreSignedUrlao 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-regionpara a AWS CLI) em vez de especificarPreSignedUrlmanualmente. A especificaçãoSourceRegiongera 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, seuSourceDBClusterSnapshotIdentifierse 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
-
DBClusterSnapshotIdentifiernã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: