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](#API_StartRestoreJob_RequestSyntax) ** 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 Obbligatorio: no ** [IamRoleArn](#API_StartRestoreJob_RequestSyntax) ** 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 Obbligatorio: no ** [IdempotencyToken](#API_StartRestoreJob_RequestSyntax) ** 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 Obbligatorio: no ** [Metadata](#API_StartRestoreJob_RequestSyntax) ** 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: + [Metadati per Amazon Aurora](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-aur.html#aur-restore-cli) + [Metadati per Amazon DocumentDB](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-docdb.html#docdb-restore-cli) + [Metadati per AWS CloudFormation](https://docs.aws.amazon.com/aws-backup/latest/devguide/restore-application-stacks.html#restoring-cfn-cli) + [Metadati per Amazon DynamoDB](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-dynamodb.html#ddb-restore-cli) + [Metadati per Amazon EBS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-ebs.html#ebs-restore-cli) + [Metadati per Amazon EC2](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-ec2.html#restoring-ec2-cli) + [Metadati per Amazon EFS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-efs.html#efs-restore-cli) + [Metadati per Amazon EKS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-eks.html#eks-restore-backup-section) + [Metadati per Amazon FSx](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-fsx.html#fsx-restore-cli) + [Metadati per Amazon Neptune](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-nep.html#nep-restore-cli) + [Metadati per Amazon RDS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-rds.html#rds-restore-cli) + [Metadati per Amazon Redshift](https://docs.aws.amazon.com/aws-backup/latest/devguide/redshift-restores.html#redshift-restore-api) + [Metadati per Gateway di archiviazione AWS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-storage-gateway.html#restoring-sgw-cli) + [Metadati per Amazon S3](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-s3.html#s3-restore-cli) + [Metadati per Amazon Timestream](https://docs.aws.amazon.com/aws-backup/latest/devguide/timestream-restore.html#timestream-restore-api) + [Metadati per macchine virtuali](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-vm.html#vm-restore-cli) Tipo: mappatura stringa a stringa Obbligatorio: sì ** [RecoveryPointArn](#API_StartRestoreJob_RequestSyntax) ** 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 Obbligatorio: sì ** [ResourceType](#API_StartRestoreJob_RequestSyntax) ** 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 + `EKS`- Servizio Amazon Elastic Kubernetes + `FSx`- Amazon FSx + `Neptune`- Amazon Neptune + `RDS`- Amazon Relational Database Service + `Redshift`- Amazon Redshift + `Storage Gateway` - Gateway di archiviazione AWS + `S3`- Servizio Amazon Simple Storage + `Timestream`- Amazon Timestream + `VirtualMachine`- Macchine virtuali Tipo: stringa Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$` 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](#API_StartRestoreJob_ResponseSyntax) ** Identifica in modo univoco il processo che ripristina un punto di ripristino. Tipo: String ## Errori Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md). ** 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: + [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/StartRestoreJob) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartRestoreJob) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartRestoreJob) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartRestoreJob) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartRestoreJob) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartRestoreJob) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartRestoreJob) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartRestoreJob) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartRestoreJob) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartRestoreJob)