DescribeRestoreJob
Retorna metadados associados a um trabalho de restauração especificado por um ID de trabalho.
Sintaxe da Solicitação
GET /restore-jobs/restoreJobId HTTP/1.1
Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
- restoreJobId
-
Identifica de forma exclusiva o trabalho que restaura um ponto de recuperação.
Obrigatório: Sim
Corpo da Solicitação
Essa solicitação não tem corpo.
Sintaxe da resposta
HTTP/1.1 200
Content-type: application/json
{
"AccountId": "string",
"BackupSizeInBytes": number,
"CompletionDate": number,
"CreatedBy": {
"RestoreTestingPlanArn": "string"
},
"CreatedResourceArn": "string",
"CreationDate": number,
"DeletionStatus": "string",
"DeletionStatusMessage": "string",
"ExpectedCompletionTimeMinutes": number,
"IamRoleArn": "string",
"PercentDone": "string",
"RecoveryPointArn": "string",
"RecoveryPointCreationDate": number,
"ResourceType": "string",
"RestoreJobId": "string",
"Status": "string",
"StatusMessage": "string",
"ValidationStatus": "string",
"ValidationStatusMessage": "string"
}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.
- AccountId
-
Retorna o ID da conta da que é proprietária do trabalho de restauração.
Tipo: string
Padrão:
^[0-9]{12}$ - BackupSizeInBytes
-
O tamanho, em bytes, do recurso restaurado.
Tipo: longo
- CompletionDate
-
A data e a hora em que um trabalho para restaurar um ponto de recuperação foi concluído, em formato Unix e Tempo Universal Coordenado (UTC). O valor de
CompletionDatetem 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
- CreatedBy
-
Contém informações de identificação sobre a criação de um trabalho de restauração.
Tipo: objeto RestoreJobCreator
- CreatedResourceArn
-
O nome do recurso da Amazon (ARN) do recurso que foi criado pelo trabalho de restauração.
O formato do ARN depende do tipo de recurso que está tendo o backup feito.
Tipo: string
- CreationDate
-
A data e hora em que a lista de domínios foi criada, em formato Unix e 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
- DeletionStatus
-
O status dos dados gerados pelo teste de restauração.
Tipo: string
Valores Válidos:
DELETING | FAILED | SUCCESSFUL - DeletionStatusMessage
-
Isso descreve o status de exclusão do trabalho de restauração.
Tipo: string
- ExpectedCompletionTimeMinutes
-
A quantidade de tempo, em minutos, que se espera que um trabalho de restauração de um ponto de recuperação leve.
Tipo: longo
- IamRoleArn
-
Especifica o ARN do perfil do IAM usado para criar o ponto de recuperação de destino. Por exemplo,
arn:aws:iam::123456789012:role/S3Access.Tipo: string
- PercentDone
-
Contém uma porcentagem estimada de conclusão de um trabalho no momento em que o status do trabalho foi consultado.
Tipo: string
- RecoveryPointArn
-
Um ARN que identifica de forma exclusiva um ponto de recuperação. Por exemplo,
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45.Tipo: string
- RecoveryPointCreationDate
-
A data de criação do ponto de recuperação criado pelo trabalho de restauração especificado.
Tipo: carimbo de data/hora
- ResourceType
-
Retorna metadados associados a um trabalho de restauração listado por tipo de recurso.
Tipo: string
Padrão:
^[a-zA-Z0-9\-\_\.]{1,50}$ - RestoreJobId
-
Identifica de forma exclusiva o trabalho que restaura um ponto de recuperação.
Tipo: string
- Status
-
Código de status que especifica o estado do trabalho que foi iniciado pelo AWS Backup para restaurar um ponto de recuperação.
Tipo: string
Valores Válidos:
PENDING | RUNNING | COMPLETED | ABORTED | FAILED - StatusMessage
-
Uma mensagem mostrando o status de um trabalho para restaurar um ponto de recuperação.
Tipo: string
- ValidationStatus
-
O status da validação executada no trabalho de restauração indicado.
Tipo: string
Valores Válidos:
FAILED | SUCCESSFUL | TIMED_OUT | VALIDATING - ValidationStatusMessage
-
A mensagem de status.
Tipo: string
Erros
Para obter informações sobre os erros comuns a todas as ações, consulte Erros comuns.
- DependencyFailureException
-
Um serviço ou recurso dependente da AWS retornou um erro ao serviço do AWS Backup e não foi possível concluir a ação.
Código de Status HTTP: 500
- 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
- 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 um dos SDKs específicos de linguagem AWS, consulte:
