StartRestoreJob - AWS Backup
Sintassi della richiestaParametri della richiesta URI:Corpo 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 nome della risorsa Amazon (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"
}

Parametri della richiesta URI:

La richiesta non utilizza parametri URI.

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

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 ruolo IAM AWS Backup utilizzato per creare la risorsa di destinazione; ad esempio:. arn:aws:iam::123456789012:role/S3Access

▬Tipo: stringa

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: stringa

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 ogni risorsa, consulta quanto segue:

Tipo: mappatura stringa a stringa

Campo obbligatorio: sì

RecoveryPointArn

Un ARN che identifica in modo univoco un punto di ripristino; ad 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'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il 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.

Context

Type

Codice di stato HTTP: 400

InvalidRequestException

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

Context

Type

Codice di stato HTTP: 400

MissingParameterValueException

Indica che manca un parametro obbligatorio.

Context

Type

Codice di stato HTTP: 400

ResourceNotFoundException

Una risorsa necessaria per l'azione non esiste.

Context

Type

Codice di stato HTTP: 400

ServiceUnavailableException

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

Context

Type

Codice di stato HTTP: 500

Vedi anche

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