Selecione suas preferências de cookies

Usamos cookies essenciais e ferramentas semelhantes que são necessárias para fornecer nosso site e serviços. Usamos cookies de desempenho para coletar estatísticas anônimas, para que possamos entender como os clientes usam nosso site e fazer as devidas melhorias. Cookies essenciais não podem ser desativados, mas você pode clicar em “Personalizar” ou “Recusar” para recusar cookies de desempenho.

Se você concordar, a AWS e terceiros aprovados também usarão cookies para fornecer recursos úteis do site, lembrar suas preferências e exibir conteúdo relevante, incluindo publicidade relevante. Para aceitar ou recusar todos os cookies não essenciais, clique em “Aceitar” ou “Recusar”. Para fazer escolhas mais detalhadas, clique em “Personalizar”.

StartCopyJob

Modo de foco
StartCopyJob - AWS Backup

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

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

Inicia um trabalho para criar uma cópia única do recurso especificado.

Essa operação não é compatível com backups contínuos.

Sintaxe da Solicitação

PUT /copy-jobs HTTP/1.1 Content-type: application/json { "DestinationBackupVaultArn": "string", "IamRoleArn": "string", "IdempotencyToken": "string", "Lifecycle": { "DeleteAfterDays": number, "MoveToColdStorageAfterDays": number, "OptInToArchiveForSupportedResources": boolean }, "RecoveryPointArn": "string", "SourceBackupVaultName": "string" }

Parâmetros da solicitação de URI

A solicitação não usa nenhum parâmetro de URI.

Corpo da Solicitação

A solicitação aceita os dados a seguir no formato JSON.

DestinationBackupVaultArn

Um nome de recurso da Amazon (ARN) que identifica de forma exclusiva um cofre de backup de destino. Por exemplo, arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault.

Tipo: string

Obrigatório: Sim

IamRoleArn

Especifica o ARN do perfil do IAM usado para copiar o ponto de recuperação de destino. Por exemplo, arn:aws:iam::123456789012:role/S3Access.

Tipo: string

Obrigatório: Sim

IdempotencyToken

Uma string escolhida pelo cliente que pode ser usada para distinguir entre chamadas idênticas a StartCopyJob. Tentar novamente uma solicitação com êxito com o mesmo token de idempotência resultará em uma mensagem de êxito sem nenhuma ação tomada.

Tipo: string

Obrigatório: Não

Lifecycle

Especifica o período, em dias, antes de um ponto de recuperação fazer a transição para o armazenamento a frio, ou seja excluído.

Os backups transferidos para armazenamento "frio" devem ficar armazenados lá por no mínimo 90 dias. Portanto, no console, a configuração de retenção deve ser 90 dias a mais do que a transição para frio após a configuração de dias. A transição para frio após a configuração de dias não poderá ser alterada depois que um backup for transferido para frio.

Os tipos de recursos que podem fazer a transição para o armazenamento refrigerado estão listados na tabela Disponibilidade de recursos por recursos. AWS Backup ignora essa expressão para outros tipos de recursos.

Para remover o ciclo de vida e os períodos de retenção existentes e manter seus pontos de recuperação indefinidamente, especifique -1 para MoveToColdStorageAfterDays e DeleteAfterDays.

Tipo: objeto Lifecycle

Obrigatório: não

RecoveryPointArn

Um ARN que identifica de forma exclusiva um ponto de recuperação a ser usado na tarefa de cópia; por exemplo, arn:aws:backup:us-east- 1:123456789012:recovery-point:1 B5E7-9EB0-435A-A80B-108B488B0D45. EB3

Tipo: string

Obrigatório: Sim

SourceBackupVaultName

O nome de um contêiner lógico de origem em que os backups são armazenados. Os cofres de backup são identificados por nomes exclusivos da conta usada para criá-los e da AWS região em que foram criados.

Tipo: string

Padrão: ^[a-zA-Z0-9\-\_]{2,50}$

Exigido: Sim

Sintaxe da Resposta

HTTP/1.1 200 Content-type: application/json { "CopyJobId": "string", "CreationDate": number, "IsParent": boolean }

Elementos de Resposta

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

CopyJobId

Identifica de forma exclusiva um trabalho de cópia.

Tipo: string

CreationDate

A data e a hora em que um trabalho de cópia foi criado, em formato Unix e Tempo Universal Coordenado (UTC). O valor de CreationDate tem precisão de milissegundos. Por exemplo, o valor 1516925490,087 representa sexta-feira, 26 de janeiro de 2018, 0:11:30,087.

Tipo: carimbo de data/hora

IsParent

Isso um valor booliano retornado que indica que se trata de um trabalho de cópia pai (composto).

Tipo: booliano

Erros

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

InvalidParameterValueException

Indica que há algo errado com o valor de um parâmetro. Por exemplo, o valor está fora do intervalo.

Código de status HTTP: 400

InvalidRequestException

Indica que há algo errado com a entrada da solicitação. Por exemplo, um parâmetro é do tipo errado.

Código de status HTTP: 400

LimitExceededException

Um limite na solicitação foi excedido; por exemplo, o número máximo de itens permitidos em uma solicitação.

Código de status HTTP: 400

MissingParameterValueException

Indica que um parâmetro necessário está ausente.

Código de status HTTP: 400

ResourceNotFoundException

Um recurso necessário para a ação não existe.

Código de status HTTP: 400

ServiceUnavailableException

Houve falha na solicitação devido a um erro temporário do servidor.

Código de status HTTP: 500

Consulte também

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:

PrivacidadeTermos do sitePreferências de cookies
© 2025, Amazon Web Services, Inc. ou suas afiliadas. Todos os direitos reservados.