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.

# DescribeRestoreJob
<a name="API_DescribeRestoreJob"></a>

Devuelve los metadatos asociados a un trabajo de restauración especificado mediante un ID de trabajo.

## Sintaxis de la solicitud
<a name="API_DescribeRestoreJob_RequestSyntax"></a>

```
GET /restore-jobs/restoreJobId HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DescribeRestoreJob_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [restoreJobId](#API_DescribeRestoreJob_RequestSyntax) **   <a name="Backup-DescribeRestoreJob-request-uri-RestoreJobId"></a>
Identifica de forma exclusiva el trabajo que restaura un punto de recuperación.  
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DescribeRestoreJob_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DescribeRestoreJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AccountId": "string",
   "BackupSizeInBytes": number,
   "BackupVaultArn": "string",
   "CompletionDate": number,
   "CreatedBy": { 
      "RestoreTestingPlanArn": "string"
   },
   "CreatedResourceArn": "string",
   "CreationDate": number,
   "DeletionStatus": "string",
   "DeletionStatusMessage": "string",
   "ExpectedCompletionTimeMinutes": number,
   "IamRoleArn": "string",
   "IsParent": boolean,
   "ParentJobId": "string",
   "PercentDone": "string",
   "RecoveryPointArn": "string",
   "RecoveryPointCreationDate": number,
   "ResourceType": "string",
   "RestoreJobId": "string",
   "SourceResourceArn": "string",
   "Status": "string",
   "StatusMessage": "string",
   "ValidationStatus": "string",
   "ValidationStatusMessage": "string"
}
```

## Elementos de respuesta
<a name="API_DescribeRestoreJob_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [AccountId](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-AccountId"></a>
Devuelve el ID de la cuenta a la que pertenece el trabajo de restauración.  
Tipo: cadena  
Patrón: `^[0-9]{12}$` 

 ** [BackupSizeInBytes](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-BackupSizeInBytes"></a>
El tamaño del recurso restaurado, en bytes.  
Tipo: largo

 ** [BackupVaultArn](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-BackupVaultArn"></a>
Es el Nombre de recurso de Amazon (ARN) del almacén de copias de seguridad que contiene el punto de recuperación que se va a restaurar. Esto ayuda a identificar las políticas y los permisos de acceso al almacén.  
Tipo: cadena

 ** [CompletionDate](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-CompletionDate"></a>
La fecha y la hora en que se completó un trabajo para restaurar un punto de recuperación, en formato Unix y horario universal coordinado (UTC). El valor de `CompletionDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [CreatedBy](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-CreatedBy"></a>
Contiene información de identificación sobre la creación de un trabajo de restauración.  
Tipo: objeto [RestoreJobCreator](API_RestoreJobCreator.md)

 ** [CreatedResourceArn](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-CreatedResourceArn"></a>
El nombre de recurso de Amazon (ARN) del recurso que creó el trabajo de restauración.  
El formato del ARN depende del tipo de recurso del que se ha hecho copia de seguridad.  
Tipo: cadena

 ** [CreationDate](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-CreationDate"></a>
La fecha y la hora en que se creó un trabajo de restauración, en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [DeletionStatus](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-DeletionStatus"></a>
El estado de los datos generados por la prueba de restauración.  
Tipo: cadena  
Valores válidos: `DELETING | FAILED | SUCCESSFUL` 

 ** [DeletionStatusMessage](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-DeletionStatusMessage"></a>
Describe el estado de eliminación del trabajo de restauración.  
Tipo: cadena

 ** [ExpectedCompletionTimeMinutes](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-ExpectedCompletionTimeMinutes"></a>
La cantidad de tiempo en minutos que se espera que tarde un trabajo de restauración de un punto de recuperación.  
Tipo: largo

 ** [IamRoleArn](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-IamRoleArn"></a>
Especifica el ARN del rol de IAM utilizado para crear el punto de recuperación de destino; por ejemplo, `arn:aws:iam::123456789012:role/S3Access`.  
Tipo: cadena

 ** [IsParent](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-IsParent"></a>
Se trata de un valor booleano que indica si el trabajo de restauración es un trabajo de restauración principal (compuesto).  
Tipo: Booleano

 ** [ParentJobId](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-ParentJobId"></a>
Es el identificador único del trabajo de restauración principal del trabajo de restauración seleccionado.  
Tipo: cadena

 ** [PercentDone](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-PercentDone"></a>
Contiene el porcentaje estimado que se ha completado de un trabajo en el momento en que se consultó el estado del trabajo.  
Tipo: cadena

 ** [RecoveryPointArn](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-RecoveryPointArn"></a>
Un ARN que identifica de forma exclusiva un punto de recuperación; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Tipo: cadena

 ** [RecoveryPointCreationDate](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-RecoveryPointCreationDate"></a>
La fecha de creación del punto de recuperación creado por el trabajo de restauración especificado.  
Tipo: marca temporal

 ** [ResourceType](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-ResourceType"></a>
Devuelve los metadatos asociados a un trabajo de restauración enumerados por tipo de recurso.  
Tipo: cadena  
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [RestoreJobId](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-RestoreJobId"></a>
Identifica de forma exclusiva el trabajo que restaura un punto de recuperación.  
Tipo: cadena

 ** [SourceResourceArn](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-SourceResourceArn"></a>
Es el Nombre de recurso de Amazon (ARN) del recurso original del que se ha realizado la copia de seguridad. Proporciona un contexto sobre el recurso que se está restaurando.  
Tipo: cadena

 ** [Status](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-Status"></a>
Código de estado que especifica el estado del trabajo que se inicia AWS Backup para restaurar un punto de recuperación.  
Tipo: cadena  
Valores válidos: `PENDING | RUNNING | COMPLETED | ABORTED | FAILED` 

 ** [StatusMessage](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-StatusMessage"></a>
Un mensaje que muestra el estado de un trabajo para restaurar un punto de recuperación.  
Tipo: cadena

 ** [ValidationStatus](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-ValidationStatus"></a>
El estado de la validación ejecutada en el trabajo de restauración indicado.  
Tipo: cadena  
Valores válidos: `FAILED | SUCCESSFUL | TIMED_OUT | VALIDATING` 

 ** [ValidationStatusMessage](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-ValidationStatusMessage"></a>
Mensaje del estado.  
Tipo: cadena

## Errores
<a name="API_DescribeRestoreJob_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** DependencyFailureException **   
Un AWS servicio o recurso dependiente devolvió un error al AWS Backup servicio y la acción no se pudo completar.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

 ** InvalidParameterValueException **   
Indica que hay algún problema con el valor de un parámetro. Por ejemplo, el valor está fuera del rango.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No existe un recurso necesario para la acción.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_DescribeRestoreJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeRestoreJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeRestoreJob)