StartRestoreJob - AWS Backup
Sintassi della richiestaURIParametri della richiestaCorpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

StartRestoreJob

Recupera la risorsa salvata identificata da un Amazon Resource Name (ARN).

Sintassi della richiesta

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

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

URIParametri della richiesta

La richiesta non utilizza alcun URI parametro.

Corpo della richiesta

La richiesta accetta i seguenti dati nel JSON formato.

CopySourceTagsToRestoredResource

Si tratta di un parametro facoltativo. Se questo è uguale a True, i tag inclusi nel backup verranno copiati nella risorsa ripristinata.

Questo può essere applicato solo ai backup creati tramite AWS Backup.

Tipo: Booleano

Campo obbligatorio: no

IamRoleArn

L'Amazon Resource Name (ARN) del IAM ruolo AWS Backup utilizzato per creare la risorsa di destinazione; per esempio:arn:aws:iam::123456789012:role/S3Access.

Tipo: string

Campo obbligatorio: no

IdempotencyToken

Una stringa scelta dal cliente che puoi usare per distinguere tra chiamate altrimenti identiche a StartRestoreJob. Riprovare una richiesta riuscita con lo stesso token di idempotenza restituisce un messaggio di completamento senza alcuna azione eseguita.

Tipo: string

Campo obbligatorio: no

Metadata

Un set di coppie chiave-valore di metadati.

Puoi ottenere i metadati di configurazione relativi a una risorsa al momento del backup chiamando GetRecoveryPointRestoreMetadata. Tuttavia, per ripristinare una risorsa potrebbero essere necessari altri valori oltre a quelli forniti da GetRecoveryPointRestoreMetadata. Ad esempio, potrebbe essere necessario fornire un nuovo nome di risorsa se l'originale esiste già.

Per ulteriori informazioni sui metadati per ciascuna risorsa, consulta quanto segue:

Tipo: mappatura stringa a stringa

Campo obbligatorio: sì

RecoveryPointArn

E ARN che identifica in modo univoco un punto di ripristino; per esempio,. arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45

Tipo: stringa

Campo obbligatorio: sì

ResourceType

Avvia un processo per ripristinare un punto di ripristino per una delle seguenti risorse:

  • 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- Servizio Amazon Simple Storage

  • Timestream- Amazon Timestream

  • VirtualMachine- Macchine virtuali

Tipo: stringa

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

Campo obbligatorio: no

Sintassi della risposta

HTTP/1.1 200
Content-type: application/json

{
   "RestoreJobId": "string"
}

Elementi di risposta

Se l'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.

I seguenti dati vengono restituiti in JSON formato dal servizio.

RestoreJobId

Identifica in modo univoco il processo che ripristina un punto di ripristino.

Tipo: stringa

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

InvalidParameterValueException

Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.

HTTPCodice di stato: 400

InvalidRequestException

Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.

HTTPCodice di stato: 400

MissingParameterValueException

Indica che manca un parametro obbligatorio.

HTTPCodice di stato: 400

ResourceNotFoundException

Una risorsa necessaria per l'azione non esiste.

HTTPCodice di stato: 400

ServiceUnavailableException

La richiesta non è riuscita a causa di un errore temporaneo del server.

HTTPCodice di stato: 500

Vedi anche

Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue: