**本文档仅适用于 AWS CLI 版本 1。**

我们已宣布即将终止对 AWS CLI 版本 1 的支持。AWS CLI 版本 1 现在处于维护模式。建议您迁移到 AWS CLI 版本 2。有关日期、其它详细信息以及如何迁移的信息，请参阅[公告](https://aws.amazon.com/blogs/developer/cli-v1-maintenance-mode-announcement/)。有关 AWS CLI 版本 2 的相关文档，请参阅[版本 2 用户指南](https://docs.aws.amazon.com/cli/latest/userguide/)。

# 使用 AWS CLI 的 Amazon CloudSearch 示例
<a name="cli_cloudsearch-domain_code_examples"></a>

以下代码示例演示如何通过将 AWS Command Line Interface与 Amazon CloudSearch 结合使用，来执行操作和实现常见场景。

*操作*是大型程序的代码摘录，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景的上下文查看操作。

每个示例都包含一个指向完整源代码的链接，您可以从中找到有关如何在上下文中设置和运行代码的说明。

**Topics**
+ [操作](#actions)

## 操作
<a name="actions"></a>

### `upload-documents`
<a name="cloudsearch-domain_UploadDocuments_cli_topic"></a>

以下代码示例演示了如何使用 `upload-documents`。

**AWS CLI**  
以下 `upload-documents` 命令会将一批 JSON 文档上传到 Amazon CloudSearch 域：  

```
aws cloudsearchdomain upload-documents --endpoint-url {{https://doc-my-domain.us-west-1.cloudsearch.amazonaws.com}} --content-type {{application/json}} --documents {{document-batch.json}}
```
输出：  

```
{
  "status": "success",
  "adds": 5000,
  "deletes": 0
}
```
+  有关 API 详细信息，请参阅《AWS CLI 命令参考》**中的 [UploadDocuments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudsearchdomain/upload-documents.html)。