

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# StartRestoreJob
<a name="API_StartRestoreJob"></a>

Memulihkan sumber daya tersimpan yang diidentifikasi oleh Amazon Resource Name (ARN).

## Minta Sintaks
<a name="API_StartRestoreJob_RequestSyntax"></a>

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

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

## Parameter Permintaan URI
<a name="API_StartRestoreJob_RequestParameters"></a>

Permintaan tidak menggunakan parameter URI apa pun.

## Isi Permintaan
<a name="API_StartRestoreJob_RequestBody"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [CopySourceTagsToRestoredResource](#API_StartRestoreJob_RequestSyntax) **   <a name="Backup-StartRestoreJob-request-CopySourceTagsToRestoredResource"></a>
Ini adalah parameter opsional. Jika ini sama`True`, tag yang disertakan dalam cadangan akan disalin ke sumber daya yang dipulihkan.  
Ini hanya dapat diterapkan pada cadangan yang dibuat melalui. AWS Backup  
Tipe: Boolean  
Wajib: Tidak

 ** [IamRoleArn](#API_StartRestoreJob_RequestSyntax) **   <a name="Backup-StartRestoreJob-request-IamRoleArn"></a>
Nama Sumber Daya Amazon (ARN) dari peran IAM yang AWS Backup digunakan untuk membuat sumber daya target; misalnya:. `arn:aws:iam::123456789012:role/S3Access`  
Tipe: String  
Wajib: Tidak

 ** [IdempotencyToken](#API_StartRestoreJob_RequestSyntax) **   <a name="Backup-StartRestoreJob-request-IdempotencyToken"></a>
String yang dipilih pelanggan yang dapat Anda gunakan untuk membedakan antara panggilan yang identik. `StartRestoreJob` Mencoba kembali permintaan yang berhasil dengan token idempotensi yang sama menghasilkan pesan sukses tanpa tindakan yang diambil.  
Tipe: String  
Wajib: Tidak

 ** [Metadata](#API_StartRestoreJob_RequestSyntax) **   <a name="Backup-StartRestoreJob-request-Metadata"></a>
Satu set pasangan nilai kunci metadata.  
Anda bisa mendapatkan metadata konfigurasi tentang sumber daya pada saat itu dicadangkan dengan menelepon. `GetRecoveryPointRestoreMetadata` Namun, nilai selain yang disediakan oleh `GetRecoveryPointRestoreMetadata` mungkin diperlukan untuk memulihkan sumber daya. Misalnya, Anda mungkin perlu memberikan nama sumber daya baru jika yang asli sudah ada.  
Untuk informasi selengkapnya tentang metadata untuk setiap sumber daya, lihat berikut ini:  
+  [Metadata untuk Amazon Aurora](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-aur.html#aur-restore-cli) 
+  [Metadata untuk Amazon DocumentDB](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-docdb.html#docdb-restore-cli) 
+  [Metadata untuk AWS CloudFormation](https://docs.aws.amazon.com/aws-backup/latest/devguide/restore-application-stacks.html#restoring-cfn-cli) 
+  [Metadata untuk Amazon DynamoDB](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-dynamodb.html#ddb-restore-cli) 
+  [Metadata untuk Amazon EBS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-ebs.html#ebs-restore-cli) 
+  [Metadata untuk Amazon EC2](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-ec2.html#restoring-ec2-cli) 
+  [Metadata untuk Amazon EFS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-efs.html#efs-restore-cli) 
+  [Metadata untuk Amazon EKS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-eks.html#eks-restore-backup-section) 
+  [Metadata untuk Amazon FSx](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-fsx.html#fsx-restore-cli) 
+  [Metadata untuk Amazon Neptunus](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-nep.html#nep-restore-cli) 
+  [Metadata untuk Amazon RDS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-rds.html#rds-restore-cli) 
+  [Metadata untuk Amazon Redshift](https://docs.aws.amazon.com/aws-backup/latest/devguide/redshift-restores.html#redshift-restore-api) 
+  [Metadata untuk AWS Storage Gateway](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-storage-gateway.html#restoring-sgw-cli) 
+  [Metadata untuk Amazon S3](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-s3.html#s3-restore-cli) 
+  [Metadata untuk Amazon Timestream](https://docs.aws.amazon.com/aws-backup/latest/devguide/timestream-restore.html#timestream-restore-api) 
+  [Metadata untuk mesin virtual](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-vm.html#vm-restore-cli) 
Tipe: Peta string ke string  
Wajib: Ya

 ** [RecoveryPointArn](#API_StartRestoreJob_RequestSyntax) **   <a name="Backup-StartRestoreJob-request-RecoveryPointArn"></a>
ARN yang secara unik mengidentifikasi titik pemulihan; misalnya,. `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`  
Tipe: String  
Diperlukan: Ya

 ** [ResourceType](#API_StartRestoreJob_RequestSyntax) **   <a name="Backup-StartRestoreJob-request-ResourceType"></a>
Memulai pekerjaan untuk memulihkan titik pemulihan untuk salah satu sumber daya berikut:  
+  `Aurora`- Amazon Aurora
+  `DocumentDB`- Amazon DocumentDB
+  `CloudFormation` - AWS CloudFormation 
+  `DynamoDB`- Amazon DynamoDB
+  `EBS`- Toko Blok Elastis Amazon
+  `EC2`- Awan Komputasi Elastis Amazon
+  `EFS`- Amazon Elastic File System
+  `EKS`- Amazon Elastic Kubernetes Service
+  `FSx`- Amazon FSx
+  `Neptune`- Amazon Neptunus
+  `RDS`- Amazon Relational Database Service
+  `Redshift`- Pergeseran Merah Amazon
+  `Storage Gateway` - AWS Storage Gateway 
+  `S3`- Layanan Penyimpanan Sederhana Amazon
+  `Timestream`- Amazon Timestream
+  `VirtualMachine`- Mesin virtual
Tipe: String  
Pola: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Diperlukan: Tidak

## Sintaksis Respons
<a name="API_StartRestoreJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "RestoreJobId": "string"
}
```

## Elemen Respons
<a name="API_StartRestoreJob_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [RestoreJobId](#API_StartRestoreJob_ResponseSyntax) **   <a name="Backup-StartRestoreJob-response-RestoreJobId"></a>
Secara unik mengidentifikasi pekerjaan yang mengembalikan titik pemulihan.  
Tipe: String

## Kesalahan
<a name="API_StartRestoreJob_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Jenis Kesalahan Umum](CommonErrors.md).

 ** InvalidParameterValueException **   
Menunjukkan bahwa ada sesuatu yang salah dengan nilai parameter. Misalnya, nilainya di luar jangkauan.    
 ** Context **   
  
 ** Type **   

Kode Status HTTP: 400

 ** InvalidRequestException **   
Menunjukkan bahwa ada sesuatu yang salah dengan input ke permintaan. Misalnya, parameter adalah tipe yang salah.    
 ** Context **   
  
 ** Type **   

Kode Status HTTP: 400

 ** MissingParameterValueException **   
Menunjukkan bahwa parameter yang diperlukan tidak ada.    
 ** Context **   
  
 ** Type **   

Kode Status HTTP: 400

 ** ResourceNotFoundException **   
Sumber daya yang diperlukan untuk tindakan tidak ada.    
 ** Context **   
  
 ** Type **   

Kode Status HTTP: 400

 ** ServiceUnavailableException **   
Permintaan gagal karena kegagalan sementara server.    
 ** Context **   
  
 ** Type **   

Kode Status HTTP: 500

## Lihat Juga
<a name="API_StartRestoreJob_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/StartRestoreJob) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartRestoreJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartRestoreJob) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartRestoreJob) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartRestoreJob) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartRestoreJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartRestoreJob) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartRestoreJob) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartRestoreJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartRestoreJob) 