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á.
StartCopyJob
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"
}URIParâmetros de solicitação
A solicitação não usa nenhum URI parâmetro.
Corpo da Solicitação
A solicitação aceita os seguintes dados no JSON formato.
- DestinationBackupVaultArn
-
Um nome de recurso da Amazon (ARN) que identifica de forma exclusiva um cofre de backup de destino para o qual copiar; por exemplo,.
arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVaultTipo: string
Obrigatório: Sim
- IamRoleArn
-
Especifica a IAM função ARN usada 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 de tempo, em dias, antes que um ponto de recuperação faça a transição para o armazenamento refrigerado 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 maior do que a configuração de transição para frio após dias. A configuração de transição para frio após dias não pode ser alterada após a transição de um backup 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 e.
MoveToColdStorageAfterDaysDeleteAfterDaysTipo: objeto Lifecycle
Obrigatório: Não
- RecoveryPointArn
-
E ARN que identifica de forma exclusiva um ponto de recuperação a ser usado para o trabalho de cópia; por exemplo, arn:aws:backup:us-east- 1:123456789012:recovery-point:1 -9EB0-435A-A80B-108B488B0D45. EB3B5E7
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 de 200.
Os dados a seguir são retornados em JSON formato 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 é criado, no formato Unix e no Tempo Universal Coordenado (UTC). O valor de
CreationDatetem 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.
HTTPCódigo de status: 400
- InvalidRequestException
-
Indica que há algo errado com a entrada da solicitação. Por exemplo, um parâmetro é do tipo errado.
HTTPCódigo de status: 400
- LimitExceededException
-
Um limite na solicitação foi excedido; por exemplo, o número máximo de itens permitidos em uma solicitação.
HTTPCódigo de status: 400
- MissingParameterValueException
-
Indica que um parâmetro necessário está ausente.
HTTPCódigo de status: 400
- ResourceNotFoundException
-
Um recurso necessário para a ação não existe.
HTTPCódigo de status: 400
- ServiceUnavailableException
-
Houve falha na solicitação devido a um erro temporário do servidor.
HTTPCódigo de status: 500
Consulte também
Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte:
