StartSearchResultExportJob - AWS Backup

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

StartSearchResultExportJob

Operasi ini memulai pekerjaan untuk mengekspor hasil pekerjaan pencarian ke bucket S3 yang ditunjuk.

Minta Sintaks

PUT /export-search-jobs HTTP/1.1 Content-type: application/json { "ClientToken": "string", "ExportSpecification": { ... }, "RoleArn": "string", "SearchJobIdentifier": "string", "Tags": { "string" : "string" } }

Parameter Permintaan URI

Permintaan tidak menggunakan parameter URI apa pun.

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

ClientToken

Sertakan parameter ini untuk memungkinkan beberapa panggilan identik untuk idempotensi.

Token klien berlaku selama 8 jam setelah permintaan pertama yang menggunakannya selesai. Setelah waktu ini, permintaan apa pun dengan token yang sama diperlakukan sebagai permintaan baru.

Tipe: String

Wajib: Tidak

ExportSpecification

Spesifikasi ini berisi string yang diperlukan dari bucket tujuan; secara opsional, Anda dapat menyertakan awalan tujuan.

Tipe: Objek ExportSpecification

Catatan: Objek ini adalah Union. Hanya satu anggota objek ini yang dapat ditentukan atau dikembalikan.

Wajib: Ya

RoleArn

Parameter ini menentukan peran ARN digunakan untuk memulai pekerjaan ekspor hasil pencarian.

Tipe: String

Batasan Panjang: Panjang minimum 20. Panjang maksimum 2048.

Pola: arn:(?:aws|aws-cn|aws-us-gov):iam::[a-z0-9-]+:role/(.+)

Wajib: Tidak

SearchJobIdentifier

String unik yang menentukan pekerjaan pencarian.

Tipe: String

Diperlukan: Ya

Tags

Tag opsional untuk disertakan. Tag adalah pasangan kunci-nilai yang dapat Anda gunakan untuk mengelola, memfilter, dan mencari sumber daya Anda. Karakter yang diizinkan termasuk huruf UTF-8, angka, spasi, dan karakter berikut: + - =. _: /.

Tipe: Peta antar string

Wajib: Tidak

Sintaksis Respons

HTTP/1.1 200 Content-type: application/json { "ExportJobArn": "string", "ExportJobIdentifier": "string" }

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

ExportJobArn

Ini adalah ARN (Nama Sumber Daya Amazon) unik yang termasuk dalam pekerjaan ekspor baru.

Tipe: String

ExportJobIdentifier

Ini adalah pengidentifikasi unik yang menentukan pekerjaan ekspor baru.

Tipe: String

Kesalahan

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

AccessDeniedException

Anda tidak memiliki akses yang memadai untuk melakukan tindakan ini.

message

Pengguna tidak memiliki akses yang cukup untuk melakukan tindakan ini.

Kode Status HTTP: 403

ConflictException

Pengecualian ini terjadi ketika konflik dengan operasi sukses sebelumnya terdeteksi. Ini umumnya terjadi ketika operasi sebelumnya tidak punya waktu untuk menyebarkan ke host yang melayani permintaan saat ini.

Coba lagi (dengan logika backoff yang sesuai) adalah respons yang disarankan untuk pengecualian ini.

message

Memperbarui atau menghapus sumber daya dapat menyebabkan keadaan tidak konsisten.

resourceId

Pengidentifikasi sumber daya yang terpengaruh.

resourceType

Jenis sumber daya yang terpengaruh.

Kode Status HTTP: 409

InternalServerException

Terjadi kesalahan server internal. Coba lagi permintaan Anda.

message

Kesalahan tak terduga selama pemrosesan permintaan.

retryAfterSeconds

Coba lagi panggilan setelah beberapa detik.

Kode Status HTTP: 500

ResourceNotFoundException

Sumber daya tidak ditemukan untuk permintaan ini.

Konfirmasikan informasi sumber daya, seperti ARN atau tipe sudah benar dan ada, lalu coba lagi permintaan tersebut.

message

Minta referensi sumber daya yang tidak ada.

resourceId

Pengidentifikasi hipotetis dari sumber daya yang terpengaruh.

resourceType

Jenis hipotetis dari sumber daya yang terpengaruh.

Kode Status HTTP: 404

ServiceQuotaExceededException

Permintaan ditolak karena melebihi batas kuota yang diizinkan.

message

Permintaan ini tidak berhasil karena kuota layanan melebihi batas.

quotaCode

Ini adalah kode khusus untuk jenis kuota.

resourceId

Pengidentifikasi sumber daya.

resourceType

Jenis sumber daya.

serviceCode

Ini adalah kode unik untuk layanan asal dengan kuota.

Kode Status HTTP: 402

ThrottlingException

Permintaan ditolak karena throttling permintaan.

message

Permintaan tidak berhasil karena pembatasan permintaan.

quotaCode

Ini adalah kode unik untuk layanan asal dengan kuota.

retryAfterSeconds

Coba lagi panggilan setelah beberapa detik.

serviceCode

Ini adalah kode unik untuk layanan asal.

Kode Status HTTP: 429

ValidationException

Input gagal memenuhi kendala yang ditentukan oleh layanan.

message

Input gagal memenuhi batasan yang ditentukan oleh layanan Amazon.

Kode Status HTTP: 400

Lihat Juga

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