Cópia de snapshots de cluster do Amazon DocumentDB - Amazon DocumentDB
Copiar snapshots compartilhadosCopiando instantâneos entre Regiões da AWSLimitaçõesLidar com a criptografiaConsiderações de grupos de parâmetros Cópia de um snapshot de cluster

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

Cópia de snapshots de cluster do Amazon DocumentDB

No Amazon DocumentDB, você pode copiar snapshots dentro do mesmo Região da AWS ou para um diferente. Região da AWS Você também pode copiar instantâneos compartilhados para sua conta na mesma Região da AWS ou em outra Região da AWS. Para obter mais informações sobre o compartilhamento de snapshots, consulte Compartilhamento de snapshots de cluster do Amazon DocumentDB.

nota

O Amazon DocumentDB cobra com base na quantidade de dados de backup e snapshot do e no período em que você os mantém. Para obter informações sobre o armazenamento associado a backups e snapshots do Amazon DocumentDB, consulte Noções básicas do uso do armazenamento de backup do . Para obter informações sobre a definição de preço do armazenamento do Amazon DocumentDB, consulte a página da web Definição de preço do Amazon DocumentDB.

Copiar snapshots compartilhados

Você pode copiar instantâneos compartilhados com você por outras AWS contas. Se você estiver copiando um instantâneo criptografado que foi compartilhado de outra AWS conta, deverá ter acesso à chave de AWS KMS criptografia usada para criptografar o instantâneo. Para obter mais informações, consulte Lidar com a criptografia.

Copiando instantâneos entre Regiões da AWS

Quando você copia um instantâneo para um Região da AWS que é diferente do instantâneo de origem Região da AWS, cada cópia é um instantâneo completo. Uma cópia completa do snapshot contém todos os dados e metadados necessários para restaurar o cluster Amazon DocumentDB.

Limitações

Algumas limitações ao copiar snapshots:

  • Se você excluir um snapshot de origem antes que o snapshot de destino fique disponível, a cópia do snapshot poderá falhar. Verifique se o snapshot de destino possui um status AVAILABLE antes de excluir um snapshot de origem.

  • É possível ter até cinco solicitações de cópia de snapshot em andamento para uma única região de destino por conta.

  • Dependendo do Regiões da AWS envolvido e da quantidade de dados a serem copiados, uma cópia instantânea entre regiões pode levar horas para ser concluída. Em alguns casos, pode haver um grande número de solicitações de cópia de snapshot entre regiões de determinada Região da AWS de origem. Nesses casos, o Amazon DocumentDB pode colocar novas solicitações de cópia entre regiões dessa fonte Região da AWS em uma fila até que algumas cópias em andamento sejam concluídas. Nenhuma informação de progresso é exibida sobre solicitações de cópia enquanto elas estão na fila. As informações sobre o andamento são exibidas quando a cópia é iniciada.

Lidar com a criptografia

É possível copiar um snapshot que foi criptografado usando uma chave de criptografia do AWS KMS . Se você copiar um snapshot criptografado, a cópia desse snapshot também deverá ser criptografada. Se você copiar um instantâneo criptografado dentro do mesmo Região da AWS, poderá criptografar a cópia com a mesma chave de AWS KMS criptografia do instantâneo original ou especificar uma chave de criptografia diferente AWS KMS . Se você copiar um instantâneo criptografado entre regiões, não poderá usar a mesma chave de AWS KMS criptografia para a cópia usada para o instantâneo de origem, pois AWS KMS as chaves são específicas da região. Em vez disso, você deve especificar uma AWS KMS chave válida no destino Região da AWS n.

O snapshot de origem permanece criptografado ao longo do processo de cópia. Para obter mais informações, consulte Proteção de dados no Amazon DocumentDB.

nota

Para snapshots de cluster do Amazon DocumentDB, você não pode criptografar um snapshot de cluster não criptografado quando você copia o snapshot.

Considerações de grupos de parâmetros

Ao copiar um snapshot entre regiões, a cópia não inclui o grupo de parâmetros usado pelo cluster original do Amazon DocumentDB. Quando você restaura um snapshot para criar um novo cluster, esse cluster obtém o grupo de parâmetros padrão para o qual Região da AWS foi criado. Para dar ao novo cluster os mesmos parâmetros que o original, você deve fazer o seguinte:

  1. No destino Região da AWS, crie um grupo de parâmetros do cluster Amazon DocumentDB com as mesmas configurações do cluster original. Se já existir um no novo Região da AWS, você pode usá-lo.

  2. Depois de restaurar o snapshot no destino Região da AWS, modifique o novo cluster Amazon DocumentDB e adicione o grupo de parâmetros novo ou existente da etapa anterior. Para obter mais informações, consulte Modificar um cluster do Amazon DocumentDB.

Cópia de um snapshot de cluster

Você pode copiar um cluster do Amazon DocumentDB usando o AWS Management Console ou o AWS CLI, da seguinte forma.

Using the AWS Management Console

Para fazer uma cópia de um snapshot de cluster usando o AWS Management Console, conclua as etapas a seguir. Esse procedimento funciona para copiar instantâneos de cluster criptografados ou não criptografados, na mesma região Região da AWS ou entre regiões.

  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 Snapshots e, em seguida, escolha o botão à esquerda do snapshot que você deseja copiar.

    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. No menu Actions, escolha Copy.

  4. Na página Fazer cópia do snapshot do cluster resultante, preencha a seção Configurações.

    1. Região de destino: opcional. Para copiar o snapshot do cluster para um diferente Região da AWS, escolha aquele Região da AWS para Região de destino.

    2. Identificador do novo snapshot: digite um nome para o novo snapshot.

      Restrições de nomenclatura do snapshot de destino:

      • Não pode ser o nome de um snapshot existente.

      • O comprimento é de [1 a 63] 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.

      • Deve ser exclusivo para todos os clusters no Amazon RDS, Neptune e Amazon DocumentDB por região. Conta da AWS

    3. Copiar tags: para copiar as tags existentes no snapshot de origem para a sua cópia do snapshot, escolha Copiar tags.

  5. Complete a ncryption-at-rest seção E.

    1. Criptografia em repouso: se o snapshot não estiver criptografado, essas opções não estarão disponíveis para você, pois não é possível criar uma cópia criptografada a partir de um snapshot não criptografado. Se seu snapshot estiver criptografado, você poderá alterar o AWS KMS key usado durante a criptografia em repouso.

      Para obter mais informações sobre criptografia de cópias de snapshot, consulte Copiar criptografia de snapshot de cluster.

      Para obter mais informações sobre criptografia em repouso, consulte Criptografar dados em repouso do Amazon DocumentDB.

    2. AWS KMS Chave — Na lista suspensa, escolha uma das seguintes opções:

      • (padrão) aws/rds — O número da conta e o ID da AWS KMS chave estão listados seguindo essa opção.

      • < some-key-name > — Se você criou uma chave, ela está listada e está disponível para você escolher.

      • Inserir o ARN da chave: na caixa ARN, insira nome do recurso da Amazon (ARN) para a chave do AWS KMS . O formato do ARN é arn:aws:kms:<region>:<accountID>:key/<key-id> .

  6. Para criar uma cópia do snapshot selecionado, escolha Copiar snapshot. Como alternativa, é possível escolher Cancelar para não criar uma cópia do snapshot.

Using the AWS CLI

Para fazer uma cópia de um snapshot não criptografado de cluster usando o AWS CLI, use a operação copy-db-cluster-snapshot com os parâmetros a seguir. Se você estiver copiando o instantâneo para outro Região da AWS, execute o comando no qual Região da AWS o instantâneo será copiado.

  • --source-db-cluster-snapshot-identifier — Obrigatório. O identificador do snapshot de cluster a ser copiado. O snapshot do cluster deve existir e estar no estado disponível. Se você estiver copiando o snapshot para outro Região da AWS ou se estiver copiando um snapshot de cluster compartilhado, esse identificador deverá estar no formato ARN do snapshot do cluster de origem. Esse parâmetro não diferencia maiúsculas de minúsculas.

  • --target-db-cluster-snapshot-identifier — Obrigatório. 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 de nomenclatura do snapshot de destino:

    • Não pode ser o nome de um snapshot existente.

    • O comprimento é de [1 a 63] 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.

    • Deve ser exclusivo para todos os clusters no Amazon RDS, Neptune e Amazon DocumentDB por região. Conta da AWS

  • --source-region— Se você estiver copiando o snapshot para outro Região da AWS, especifique o do qual Região da AWS o snapshot criptografado do cluster será copiado.

    Se estiver copiando o snapshot para outra Região da AWS e não especificar --source-region, deverá especificar o parâmetro pre-signed-url em vez disso. O pre-signed-url valor deve ser uma URL que contenha uma solicitação assinada do Signature Version 4 para que a CopyDBClusterSnapshot ação seja chamada na origem da Região da AWS qual o snapshot do cluster é copiado. Para saber mais sobre opre-signed-url, consulte Copiar DBCluster instantâneo.

  • --kms-key-id: o identificador da chave do KMS da chave a ser usada para criptografar a cópia do snapshot do cluster.

    Se você estiver copiando um snapshot de cluster criptografado para outro Região da AWS, esse parâmetro será obrigatório. Você deve especificar uma chave KMS para o destino Região da AWS.

    Se você estiver copiando um snapshot de cluster criptografado no mesmo Região da AWS, o parâmetro AWS KMS chave é opcional. A cópia do snapshot do cluster é criptografada com a mesma AWS KMS chave do snapshot do cluster de origem. Se quiser especificar uma nova chave de AWS KMS criptografia a ser usada para criptografar a cópia, você pode fazer isso usando esse parâmetro.

  • --copy-tags: opcional. As tags e os valores a serem copiados.

Para cancelar uma operação de cópia quando ela estiver em andamento, é possível excluir o snapshot do cluster de destino identificado por --target-db-cluster-snapshot-identifier ou TargetDBClusterSnapshotIdentifier enquanto ele estiver no status copiando.

Exemplo 1: copiar um snapshot não criptografado para a mesma região

O AWS CLI exemplo a seguir cria uma cópia de sample-cluster-snapshot named sample-cluster-snapshot-copy in da Região da AWS mesma forma que o snapshot de origem. Quando a cópia é feita, todas as tags do snapshot original são copiadas para a cópia do snapshot.

Para Linux, macOS ou Unix:

aws docdb copy-db-cluster-snapshot \
    --source-db-cluster-snapshot-identifier sample-cluster-snapshot \
    --target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy \
    --copy-tags

Para Windows:

aws docdb copy-db-cluster-snapshot ^
    --source-db-cluster-snapshot-identifier sample-cluster-snapshot ^
    --target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy ^
    --copy-tags

A saída dessa operação é semelhante à seguinte.

{
    "DBClusterSnapshot": {
        "AvailabilityZones": [
            "us-east-1a",
            "us-east-1b",
            "us-east-1c"
        ],
        "DBClusterSnapshotIdentifier": "sample-cluster-snapshot-copy",
        "DBClusterIdentifier": "sample-cluster",
        "SnapshotCreateTime": "2020-03-27T08:40:24.805Z",
        "Engine": "docdb",
        "Status": "copying",
        "Port": 0,    
        "VpcId": "vpc-abcd0123",
        "ClusterCreateTime": "2020-01-10T22:13:38.261Z",
        "MasterUsername": "master-user",
        "EngineVersion": "4.0.0",
        "SnapshotType": "manual",
        "PercentProgress": 0,
        "StorageEncrypted": true,
        "KmsKeyId": "arn:aws:kms:us-east-1:111122223333:key/sample-key-id",
        "DBClusterSnapshotArn": "arn:aws:rds:us-east-1:111122223333:cluster-snapshot:sample-cluster-snapshot-copy",
        "SourceDBClusterSnapshotArn": "arn:aws:rds:us-east-1:111122223333:cluster-snapshot:sample-cluster-snapshot"
    }
}

Exemplo 2: Copiar um snapshot não criptografado em Regiões da AWS

O AWS CLI exemplo a seguir cria uma cópia desample-cluster-snapshot, que tem o ARNarn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot. Essa cópia é nomeada sample-cluster-snapshot-copy e está Região da AWS na qual o comando é executado.

Para Linux, macOS ou Unix:

aws docdb copy-db-cluster-snapshot \
    --source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot \
    --target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy

Para Windows:

aws docdb copy-db-cluster-snapshot ^
    --source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot ^
    --target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy

A saída dessa operação é semelhante à seguinte.

{
    "DBClusterSnapshot": {
        "AvailabilityZones": [
            "us-east-1a",
            "us-east-1b",
            "us-east-1c"
        ],
        "DBClusterSnapshotIdentifier": "sample-cluster-snapshot-copy",
        "DBClusterIdentifier": "sample-cluster",
        "SnapshotCreateTime": "2020-04-29T16:45:51.239Z",
        "Engine": "docdb",
        "AllocatedStorage": 0,
        "Status": "copying",
        "Port": 0,
        "VpcId": "vpc-abc0123",
        "ClusterCreateTime": "2020-04-28T16:43:00.294Z",
        "MasterUsername": "master-user",
        "EngineVersion": "4.0.0",
        "LicenseModel": "docdb",
        "SnapshotType": "manual",
        "PercentProgress": 0,
        "StorageEncrypted": false,
        "DBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot-copy",
        "SourceDBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot",
    }
}

Exemplo 3: Copiar um snapshot criptografado em Regiões da AWS

O AWS CLI exemplo a seguir cria uma cópia sample-cluster-snapshot da região us-west-2 para a região us-east-1. Este comando é chamado na região us-east-1.

Para Linux, macOS ou Unix:

aws docdb copy-db-cluster-snapshot \
    --source-db-cluster-snapshot-identifier arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot \
    --target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy \
    --source-region us-west-2 \
    --kms-key-id sample-us-east-1-key

Para Windows:

aws docdb copy-db-cluster-snapshot ^
    --source-db-cluster-snapshot-identifier arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot ^
    --target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy ^
    --source-region us-west-2 ^
    --kms-key-id sample-us-east-1-key

A saída dessa operação é semelhante à seguinte.

{
    "DBClusterSnapshot": {  
        "AvailabilityZones": [],
        "DBClusterSnapshotIdentifier": "sample-cluster-snapshot-copy",
        "DBClusterIdentifier": "sample-cluster",
        "SnapshotCreateTime": "2020-04-29T16:45:53.159Z",
        "Engine": "docdb",
        "AllocatedStorage": 0,
        "Status": "copying",
        "Port": 0,
        "ClusterCreateTime": "2020-04-28T16:43:07.129Z",
        "MasterUsername": "chimera",
        "EngineVersion": "4.0.0",
        "LicenseModel": "docdb",
        "SnapshotType": "manual",
        "PercentProgress": 0,
        "StorageEncrypted": true,
        "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/0846496a-d48e-41c4-9353-86d8301d7e35",
        "DBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot-copy",
        "SourceDBClusterSnapshotArn": "arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot",
    }
}

Exemplo 4: Copiar um snapshot compartilhado não criptografado em Regiões da AWS

O AWS CLI exemplo a seguir, account -123456789012, cria uma cópia de um snapshot de cluster não criptografado sample-cluster-snapshot compartilhado por conta - 999999999999 da região us-east-1 para a região us-west-2. Esse comando é chamado na região us-west-2. Para obter mais informações sobre o compartilhamento de snapshots, consulte Compartilhar um snapshot.

Para Linux, macOS ou Unix:

aws docdb copy-db-cluster-snapshot \
--region us-west-2 \
--source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:999999999999:cluster-snapshot:sample-cluster-snapshot \
--target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy

Para Windows:

aws docdb copy-db-cluster-snapshot ^
--region us-west-2 ^
--source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:999999999999:cluster-snapshot:sample-cluster-snapshot ^
--target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy

A saída dessa operação é semelhante à seguinte.

{
 "DBClusterSnapshots": [
 {
 "AvailabilityZones": [],
 "DBClusterSnapshotIdentifier": "sample-cluster-snapshot-copy",
 "DBClusterIdentifier": "sample-cluster",
 "SnapshotCreateTime": "2025-08-22T11:27:00.497000+00:00",
 "Engine": "docdb",
 "Status": "copying",
 "Port": 0,
 "ClusterCreateTime": "2024-07-02T16:44:50.246000+00:00",
 "MasterUsername": "master-user",
 "EngineVersion": "5.0.0",
 "SnapshotType": "manual",
 "PercentProgress": 0,
 "StorageEncrypted": false,
 "DBClusterSnapshotArn": "arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot-copy",
 "SourceDBClusterSnapshotArn": "arn:aws:rds:us-east-1:999999999999:cluster-snapshot:sample-cluster-snapshot"
 }
 ]
}

Exemplo 5: Copiar um snapshot compartilhado criptografado em Regiões da AWS

O AWS CLI exemplo a seguir, account - 123456789012 cria uma cópia de um snapshot de cluster criptografado sample-cluster-snapshot compartilhado por conta - 999999999999 da região us-east-1 para a região us-west-2. O instantâneo de destino é criptografado com uma chave KMS gerenciada pelo cliente -. arn:aws:kms:us-west-2:123456789012:key/6c1f3264-1797-472b-ba37-03011e682d28 Esse comando é chamado na região us-west-2. Para obter mais informações sobre o compartilhamento de snapshots, consulte Compartilhar um snapshot.

Para Linux, macOS ou Unix:

aws docdb copy-db-cluster-snapshot \
--region us-west-2 \
--source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:999999999999:cluster-snapshot:sample-cluster-snapshot \
--target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy \
--kms-key-id arn:aws:kms:us-west-2:123456789012:key/6c1f3264-1797-472b-ba37-03011e682d28

Para Windows:

aws docdb copy-db-cluster-snapshot ^
--region us-west-2 ^
--source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:999999999999:cluster-snapshot:sample-cluster-snapshot ^
--target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy ^
--kms-key-id arn:aws:kms:us-west-2:123456789012:key/6c1f3264-1797-472b-ba37-03011e682d28

A saída dessa operação é semelhante à seguinte.

{
 "DBClusterSnapshots": [
 {
 "AvailabilityZones": [],
 "DBClusterSnapshotIdentifier": "sample-cluster-snapshot-copy",
 "DBClusterIdentifier": "sample-cluster",
 "SnapshotCreateTime": "2025-08-22T11:27:00.497000+00:00",
 "Engine": "docdb",
 "Status": "copying",
 "Port": 0,
 "ClusterCreateTime": "2024-07-02T16:44:50.246000+00:00",
 "MasterUsername": "master-user",
 "EngineVersion": "5.0.0",
 "SnapshotType": "manual",
 "PercentProgress": 0,
 "StorageEncrypted": true,
 "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/6c1f3264-1797-472b-ba37-03011e682d28",
 "DBClusterSnapshotArn": "arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot-copy",
 "SourceDBClusterSnapshotArn": "arn:aws:rds:us-east-1:999999999999:cluster-snapshot:sample-cluster-snapshot"
 }
 ]
}
nota

Para obter mais informações sobre criptografia de cópias de snapshot, consulte Copiar criptografia de snapshot de cluster.

Para obter mais informações sobre criptografia em repouso, consulte Criptografar dados em repouso do Amazon DocumentDB.