本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 入门 (AWS CLI)
<a name="gs-cli"></a>

以下过程说明如何使用创建 Amazon Kendra 索引 AWS CLI。该过程会创建数据来源、索引，并对索引运行查询。

**创建 Amazon Kendra 索引 (CLI)**

1. 完成[先决条件](gs-prerequisites.md)。

1. 输入以下命令来创建索引。

   ```
   aws kendra create-index \
    --name cli-getting-started-index \
    --description "Index for CLI getting started guide." \
    --role-arn arn:aws:iam::{{account id}}:role/KendraRoleForGettingStartedIndex
   ```

1. 等待 Amazon Kendra 创建索引。使用以下命令检查进度。当状态字段为 `ACTIVE` 时，继续执行下一步。

   ```
   aws kendra describe-index \
    --id {{index id}}
   ```

1. 在命令提示符下，输入以下命令以创建数据来源。

   ```
   aws kendra create-data-source \
    --index-id {{index id}} \
    --name {{data source name}} \
    --role-arn arn:aws:iam::{{account id}}:role/KendraRoleForGettingStartedDataSource \
    --type S3 \
    --configuration '{"S3Configuration":{"BucketName":"{{S3 bucket name}}"}}'
   ```

   如果您使用模板架构连接到数据来源，请配置模板架构。

   ```
   aws kendra create-data-source \
    --index-id {{index id}} \
    --name {{data source name}} \
    --role-arn arn:aws:iam::{{account id}}:role/KendraRoleForGettingStartedDataSource \
    --type TEMPLATE \
    --configuration '{"TemplateConfiguration":{"Template":{{{JSON schema}}}}}'
   ```

1. 创建数据源需要 Amazon Kendra 一段时间。输入以下命令以检查进度。当状态为 `ACTIVE` 时，继续执行下一步。

   ```
   aws kendra describe-data-source \
    --id {{data source ID}} \
    --index-id {{index ID}}
   ```

1. 输入以下命令以同步数据来源。

   ```
   aws kendra start-data-source-sync-job \
    --id {{data source ID}} \
    --index-id {{index ID}}
   ```

1. Amazon Kendra 将为您的数据源编制索引。所需时间取决于文档的数量。您可以使用以下命令检查同步作业的状态。当状态为 `ACTIVE` 时，继续执行下一步。

   ```
   aws kendra describe-data-source \
    --id {{data source ID}} \
    --index-id {{index ID}}
   ```

1. 输入以下命令以执行查询。

   ```
   aws kendra query \
    --index-id {{index ID}} \
    --query-text "{{search term}}"
   ```

   搜索的结果将以 JSON 格式显示。