documents/batch XML API - Amazon CloudSearch
RichiesteRisposta documents/batch (XML)

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 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.