StartRestoreJob - AWS Backup
Sintaxis de la solicitudParámetros de solicitud del URICuerpo de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

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.

StartRestoreJob

Recupera el recurso guardado identificado por un nombre de recurso de Amazon (ARN).

Sintaxis de la solicitud

PUT /restore-jobs HTTP/1.1
Content-type: application/json

{
   "CopySourceTagsToRestoredResource": boolean,
   "IamRoleArn": "string",
   "IdempotencyToken": "string",
   "Metadata": { 
      "string" : "string" 
   },
   "RecoveryPointArn": "string",
   "ResourceType": "string"
}

Parámetros de solicitud del URI

La solicitud no utiliza ningún parámetro de URI.

Cuerpo de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

CopySourceTagsToRestoredResource

Se trata de un parámetro opcional. Si es igual a True, las etiquetas incluidas en la copia de seguridad se copiarán en el recurso restaurado.

Esto solo se puede aplicar a las copias de seguridad creadas mediante AWS Backup.

Tipo: Booleano

Obligatorio: no

IamRoleArn

El nombre del recurso de Amazon (ARN) de la función de IAM que se AWS Backup utiliza para crear el recurso de destino; por ejemplo:. arn:aws:iam::123456789012:role/S3Access

Tipo: cadena

Requerido: no

IdempotencyToken

Una cadena elegida por el cliente que puede utilizar para distinguir entre llamadas a StartRestoreJob que, de otro modo, serían idénticas. Si se vuelve a intentar una solicitud correcta con el mismo token de idempotencia, aparece un mensaje de confirmación y no se realiza ninguna acción.

Tipo: cadena

Requerido: no

Metadata

Un conjunto de pares clave-valor de metadatos.

Para obtener los metadatos de configuración de un recurso en el momento en que se realizó la copia de seguridad, solo tiene que llamar a GetRecoveryPointRestoreMetadata. Sin embargo, es posible que para restaurar un recurso se necesiten valores adicionales a los proporcionados por el recurso GetRecoveryPointRestoreMetadata. Por ejemplo, puede que tenga que proporcionar un nombre de recurso nuevo si el original ya existe.

Para obtener más información sobre los metadatos de cada recurso, consulte lo siguiente:

Tipo: mapa de cadena a cadena

Obligatorio: sí

RecoveryPointArn

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

Obligatorio: sí

ResourceType

Inicia un trabajo para restaurar un punto de recuperación para uno de los siguientes recursos:

  • Aurora- Amazon Aurora

  • DocumentDB- Amazon DocumentDB

  • CloudFormation - AWS CloudFormation

  • DynamoDB- Amazon DynamoDB

  • EBS- Tienda Amazon Elastic Block

  • EC2- Amazon Elastic Compute Cloud

  • EFS- Amazon Elastic File System

  • FSx- Amazon FSx

  • Neptune- Amazon Neptune

  • RDS- Amazon Relational Database Service

  • Redshift- Amazon Redshift

  • Storage Gateway - AWS Storage Gateway

  • S3- Amazon Simple Storage Service

  • Timestream- Amazon Timestream

  • VirtualMachine- Máquinas virtuales

Tipo: String

Patrón: ^[a-zA-Z0-9\-\_\.]{1,50}$

Obligatorio: no

Sintaxis de la respuesta

HTTP/1.1 200
Content-type: application/json

{
   "RestoreJobId": "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.

RestoreJobId

Identifica de forma exclusiva el trabajo que restaura un punto de recuperación.

Tipo: cadena

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

InvalidRequestException

Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.

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: