Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

documents/batch

Questa sezione descrive i messaggi di richiesta e risposta HTTP per la risorsa documents/batch.

Crei batch di documenti per descrivere i dati che desideri caricare su un CloudSearch dominio Amazon. Un batch di documenti è una raccolta di operazioni di aggiunta ed eliminazione che rappresentano i documenti che desideri aggiungere, aggiornare o eliminare da un tuo dominio. I batch possono essere descritti in formato JSON o XML. Un batch fornisce tutte le informazioni di cui Amazon CloudSearch ha bisogno per l'indicizzazione. Ogni articolo che desideri poter restituire come risultato di ricerca (ad esempio un prodotto) è rappresentato come un documento: un batch è semplicemente una raccolta di richieste di aggiunta ed eliminazione per singoli documenti. Ogni documento ha un ID univoco e uno o più campi che contengono i dati che si desidera ricercare e restituire all'interno dei risultati.

Per aggiornare un documento, devi specificare una richiesta di aggiunta con l'ID del documento che vuoi aggiornare. Per ulteriori informazioni, consulta Aggiunta e aggiornamento di documenti in Amazon CloudSearch. Analogamente, per eliminare un documento devi inviare una richiesta di eliminazione con l'ID del documento che vuoi eliminare. Per informazioni sull'eliminazione dei documenti, consultare Eliminazione di documenti in Amazon CloudSearch.

Per ulteriori informazioni sull'invio di dati per l'indicizzazione, consultare upload documents.

documents/batch JSON API

Richieste documents/batch JSON

Il corpo di una richiesta documents/batch utilizza i formati JSON o XML per specificare le operazioni che vuoi eseguire per i documenti. La rappresentazione JSON di un batch è una raccolta di oggetti che definiscono le singole operazioni di aggiunta ed eliminazione. La proprietà type indica se un oggetto rappresenta un'operazione di aggiunta o di eliminazione. Ad esempio, il seguente batch JSON aggiunge un documento ed elimina un documento:

[
{ "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"
}]

Di seguito è riportato lo schema JSON di un batch:

{
    "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",
                    }
                }
            }
        }
    }
}

Proprietà della richiesta documents/batch (JSON)

Risposta documents/batch (JSON)

Il corpo della risposta elenca il numero di operazioni di aggiunta ed eliminazione eseguite e gli eventuali errori o avvisi generati.

Di seguito è riportata la rappresentazione dello schema JSON di una risposta dell'API del servizio documenti:

{
    "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
                    }
                }
            }
        }
    }
}

Proprietà della risposta documents/batch (JSON)

Codici di stato documents/batch

Una richiesta del servizio documenti può restituire tre tipi di codici di stato:

Intestazioni di richiesta comuni

Intestazioni di risposta comuni