Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
ListRestoreJobs
Devuelve una lista de los trabajos que AWS Backup se iniciaron para restaurar un recurso guardado, incluidos los detalles del proceso de recuperación.
Sintaxis de la solicitud
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 de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
- ByAccountId
-
El ID de la cuenta desde la que se van a enumerar los trabajos. Devuelve solo los trabajos de restauración asociados al ID de cuenta especificado.
Patrón:
^[0-9]{12}$
- ByCompleteAfter
-
Devuelve solo los trabajos de copia completados después de una fecha expresada en formato Unix y horario universal coordinado (UTC).
- ByCompleteBefore
-
Devuelve solo los trabajos de copia completados antes de una fecha expresada en formato Unix y horario universal coordinado (UTC).
- ByCreatedAfter
-
Devuelve solo los trabajos de restauración que se crearon después de la fecha especificada.
- ByCreatedBefore
-
Devuelve solo los trabajos de restauración que se crearon antes de la fecha especificada.
- ByResourceType
-
Incluya este parámetro para devolver únicamente los trabajos de restauración de los recursos especificados:
-
Aurora
para Amazon Aurora -
CloudFormation
para AWS CloudFormation -
DocumentDB
para Amazon DocumentDB (con compatibilidad con MongoDB) -
DynamoDB
para Amazon DynamoDB -
EBS
para Amazon Elastic Block Store (EBS) -
EC2
para Amazon Elastic Compute Cloud -
EFS
para Amazon Elastic File System -
FSx
para Amazon FSx -
Neptune
para Amazon Neptune -
Redshift
para Amazon Redshift -
RDS
para Amazon Relational Database Service -
SAP HANA on Amazon EC2
para bases de datos de SAP HANA -
Storage Gateway
para AWS Storage Gateway -
S3
para Amazon S3 -
Timestream
para Amazon Timestream -
VirtualMachine
para máquinas virtuales
Patrón:
^[a-zA-Z0-9\-\_\.]{1,50}$
-
- ByRestoreTestingPlanArn
-
Devuelve solo los trabajos de restauración que coinciden con el nombre de recurso de Amazon (ARN) del recurso especificado.
- ByStatus
-
Devuelve solo los trabajos de restauración asociados al estado de trabajo especificado.
Valores válidos:
PENDING | RUNNING | COMPLETED | ABORTED | FAILED
- MaxResults
-
Número máximo de elementos que se van a devolver.
Rango válido: valor mínimo de 1. Valor máximo de 1000.
- NextToken
-
El siguiente elemento que sigue a una lista parcial de elementos devueltos. Por ejemplo, si se solicita que se devuelva el número de elementos
MaxResults
,NextToken
permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.
Cuerpo de la solicitud
La solicitud no tiene un cuerpo de la solicitud.
Sintaxis de la respuesta
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 respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- NextToken
-
El siguiente elemento que sigue a una lista parcial de elementos devueltos. Por ejemplo, si se solicita que se devuelva el número de elementos
MaxResults
,NextToken
permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.Tipo: cadena
- RestoreJobs
-
Una matriz de objetos que contiene información detallada sobre los trabajos para restaurar los recursos guardados.
Tipo: matriz de objetos RestoreJobsListMember
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- InvalidParameterValueException
-
Indica que hay algún problema con el valor de un parámetro. Por ejemplo, el valor está fuera del rango.
Código de estado HTTP: 400
- MissingParameterValueException
-
Indica que falta un parámetro obligatorio.
Código de estado HTTP: 400
- ResourceNotFoundException
-
No existe un recurso necesario para la acción.
Código de estado HTTP: 400
- ServiceUnavailableException
-
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.
Código de estado HTTP: 500
Véase también
Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulta lo siguiente: