StartRestoreJob - AWS Backup

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

StartRestoreJob

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

Minta Sintaks

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

Permintaan tidak menggunakan parameter URI apa pun.

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

CopySourceTagsToRestoredResource

Ini adalah parameter opsional. Jika ini samaTrue, 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

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

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

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:

Tipe: Peta string ke string

Wajib: Ya

RecoveryPointArn

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

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

  • 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

Jenis: String

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

Diperlukan: Tidak

Sintaksis Respons

HTTP/1.1 200 Content-type: application/json { "RestoreJobId": "string" }

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

RestoreJobId

Secara unik mengidentifikasi pekerjaan yang mengembalikan titik pemulihan.

Jenis: String

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

InvalidParameterValueException

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

Kode Status HTTP: 400

InvalidRequestException

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

Kode Status HTTP: 400

MissingParameterValueException

Menunjukkan bahwa parameter yang diperlukan tidak ada.

Kode Status HTTP: 400

ResourceNotFoundException

Sumber daya yang diperlukan untuk tindakan tidak ada.

Kode Status HTTP: 400

ServiceUnavailableException

Permintaan gagal karena kegagalan sementara server.

Kode Status HTTP: 500

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: