Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# dokumen/batch
Bagian ini menjelaskan permintaan HTTP dan pesan respons untuk `documents/batch` sumber daya.
Anda membuat kumpulan dokumen untuk mendeskripsikan data yang ingin Anda unggah ke CloudSearch domain Amazon. Kumpulan dokumen adalah kumpulan operasi tambah dan hapus yang mewakili dokumen yang ingin Anda tambahkan, perbarui, atau hapus dari domain Anda. Batch dapat dijelaskan dalam JSON atau XHTML. Batch menyediakan semua informasi yang CloudSearch dibutuhkan Amazon untuk pengindeksan. Setiap item yang ingin Anda kembalikan sebagai hasil penelusuran (seperti produk) direpresentasikan sebagai dokumen—kumpulan hanyalah kumpulan permintaan tambah dan hapus untuk dokumen individual. Setiap dokumen memiliki ID unik dan satu atau beberapa bidang yang berisi data yang ingin Anda cari dan kembalikan hasilnya.
Untuk memperbarui dokumen, Anda menentukan permintaan tambah dengan ID dokumen dokumen yang ingin Anda perbarui. Untuk informasi selengkapnya, lihat [Menambahkan dan Memperbarui Dokumen di Amazon CloudSearch](preparing-data.md#adding-documents). Demikian pula, untuk menghapus dokumen, Anda mengirimkan permintaan hapus dengan ID dokumen dari dokumen yang ingin Anda hapus. Untuk informasi tentang menghapus dokumen, lihat[Menghapus Dokumen di Amazon CloudSearch](preparing-data.md#deleting-documents).
Untuk informasi selengkapnya tentang mengirimkan data untuk pengindeksan, lihat. [Mengunggah Data ke Domain Amazon CloudSearch](uploading-data.md)
## dokumen/batch JSON API
### Permintaan JSON documents/batch
Badan `documents/batch` permintaan menggunakan JSON atau XMLuntuk menentukan operasi dokumen yang ingin Anda lakukan. Representasi JSON dari batch adalah kumpulan objek yang mendefinisikan operasi tambah dan hapus individu. `type`Properti mengidentifikasi apakah objek mewakili operasi tambah atau hapus. Misalnya, batch JSON berikut menambahkan satu dokumen dan menghapus satu dokumen:
```
[
{ "type": "add",
"id": "tt0484562",
"fields": {
"title": "The Seeker: The Dark Is Rising",
"directors": ["Cunningham, David L."],
"genres": ["Adventure","Drama","Fantasy","Thriller"],
"actors": ["McShane, Ian","Eccleston, Christopher","Conroy, Frances",
"Crewson, Wendy","Ludwig, Alexander","Cosmo, James",
"Warner, Amelia","Hickey, John Benjamin","Piddock, Jim",
"Lockhart, Emma"]
}
},
{ "type": "delete",
"id": "tt0484575"
}]
```
**catatan**
Saat menentukan kumpulan dokumen di JSON, nilai untuk bidang tidak bisa. `null`
Representasi [skema JSON](http://json-schema.org/) dari batch ditunjukkan di bawah ini:
```
{
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": ["add", "delete"],
"required": true
},
"id": {
"type": "string",
"pattern": "[a-z0-9][a-z0-9_]{0,127}",
"minLength": 1,
"maxLength": 128,
"required": true
},
"fields": {
"type": "object",
"patternProperties": {
"[a-zA-Z0-9][a-zA-Z0-9_]{0,63}": {
"type": "string",
}
}
}
}
}
}
```
#### dokumen/Properti Permintaan batch (JSON)
****
| Properti | Deskripsi | Diperlukan |
| --- | --- | --- |
| jenis | Jenis operasi, add ataudelete. | Ya |
| id | String alfanumerik. Karakter yang diizinkan adalah: A-Z (huruf besar), -a-z (huruf kecil), 0-9, \$1 (garis bawah), - (tanda hubung),/(garis miring), \$1 (tanda hash),: (titik dua). Panjang maksimal adalah 128 karakter. | Ya |
| ladang | Kumpulan satu atau lebih properti field\$1name yang menentukan bidang yang berisi dokumen. Kondisi: Diperlukan untuk menambah operasi. Harus berisi setidaknya satu properti *field\$1name*. | Bersyarat |
| field\$1name | Menentukan bidang dalam dokumen yang ditambahkan. Nama bidang harus dimulai dengan huruf dan dapat berisi karakter berikut: a-z (huruf kecil), 0-9, dan \$1 (garis bawah). Nama bidang harus minimal 3 dan tidak lebih dari 64 karakter. Skor nama dicadangkan dan tidak dapat digunakan sebagai nama bidang. Untuk menentukan beberapa nilai untuk bidang, Anda menentukan larik nilai, bukan nilai tunggal. Contoh: `"genre": ["Adventure","Drama","Fantasy","Thriller"]` Kondisi: Setidaknya satu bidang harus ditentukan dalam objek bidang. | Bersyarat |
### dokumen/Batch Response (JSON)
Badan respons mencantumkan jumlah penambahan dan penghapusan yang dilakukan dan kesalahan atau peringatan apa pun yang dihasilkan.
Representasi skema JSON dari respons API layanan dokumen ditunjukkan di bawah ini:
```
{
"type": "object",
"properties": {
"status": {
"type": "text",
"enum": ["success", "error"],
"required": true
},
"adds": {
"type": "integer",
"minimum": 0,
"required": true
},
"deletes": {
"type": "integer",
"minimum": 0,
"required": true
},
"errors": {
"type": "array",
"required": false,
"items": {
"type": "object",
"properties": {
"message": {
"type": "string",
"required": true
}
}
}
},
"warnings": {
"type": "array",
"required": false,
"items": {
"type": "object",
"properties": {
"message": {
"type": "string",
"required": true
}
}
}
}
}
}
```
#### dokumen/properti respons batch (JSON)
****
| Properti | Deskripsi |
| --- | --- |
| status | Status hasil, yaitu salah satu success atauerror. |
| menambahkan | Jumlah operasi tambah dokumen yang dilakukan. Selalu nol saat statusnyaerror. |
| menghapus | Jumlah operasi hapus dokumen yang dilakukan. Selalu nol saat statusnyaerror. Untuk informasi tentang menghapus dokumen secara permanen, lihat[Menghapus Dokumen di Amazon CloudSearch](preparing-data.md#deleting-documents). |
| kesalahan | Memberikan informasi tentang kesalahan parsing atau validasi. Ditentukan hanya jika statusnyaerror. |
| memperingati | Memberikan informasi tentang peringatan yang dihasilkan selama penguraian atau validasi. |
# dokumen/batch XMLAPI
## Permintaan XHTML documents/batch
Badan `documents/batch` permintaan menentukan operasi dokumen yang ingin Anda lakukan dalam XHTML. Contoh:
```
The Seeker: The Dark Is Rising
Cunningham, David L.
Adventure
Drama
Fantasy
Thriller
McShane, Ian
Eccleston, Christopher
Conroy, Frances
Ludwig, Alexander
Crewson, Wendy
Warner, Amelia
Cosmo, James
Hickey, John Benjamin
Piddock, Jim
Lockhart, Emma
```
### dokumen/batch Permintaan Elemen (XHTML)
****
| Elemen | Deskripsi | Diperlukan |
| --- | --- | --- |
| batch | Kumpulan operasi tambah atau hapus yang ingin Anda kirimkan ke domain pencarian Anda. Batch harus berisi setidaknya satu elemen tambah atau hapus. | Ya |
| tambahkan | Menentukan dokumen yang ingin Anda tambahkan ke domain pencarian Anda. Atribut id diperlukan dan elemen add harus berisi setidaknya satu bidang. Atribut: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloudsearch/latest/developerguide/documents-batch-xml.html) | Tidak |
| bidang | Menentukan bidang dalam dokumen yang ditambahkan. Atribut nama dan nilai bidang diperlukan. Nama bidang harus dimulai dengan huruf dan dapat berisi karakter berikut: a-z (huruf kecil), 0-9, dan \$1 (garis bawah). Skor nama dicadangkan dan tidak dapat digunakan sebagai nama bidang. Nilai bidang dapat berupa teks atau CDATA. Untuk menentukan beberapa nilai untuk bidang, Anda menyertakan beberapa elemen bidang dengan nama yang sama. Contoh: Adventure
Drama
Fantasy
Thriller
Batas: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloudsearch/latest/developerguide/documents-batch-xml.html) Kondisi: Setidaknya satu bidang harus ditentukan dalam elemen add. | Bersyarat |
| hapus | Menentukan dokumen yang ingin Anda hapus dari domain pencarian Anda. Atribut id diperlukan. Elemen hapus harus kosong. Untuk informasi tentang menghapus dokumen secara permanen, lihat[Menghapus Dokumen di Amazon CloudSearch](preparing-data.md#deleting-documents).Batas: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloudsearch/latest/developerguide/documents-batch-xml.html) | Tidak |
## dokumen/Batch Response (XHTML)
Badan respons mencantumkan jumlah penambahan dan penghapusan yang dilakukan dan kesalahan atau peringatan apa pun yang dihasilkan.
Skema RelaxNG dari respons API layanan dokumen adalah:
```
start = response
response = element response {
attribute status { "success" | "error" },
attribute adds { xsd:integer },
attribute deletes { xsd:integer },
element errors {
element error {
text
}+
}? &
element warnings {
element warning {
text
}+
}?
}
```
### dokumen/batch Response Elements (XHTML)
****
| Elemen | Deskripsi |
| --- | --- |
| result | Berisi elemen yang mencantumkan kesalahan dan peringatan yang dihasilkan saat mengurai dan memvalidasi permintaan. Atribut: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/cloudsearch/latest/developerguide/documents-batch-xml.html) Kendala: Jika statusnya`error`, elemen hasil berisi daftar kesalahan. Jika statusnya`success`, elemen hasil dapat berisi daftar peringatan, tetapi tidak ada kesalahan. |
| kesalahan | Berisi kumpulan elemen kesalahan yang mengidentifikasi kesalahan yang terjadi saat mengurai dan memvalidasi permintaan. |
| kesalahan | Memberikan informasi tentang kesalahan parsing atau validasi. Nilai memberikan deskripsi kesalahan. |
| peringatan | Berisi kumpulan elemen peringatan yang mengidentifikasi peringatan yang dihasilkan saat mengurai dan memvalidasi permintaan. |
| memperingati | Memberikan informasi tentang peringatan parsing atau validasi. Nilai memberikan deskripsi kesalahan. |
## dokumen/kode status batch
Permintaan layanan dokumen dapat mengembalikan tiga jenis kode status:
+ Kode status 5xx menunjukkan bahwa ada kesalahan server internal. Kami merekomendasikan untuk menangkap dan mencoba kembali semua kode kesalahan 5xx karena biasanya mewakili kondisi kesalahan sementara.
+ Kode status 4xx menunjukkan bahwa permintaan itu salah bentuk.
+ Kode status 2xx menunjukkan bahwa permintaan berhasil diproses.
****
| Kesalahan | Deskripsi | Kode Status HTTP |
| --- | --- | --- |
| Tidak Ada Tipe Konten | Header Content-Type tidak ada. | 400 |
| Tidak Ada Konten-Panjang | Header Content-Length tidak ada. | 411 |
| Jalan yang salah | Jalur URL tidak cocok dengan “/YYYY-MM-”. DD/documents/batch | 404 |
| Metode HTTP Tidak Valid | Metode HTTP bukan POST. Permintaan harus diposting ke dokumen/batch. | 405 |
| Jenis Terima Tidak Valid | Terima header menentukan jenis konten selain "application/xml'' or ''application/json”. Tanggapan dapat dikirim hanya sebagai XML/JSON. | 406 |
| Permintaan Terlalu Besar | Panjang badan permintaan lebih besar dari nilai maksimum yang diizinkan. | 413 |
| Jenis Konten Tidak Valid | Jenis konten adalah sesuatu selain "application/json" or "application/xml”. | 415 |
| Set Karakter Tidak Valid | Set karakter adalah sesuatu selain “ASCII”, “ISO-8859-1", atau “UTF-8". | 415 |
## Header Permintaan Umum
****
| Nama | Deskripsi | Diperlukan |
| --- | --- | --- |
| Content-Type | Tipe MIME standar yang menjelaskan format data objek. Untuk informasi lebih lanjut, lihat [W3C RFC 2616](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17) Bagian 14. Default: application/json Kendala: atau hanya application/json application/xml | Diperlukan |
| Content-Length | Panjang dalam byte dari badan permintaan. | Ya |
| Menerima | Tipe MIME standar yang menjelaskan format data respons. Untuk informasi lebih lanjut, lihat [W3C RFC 2616](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17) Bagian 14. Default: tipe konten permintaan Kendala: atau hanya application/json application/xml | Tidak |
## Header Respons Umum
****
| Nama | Deskripsi |
| --- | --- |
| Content-Type | Tipe MIME standar yang menjelaskan format data objek. Untuk informasi lebih lanjut, lihat [W3C RFC 2616](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17) Bagian 14. Default: nilai header Terima dalam permintaan, atau Content-Type permintaan jika header Terima hilang atau tidak menentukan salah satu application/xml atau application/json. Kendala: atau hanya application/xml application/json |
| Content-Length | Panjang byte tubuh dalam respons. |