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
<a name="documents-batch-xml"></a>

## Richieste XML documents/batch
<a name="documents-batch-xml-request"></a>

Il corpo di una richiesta `documents/batch` specifica le operazioni dei documenti che vuoi eseguire in XML. 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)
<a name="documents-batch-xml-request-elements"></a>


****  

| Elemento | Description | 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: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/cloudsearch/latest/developerguide/documents-batch-xml.html)  | 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 \$1 (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. Esempio: <pre><field name="genre">Adventure</field><br /><field name="genre">Drama</field><br /><field name="genre">Fantasy</field><br /><field name="genre">Thriller</field></pre> Vincoli: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/cloudsearch/latest/developerguide/documents-batch-xml.html)  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](preparing-data.md#deleting-documents).Vincoli: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/cloudsearch/latest/developerguide/documents-batch-xml.html)  | No | 

## Risposta documents/batch (XML)
<a name="documents-batch-xml-response"></a>

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)
<a name="documents-batch-xml-response-elements"></a>


****  

| Elemento | Description | 
| --- | --- | 
| result | Contiene elementi che elencano gli errori e gli avvisi generati durante l'analisi e la convalida della richiesta.  Attributi: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/cloudsearch/latest/developerguide/documents-batch-xml.html) 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.  | 
| avvisi | 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.  |