

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Conceitos básicos (AWS CLI)
<a name="gs-cli"></a>

O procedimento a seguir mostra como criar um Amazon Kendra índice usando AWS CLI o. O procedimento cria uma fonte de dados, um índice e executa uma consulta no índice.

**Para criar um Amazon Kendra índice (CLI)**

1. Faça [Pré-requisitos](gs-prerequisites.md).

1. Insira o seguinte comando para criar um índice:

   ```
   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 Aguarde a criação do índice. Verifique o andamento usando o seguinte comando: Quando o status como `ACTIVE`, siga para a próxima etapa.

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

1. No prompt de comando, insira o comando a seguir para criar uma fonte de dados. 

   ```
   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"}}'
   ```

   Se você se conectar à fonte de dados usando um esquema de modelo, configure o esquema de modelo.

   ```
   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. A criação da fonte de dados demorará Amazon Kendra um pouco. Insira o comando a seguir para acompanhar o progresso. Quando o status for `ACTIVE`, siga para a próxima etapa.

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

1. Insira o comando a seguir para sincronizar a fonte de dados.

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

1. Amazon Kendra indexará sua fonte de dados. O tempo necessário depende do número de documentos. Você pode verificar o status da tarefa usando o seguinte: Quando o status for `ACTIVE`, siga para a próxima etapa.

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

1. Digite o comando a seguir para fazer uma consulta.

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

   Os resultados da pesquisa são exibidos no formato JSON.