翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

## XML documents/batch リクエスト
<a name="documents-batch-xml-request"></a>

`documents/batch` リクエストの本文では、XML で、実行するドキュメントのオペレーションを指定します。例:

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

### documents/batch リクエストの要素 (XML)
<a name="documents-batch-xml-request-elements"></a>


****  

| Element | 説明 | 必須 | 
| --- | --- | --- | 
| バッチ | 検索ドメインに送信する追加または削除オペレーションのコレクション。バッチには、少なくとも 1 つの add または delete 要素を含める必要があります。 | はい | 
| 追加 | 検索ドメインに追加するドキュメントを指定します。id 属性は必須であり、add 要素には少なくとも 1 つのフィールドが含まれている必要があります。属性: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/cloudsearch/latest/developerguide/documents-batch-xml.html)  | いいえ | 
| field | 追加されるドキュメント内のフィールドを指定します。名前属性およびフィールド値は必須です。フィールド名は英数字で始まっている必要があり、次の文字を含めることができます。a​～​z (小文字)、0​～​9、\$1 (下線)。score という名前は予約済みのため、フィールド名として使用できません。フィールド値にはテキストや CDATA を指定できます。 フィールドに複数の値を指定するには、同じ名前の複数のフィールド要素を含めます。例: <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> 制約: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/cloudsearch/latest/developerguide/documents-batch-xml.html)  条件: add 要素で少なくとも 1 個のフィールドを指定する必要があります。  | 条件付き | 
| 削除 | 検索ドメインから削除するドキュメントを指定します。id 属性は必須です。delete 要素は空にする必要があります。ドキュメントの完全な削除の詳細については、「[Amazon CloudSearch でのドキュメントの削除](preparing-data.md#deleting-documents)」を参照してください。制約: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/cloudsearch/latest/developerguide/documents-batch-xml.html)  | いいえ | 

## documents/batch レスポンス (XML)
<a name="documents-batch-xml-response"></a>

レスポンスの本文には、実行された追加や削除の数、および生成されたすべてのエラーや警告がリストされます。

ドキュメントサービス API レスポンスの RelaxNG スキーマは次のとおりです。

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

### documents/batch レスポンスの要素 (XML)
<a name="documents-batch-xml-response-elements"></a>


****  

| Element | 説明 | 
| --- | --- | 
| 結果 | リクエストを解析および検証するときに生成されたエラーおよび警告をリストする要素が含まれます。 属性: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/cloudsearch/latest/developerguide/documents-batch-xml.html) 制約: ステータスが `error` の場合、results 要素にはエラーのリストが含まれます。ステータスが `success` の場合、results 要素に警告のリストを含めることができますが、エラーは含まれません。  | 
| エラー | リクエストの解析時および検証時に発生したエラーを示す error 要素のコレクションが含まれます。 | 
| エラー | 解析エラーまたは検証エラーに関する情報を提供します。値はエラーの説明を提供します。 | 
| warnings | リクエストの解析時および検証時に生成された警告を示す warning 要素のコレクションが含まれます。 | 
| 警告 | 解析または検証の警告に関する情報を提供します。値はエラーの説明を提供します。 |