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"
}URIParámetros de solicitud
La solicitud no utiliza ningún URI parámetro.
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en JSON formato.
- 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) del IAM rol 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
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
-
Y ARN que identifica de forma única 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: 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 de HTTP 200.
El servicio devuelve los siguientes datos en JSON formato.
- 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.
HTTPCódigo de estado: 400
- InvalidRequestException
-
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.
HTTPCódigo de estado: 400
- MissingParameterValueException
-
Indica que falta un parámetro obligatorio.
HTTPCódigo de estado: 400
- ResourceNotFoundException
-
No existe un recurso necesario para la acción.
HTTPCódigo de estado: 400
- ServiceUnavailableException
-
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.
HTTPCódigo de estado: 500
Véase también
Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
