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.

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.

Kode Status HTTP: 409

InternalServerException

Terjadi kesalahan server internal. Coba lagi permintaan Anda.

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.

Kode Status HTTP: 404

ServiceQuotaExceededException

Permintaan ditolak karena melebihi batas kuota yang diizinkan.

Kode Status HTTP: 402

ThrottlingException

Permintaan ditolak karena throttling permintaan.

Kode Status HTTP: 429

ValidationException

Input gagal memenuhi kendala yang ditentukan oleh layanan.

Kode Status HTTP: 400

Lihat Juga

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