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).
Sintaks Permintaan
PUT /restore-jobs HTTP/1.1
Content-type: application/json
{
"CopySourceTagsToRestoredResource": boolean
,
"IamRoleArn": "string
",
"IdempotencyToken": "string
",
"Metadata": {
"string
" : "string
"
},
"RecoveryPointArn": "string
",
"ResourceType": "string
"
}
URIParameter Permintaan
Permintaan tidak menggunakan URI parameter apa pun.
Isi Permintaan
Permintaan menerima data berikut dalam JSON format.
- CopySourceTagsToRestoredResource
-
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
-
Amazon Resource Name (ARN) dari IAM peran 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 olehGetRecoveryPointRestoreMetadata
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
-
An 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
Tipe: 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.
Data berikut dikembalikan dalam JSON format oleh layanan.
- RestoreJobId
-
Secara unik mengidentifikasi pekerjaan yang mengembalikan titik pemulihan.
Tipe: 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.
HTTPKode Status: 400
- InvalidRequestException
-
Menunjukkan bahwa ada sesuatu yang salah dengan input ke permintaan. Misalnya, parameter adalah tipe yang salah.
HTTPKode Status: 400
- MissingParameterValueException
-
Menunjukkan bahwa parameter yang diperlukan tidak ada.
HTTPKode Status: 400
- ResourceNotFoundException
-
Sumber daya yang diperlukan untuk tindakan tidak ada.
HTTPKode Status: 400
- ServiceUnavailableException
-
Permintaan gagal karena kegagalan sementara server.
HTTPKode Status: 500
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini: