Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
StartSearchJob
Operasi ini menciptakan pekerjaan pencarian yang mengembalikan titik pemulihan yang disaring oleh SearchScope dan item yang difilter oleh ItemFilters.
Anda dapat secara opsional menyertakan ClientToken, EncryptionKeyArn, Nama, and/or Tag.
Minta Sintaks
PUT /search-jobs HTTP/1.1
Content-type: application/json
{
"ClientToken": "string",
"EncryptionKeyArn": "string",
"ItemFilters": {
"EBSItemFilters": [
{
"CreationTimes": [
{
"Operator": "string",
"Value": number
}
],
"FilePaths": [
{
"Operator": "string",
"Value": "string"
}
],
"LastModificationTimes": [
{
"Operator": "string",
"Value": number
}
],
"Sizes": [
{
"Operator": "string",
"Value": number
}
]
}
],
"S3ItemFilters": [
{
"CreationTimes": [
{
"Operator": "string",
"Value": number
}
],
"ETags": [
{
"Operator": "string",
"Value": "string"
}
],
"ObjectKeys": [
{
"Operator": "string",
"Value": "string"
}
],
"Sizes": [
{
"Operator": "string",
"Value": number
}
],
"VersionIds": [
{
"Operator": "string",
"Value": "string"
}
]
}
]
},
"Name": "string",
"SearchScope": {
"BackupResourceArns": [ "string" ],
"BackupResourceCreationTime": {
"CreatedAfter": number,
"CreatedBefore": number
},
"BackupResourceTags": {
"string" : "string"
},
"BackupResourceTypes": [ "string" ],
"SourceResourceArns": [ "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
- EncryptionKeyArn
-
Kunci enkripsi untuk pekerjaan pencarian yang ditentukan.
Tipe: String
Wajib: Tidak
- ItemFilters
-
Filter Item mewakili semua properti item masukan yang ditentukan saat pencarian dibuat.
Berisi EBSItem Filter atau S3 ItemFilters
Tipe: Objek ItemFilters
Wajib: Tidak
- Name
-
Sertakan karakter alfanumerik untuk membuat nama untuk pekerjaan pencarian ini.
Tipe: String
Batasan Panjang: Panjang minimum 0. Panjang maksimum 500.
Wajib: Tidak
- SearchScope
-
Objek ini dapat berisi BackupResourceTypes BackupResourceArns, BackupResourceCreationTime, BackupResourceTags,, dan SourceResourceArns untuk menyaring titik pemulihan yang dikembalikan oleh pekerjaan pencarian.
Tipe: Objek SearchScope
Wajib: Ya
- Tags
-
Daftar tag yang dikembalikan oleh operasi.
Tipe: Peta antar string
Wajib: Tidak
Sintaksis Respons
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"SearchJobArn": "string",
"SearchJobIdentifier": "string"
}Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- CreationTime
-
Tanggal dan waktu pekerjaan dibuat, dalam format Unix dan Coordinated Universal Time (UTC). Nilai akurat
CompletionTimeuntuk milidetik. Misalnya, nilai 1516925490.087 mewakili Jumat, 26 Januari 2018 12:11:30.087.Tipe: Timestamp
- SearchJobArn
-
String unik yang mengidentifikasi Nama Sumber Daya Amazon (ARN) dari pekerjaan pencarian yang ditentukan.
Tipe: String
- SearchJobIdentifier
-
String unik yang menentukan pekerjaan pencarian.
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:
