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/S3AccessTipo: cadena
Requerido: no
- IdempotencyToken
-
Una cadena elegida por el cliente que puede utilizar para distinguir entre llamadas a
StartRestoreJobque, 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 recursoGetRecoveryPointRestoreMetadata. 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- Amazon Elastic Block Store -
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: cadena
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.
- Context
- Type
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.
- 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
Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
