ListRestoreJobs - AWS Backup
Sintaxe da SolicitaçãoParâmetros da Solicitação de URICorpo da SolicitaçãoSintaxe da respostaElementos de RespostaErrosConsulte também

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

ListRestoreJobs

Retorna uma lista de trabalhos AWS Backup iniciados para restaurar um recurso salvo, incluindo detalhes sobre o processo de recuperação.

Sintaxe da Solicitação

GET /restore-jobs/?accountId=ByAccountId&completeAfter=ByCompleteAfter&completeBefore=ByCompleteBefore&createdAfter=ByCreatedAfter&createdBefore=ByCreatedBefore&maxResults=MaxResults&nextToken=NextToken&resourceType=ByResourceType&restoreTestingPlanArn=ByRestoreTestingPlanArn&status=ByStatus HTTP/1.1

Parâmetros da Solicitação de URI

A solicitação usa os seguintes parâmetros de URI:

ByAccountId

O ID da conta a partir da qual listar os trabalhos. Retorna somente trabalhos de restauração associados ao ID da conta especificada.

Padrão: ^[0-9]{12}$

ByCompleteAfter

Retorna somente os trabalhos de cópia concluídos após uma data expressa em formato Unix e Tempo Universal Coordenado (UTC).

ByCompleteBefore

Retorna somente os trabalhos de cópia concluídos após uma data expressa em formato Unix e Tempo Universal Coordenado (UTC).

ByCreatedAfter

Retorna somente trabalhos de restauração que foram criados após a data especificada.

ByCreatedBefore

Retorna somente trabalhos de restauração que foram criados antes da data especificada.

ByResourceType

Inclua esse parâmetro para retornar somente trabalhos de restauração para os recursos especificados:

  • Aurora para Amazon Aurora

  • CloudFormationpara AWS CloudFormation

  • DocumentDB para Amazon DocumentDB (compatível com MongoDB)

  • DynamoDB para Amazon DynamoDB

  • EBS para Amazon Elastic Block Store

  • EC2 para Amazon Elastic Compute Cloud

  • EFS para Amazon Elastic File System

  • FSxpara Amazon FSx

  • Neptune para Amazon Neptune

  • RDS para Amazon Relational Database Service

  • Redshift para Amazon Redshift

  • S3 para Amazon Simple Storage Service (Amazon S3)

  • SAP HANA on Amazon EC2 para bancos de dados SAP HANA em instâncias do Amazon Elastic Compute Cloud

  • Storage Gatewaypara AWS Storage Gateway

  • Timestream para Amazon Timestream

  • VirtualMachinepara máquinas VMware virtuais

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

ByRestoreTestingPlanArn

Isso retorna somente os trabalhos de testes de restauração que correspondem ao nome do recurso da Amazon (ARN) especificado.

ByStatus

Retorna somente trabalhos de restauração associados ao status do trabalho especificado.

Valores Válidos: PENDING | RUNNING | COMPLETED | ABORTED | FAILED

MaxResults

O número máximo de itens a serem retornados.

Intervalo válido: valor mínimo de 1. Valor máximo de 1.000.

NextToken

O próximo item após uma lista parcial dos itens retornados. Por exemplo, se for feita uma solicitação para retornar o número MaxResults de itens, o NextToken permitirá que você retorne mais itens em sua lista começando pelo local apontado pelo próximo token.

Corpo da Solicitação

Essa solicitação não tem corpo.

Sintaxe da resposta

HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "RestoreJobs": [ 
      { 
         "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.

NextToken

O próximo item após uma lista parcial dos itens retornados. Por exemplo, se for feita uma solicitação para retornar o número MaxResults de itens, o NextToken permitirá que você retorne mais itens em sua lista começando pelo local apontado pelo próximo token.

Tipo: String

RestoreJobs

Uma matriz de objetos que contém informações detalhadas sobre trabalhos para restaurar recursos salvos.

Tipo: matriz de objetos RestoreJobsListMember

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.

Context

Type

Código de status HTTP: 400

MissingParameterValueException

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

Context

Type

Código de status HTTP: 400

ResourceNotFoundException

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

Context

Type

Código de status HTTP: 400

ServiceUnavailableException

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

Context

Type

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: