documents/batch XML API

Richieste documents/batch XML

Il corpo di una richiesta documents/batch specifica le operazioni dei documenti che vuoi eseguire in XML. Per esempio:

<batch>
	<add  id="tt0484562">
		<field name="title">The Seeker: The Dark Is Rising</field>
		<field name="director">Cunningham, David L.</field>
		<field name="genre">Adventure</field>
		<field name="genre">Drama</field>
		<field name="genre">Fantasy</field>
		<field name="genre">Thriller</field>
		<field name="actor">McShane, Ian</field>
		<field name="actor">Eccleston, Christopher</field>
		<field name="actor">Conroy, Frances</field>
		<field name="actor">Ludwig, Alexander</field>
		<field name="actor">Crewson, Wendy</field>
		<field name="actor">Warner, Amelia</field>
		<field name="actor">Cosmo, James</field>
		<field name="actor">Hickey, John Benjamin</field>
		<field name="actor">Piddock, Jim</field>
		<field name="actor">Lockhart, Emma</field>
	</add>
	<delete id="tt0301199" />
</batch>

Elementi della richiesta documents/batch (XML)

Elemento	Descrizione	Richiesto
batch	Raccolta di operazioni di aggiunta o eliminazione che vuoi inviare al tuo dominio di ricerca. Un batch deve contenere almeno un elemento di aggiunta o eliminazione.	Sì
aggiungi	Specifica un documento che vuoi aggiungere al tuo dominio di ricerca. Gli attributi id sono obbligatori e un elemento add deve contenere almeno un campo. Attributi: id—Una stringa alfanumerica. Tutti i caratteri diversi da A-Z (maiuscole o minuscole) e 0- non sono consentiti. La lunghezza massima è 128 caratteri.	No
field	Specifica un campo nel documento in fase di aggiunta. Sono obbligatori l'attributo name e un valore del campo. I nomi di campo devono iniziare con una lettera e possono includere i seguenti caratteri: a-z (minuscole), 0-9 e _ (carattere di sottolineatura). Il nome score è riservato e non può essere utilizzato come nome di campo. Il valore del campo può essere testo o CDATA. Per specificare più valori per un campo, includi più elementi field con lo stesso nome. Per esempio: <field name="genre">Adventure</field> <field name="genre">Drama</field> <field name="genre">Fantasy</field> <field name="genre">Thriller</field> Vincoli: name—Una stringa alfanumerica che inizia con una lettera. Può contenere a-z (minuscole), 0-9, _ (carattere di sottolineatura), - (trattino) e . (punto). Condizione: deve essere specificato almeno un campo in un elemento add.	Condizionale
Elimina	Specifica un documento che vuoi rimuovere dal tuo dominio di ricerca. L'attributo id è obbligatorio. Un elemento delete deve essere vuoto. Per informazioni sull'eliminazione permanente dei documenti, consultare Eliminazione di documenti in Amazon CloudSearch. Vincoli: id—Una stringa alfanumerica. Tutti i caratteri diversi da A-Z (maiuscole o minuscole) e 0- non sono consentiti.	No

Risposta documents/batch (XML)

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

Lo schema RelaxNG di una risposta dell'API del servizio documenti è:

 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
        }+
    }?
}

Elementi della risposta documents/batch (XML)

Elemento	Descrizione
result	Contiene elementi che elencano gli errori e gli avvisi generati durante l'analisi e la convalida della richiesta. Attributi: status: stato del risultato (success o error). adds—Il numero di documenti aggiunti. Se lo stato è error, il numero è sempre zero. deletes—Il numero di documenti eliminati. Se lo stato è error, il numero è sempre zero. Vincoli: se lo stato è error, l'elemento results contiene un elenco di errori. Se lo stato è success, l'elemento results può contenere un elenco di avvisi, ma nessun errore.
errori	Contiene un insieme di elementi error che individuano gli errori verificatisi durante l'analisi e la convalida della richiesta.
error	Fornisce informazioni su un errore di analisi o convalida. Il valore fornisce una descrizione dell'errore.
warnings	Contiene un insieme di elementi warning che individuano gli avvisi generati durante l'analisi e la convalida della richiesta.
attenzione	Fornisce informazioni su un avviso relativo all'analisi o alla convalida. Il valore fornisce una descrizione dell'errore.