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. Demikian pula, untuk menghapus dokumen, Anda mengirimkan permintaan hapus dengan ID dokumen dari dokumen yang ingin Anda hapus. Untuk informasi tentang menghapus dokumen, lihatMenghapus Dokumen di Amazon CloudSearch.

Untuk informasi selengkapnya tentang mengirimkan data untuk pengindeksan, lihat. upload documents

dokumen/batch JSON API

Dokumen JSON/Permintaan 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. typeProperti mengidentifikasi apakah suatu 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"
}]

Representasi skema JSON 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)

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)

dokumen/kode status batch

Permintaan layanan dokumen dapat mengembalikan tiga jenis kode status:

Header Permintaan Umum

Header Respons Umum