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á.
# Etapa 4: criar um índice de pesquisa do Amazon Kendra e ingerir os metadados.
Para implementar a solução de pesquisa inteligente, você cria um índice do Amazon Kendra e ingere seus dados e metadados do S3 nele.
Antes de adicionar metadados ao índice do Amazon Kendra, você cria campos de índice personalizados correspondentes aos atributos personalizados do documento, que, por sua vez, correspondem aos tipos de entidade do Amazon Comprehend. O Amazon Kendra usa os campos de índice e os atributos personalizados do documento que você cria para pesquisar e filtrar os documentos.
Para obter mais informações, consulte [Índice](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index.html) e [criação de atributos de documentos personalizados](https://docs.aws.amazon.com/kendra/latest/dg/custom-attributes.html).
**Topics**
+ [Criar um índice do Amazon Kendra](#tutorial-search-metadata-create-index)
+ [Atualizar o perfil do IAM para acessar o Amazon S3](#tutorial-search-metadata-create-index-update-IAM)
+ [Criação de campos de índice de pesquisa personalizados do Amazon Kendra](#tutorial-search-metadata-create-index-custom-fields)
+ [Adicionar um bucket do Amazon S3 como fonte de dados para o índice](#tutorial-search-metadata-create-index-connect-data)
+ [Sincronizar o índice do Amazon Kendra](#tutorial-search-metadata-create-index-sync)
## Criar um índice do Amazon Kendra
Para consultar os documentos de origem, crie um índice do Amazon Kendra.
Se você estiver usando o AWS CLI nesta etapa, você cria e anexa uma função e uma política AWS do IAM que permitem que a Amazon Kendra acesse CloudWatch seus registros antes de criar um índice. Para obter mais informações, consulte [Pré-requisitos](https://docs.aws.amazon.com/kendra/latest/dg/gs-prerequisites.html).
### Para criar um índice do Amazon Kendra (console)
1. Abra o console Amazon Kendra em. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)
**Importante**
Certifique-se de estar na mesma região em que você criou o trabalho de análise de entidades do Amazon Comprehend e o bucket do Amazon S3. Se você estiver em outra região, escolha a AWS região em que você criou seu bucket do Amazon S3 no **seletor de regiões na barra** de navegação superior.
1. Escolha **Criar índice**.
1. Para **Detalhes do índice** na página **Especificar detalhes do índice**, faça o seguinte:
1. Em **Nome do índice**, insira **kendra-index**.
1. Mantenha o campo **Descrição** em branco.
1. Em **Perfil do IAM**, selecione **Criar uma função**. Esse perfil fornece acesso ao bucket do Amazon S3.
1. Em **Nome do perfil**, insira **kendra-role**. O perfil do IAM terá o prefixo `AmazonKendra-`.
1. Mantenha as configurações padrão para **Criptografia** e **Tags** e escolha **Avançar**.
1. Para **Configurações de controle de acesso** na página **Configurar controle de acesso do usuário**, escolha **Não** e, em seguida, escolha **Avançar**.
1. **Para **Edições de aprovisionamento** na página de **Detalhes de aprovisionamento**, escolha **Developer Edition** e escolha Criar**.
### Para criar um índice do Amazon Kendra (AWS CLI)
1. Para criar e anexar um perfil do IAM para a Amazon Kendra que a reconheça como uma entidade confiável, faça o seguinte:
1. Salve a política de confiança a seguir como um arquivo JSON chamado `kendra-trust-policy.json` em um editor ou texto em seu computador.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": {
"Effect": "Allow",
"Principal": {
"Service": "kendra.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
}
```
------
1. Para criar um perfil do IAM chamado `kendra-role` e anexar o arquivo `kendra-trust-policy.json` salvo para ele, use o comando [create-role](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-role.html):
------
#### [ Linux ]
```
aws iam create-role \
--role-name kendra-role \
--assume-role-policy-document file://path/kendra-trust-policy.json
```
Em que:
+ *path/*é o caminho do arquivo para o `kendra-trust-policy.json` seu dispositivo local.
------
#### [ macOS ]
```
aws iam create-role \
--role-name kendra-role \
--assume-role-policy-document file://path/kendra-trust-policy.json
```
Em que:
+ *path/*é o caminho do arquivo para o `kendra-trust-policy.json` seu dispositivo local.
------
#### [ Windows ]
```
aws iam create-role ^
--role-name kendra-role ^
--assume-role-policy-document file://path/kendra-trust-policy.json
```
Em que:
+ *path/*é o caminho do arquivo para o `kendra-trust-policy.json` seu dispositivo local.
------
1. Copie o nome do recurso da Amazon (ARN) no editor de texto e salve-o localmente como `kendra-role-arn`.
**nota**
O ARN tem um formato semelhante a *arn:aws:iam::123456789012:role/kendra-role*. Você precisa do ARN no qual você salvou `kendra-role-arn` para executar os trabalhos do Amazon Kendra.
1. Antes de criar um índice, você deve fornecer permissão para gravar `kendra-role` no CloudWatch Logs. Para fazer isso, conclua as seguintes etapas:
1. Salve a política de confiança a seguir como um arquivo JSON chamado `kendra-cloudwatch-policy.json` em um editor ou texto em seu computador.
*aws-region*Substitua pela sua AWS região e *aws-account-id* pelo ID da sua AWS conta de 12 dígitos.
1. Para criar uma política do IAM para acessar CloudWatch os registros, use o comando [create-policy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-policy.html):
------
#### [ Linux ]
```
aws iam create-policy \
--policy-name kendra-cloudwatch-policy \
--policy-document file://path/kendra-cloudwatch-policy.json
```
Em que:
+ *path/*é o caminho do arquivo para o `kendra-cloudwatch-policy.json` seu dispositivo local.
------
#### [ macOS ]
```
aws iam create-policy \
--policy-name kendra-cloudwatch-policy \
--policy-document file://path/kendra-cloudwatch-policy.json
```
Em que:
+ *path/*é o caminho do arquivo para o `kendra-cloudwatch-policy.json` seu dispositivo local.
------
#### [ Windows ]
```
aws iam create-policy ^
--policy-name kendra-cloudwatch-policy ^
--policy-document file://path/kendra-cloudwatch-policy.json
```
Em que:
+ *path/*é o caminho do arquivo para o `kendra-cloudwatch-policy.json` seu dispositivo local.
------
1. Copie o nome do recurso da Amazon (ARN) no editor de texto e salve-o localmente como `kendra-cloudwatch-arn`.
**nota**
O ARN tem um formato semelhante a *arn:aws:iam::123456789012:role/kendra-cloudwatch-policy*. Você precisa do ARN em que salvou `kendra-cloudwatch-arn` para anexar `kendra-cloudwatch-policy` ao perfil do IAM.
1. Para anexar o `kendra-cloudwatch-policy` à sua função do IAM, use o [attach-role-policy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/attach-role-policy.html)comando:
------
#### [ Linux ]
```
aws iam attach-role-policy \
--policy-arn policy-arn \
--role-name kendra-role
```
Em que:
+ *policy-arn*é seu salvo`kendra-cloudwatch-arn`.
------
#### [ macOS ]
```
aws iam attach-role-policy \
--policy-arn policy-arn \
--role-name kendra-role
```
Em que:
+ *policy-arn*é seu salvo`kendra-cloudwatch-arn`.
------
#### [ Windows ]
```
aws iam attach-role-policy ^
--policy-arn policy-arn ^
--role-name kendra-role
```
Em que:
+ *policy-arn*é seu salvo`kendra-cloudwatch-arn`.
------
1. Para criar um índice, use o comando [create-index](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/create-index.html):
------
#### [ Linux ]
```
aws kendra create-index \
--name kendra-index \
--edition DEVELOPER_EDITION \
--role-arn role-arn \
--region aws-region
```
Em que:
+ *role-arn*é seu salvo`kendra-role-arn`,
+ *aws-region*é a sua AWS região.
------
#### [ macOS ]
```
aws kendra create-index \
--name kendra-index \
--edition DEVELOPER_EDITION \
--role-arn role-arn \
--region aws-region
```
Em que:
+ *role-arn*é seu salvo`kendra-role-arn`,
+ *aws-region*é a sua AWS região.
------
#### [ Windows ]
```
aws kendra create-index ^
--name kendra-index ^
--edition DEVELOPER_EDITION ^
--role-arn role-arn ^
--region aws-region
```
Em que:
+ *role-arn*é seu salvo`kendra-role-arn`,
+ *aws-region*é a sua AWS região.
------
1. Copie o índice `Id` e salve-o em um editor de texto como `kendra-index-id`. `Id` ajuda a rastrear o status da criação do índice.
1. Para acompanhar o progresso do trabalho de criação de índice, use o comando [describe-index](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/describe-index.html):
------
#### [ Linux ]
```
aws kendra describe-index \
--id kendra-index-id \
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
#### [ macOS ]
```
aws kendra describe-index \
--id kendra-index-id \
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
#### [ Windows ]
```
aws kendra describe-index ^
--id kendra-index-id ^
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
O processo de criação do índice leva, em média, 15 minutos, mas pode levar mais tempo. Quando o status do índice é ativo, o índice está pronto para uso. Enquanto o índice está sendo criado, você pode começar a próxima etapa.
Se você estiver usando o AWS CLI nesta etapa, você cria e anexa uma política do IAM à sua função do Amazon Kendra IAM que concede ao seu índice permissões para acessar seu bucket do S3.
## Atualizar o perfil do IAM para acessar o Amazon S3
Enquanto o índice está sendo criado, você atualiza o perfil do Amazon Kendra IAM para permitir que o índice que você criou leia dados do bucket do Amazon S3. Para obter mais informações, consulte [Perfis do IAM para o Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html).
### Para atualizar seu perfil do IAM (console)
1. Abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. No painel de navegação esquerdo, escolha **Funções** e insira **kendra-role** na caixa **Pesquisar** acima do **Nome da função**.
1. Nas opções sugeridas, clique em `kendra-role`.
1. Em **Resumo**, escolha **Anexar políticas**.
1. Em **Anexar permissões**, na caixa **Pesquisar**, insira **S3** e selecione a caixa de seleção ao lado da ReadOnlyAccess política do **AmazonS3** nas opções sugeridas.
1. Escolha **Anexar política**. Na página de **Resumo**, agora você verá duas políticas anexadas ao perfil do IAM.
1. Retorne ao console do Amazon Kendra [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)em e aguarde até que o status do seu índice mude de Criando para Ativo antes **de** continuar **com** a próxima etapa.
### Para atualizar o perfil do IAM (console)
1. Salve a política de confiança a seguir como um arquivo JSON chamado `kendra-S3-access-policy.json` em um editor ou texto em seu computador.
Substitua amzn-s3-demo-bucket pelo nome do bucket do S3, pela sua AWS região, *aws-region* pelo ID da conta de 12 AWS dígitos e pelo que você salvou. *aws-account-id* *kendra-index-id* `kendra-index-id`
1. Para criar uma política do IAM chamada para acessar o bucket do S3, use o comando [create-policy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-policy.html):
------
#### [ Linux ]
```
aws iam create-policy \
--policy-name kendra-S3-access-policy \
--policy-document file://path/kendra-S3-access-policy.json
```
Em que:
+ *path/*é o caminho do arquivo para o `kendra-S3-access-policy.json` seu dispositivo local.
------
#### [ macOS ]
```
aws iam create-policy \
--policy-name kendra-S3-access-policy \
--policy-document file://path/kendra-S3-access-policy.json
```
Em que:
+ *path/*é o caminho do arquivo para o `kendra-S3-access-policy.json` seu dispositivo local.
------
#### [ Windows ]
```
aws iam create-policy ^
--policy-name kendra-S3-access-policy ^
--policy-document file://path/kendra-S3-access-policy.json
```
Em que:
+ *path/*é o caminho do arquivo para o `kendra-S3-access-policy.json` seu dispositivo local.
------
1. Copie o nome do recurso da Amazon (ARN) no editor de texto e salve-o localmente como `kendra-S3-access-arn`.
**nota**
O ARN tem um formato semelhante a *arn:aws:iam::123456789012:role/kendra-S3-access-policy*. Você precisa do ARN em que salvou `kendra-S3-access-arn` para anexar `kendra-S3-access-policy` ao perfil do IAM.
1. Para anexar o `kendra-S3-access-policy` à sua função do Amazon Kendra IAM, use o comando: [attach-role-policy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/attach-role-policy.html)
------
#### [ Linux ]
```
aws iam attach-role-policy \
--policy-arn policy-arn \
--role-name kendra-role
```
Em que:
+ *policy-arn*é seu salvo`kendra-S3-access-arn`.
------
#### [ macOS ]
```
aws iam attach-role-policy \
--policy-arn policy-arn \
--role-name kendra-role
```
Em que:
+ *policy-arn*é seu salvo`kendra-S3-access-arn`.
------
#### [ Windows ]
```
aws iam attach-role-policy ^
--policy-arn policy-arn ^
--role-name kendra-role
```
Em que:
+ *policy-arn*é seu salvo`kendra-S3-access-arn`.
------
## Criação de campos de índice de pesquisa personalizados do Amazon Kendra
Para preparar o Amazon Kendra para reconhecer os metadados como atributos personalizados do documento, crie campos personalizados correspondentes aos tipos de entidade do Amazon Comprehend. Insira os nove tipos de entidade do Amazon Comprehend a seguir como campos personalizados:
+ COMMERCIAL\$1ITEM
+ DATE
+ EVENTO
+ LOCALIZAÇÃO
+ ORGANIZATION
+ OUTRO
+ PERSON
+ QUANTITY
+ TITLE
**Importante**
Tipos de entidade com erros ortográficos não serão reconhecidos pelo índice.
### Para criar campos personalizados para seu índice do Amazon Kendra (console)
1. Abra o console Amazon Kendra em. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)
1. Na lista de **Índices**, clique em `kendra-index`.
1. No painel de navegação esquerdo, em **Gerenciamento de dados**, escolha **Definição de faceta**.
1. No menu **Campos do índice**, escolha **Adicionar campo**.
1. Na caixa de diálogo **Adicionar campo de índice**, faça o seguinte:
1. No campo **Nome**, insira **COMMERCIAL\$1ITEM**.
1. Em **Tipo de dados**, escolha **Lista de cadeias de caracteres**.
1. Em **Tipos de uso**, selecione **Facetável**, **Pesquisável** e **Exibível** e, em seguida, escolha **Adicionar**.
1. Repita as etapas de a a c para cada tipo de entidade do Amazon Comprehend: COMMERCIAL\$1ITEM, DATE, EVENT, LOCATION, ORGANIZATION, OTHER, PERSON, QUANTITY, TITLE.
O console exibe mensagens de adição de campo bem-sucedida. Você pode optar por fechá-los antes de prosseguir para a próxima etapa.
### Para criar campos personalizados para o índice do Amazon Kendra (AWS CLI)
1. Salve a política de confiança a seguir como um arquivo JSON chamado `custom-attributes.json` em um editor ou texto em seu computador.
```
[
{
"Name": "COMMERCIAL_ITEM",
"Type": "STRING_LIST_VALUE",
"Search": {
"Facetable": true,
"Searchable": true,
"Displayable": true
}
},
{
"Name": "DATE",
"Type": "STRING_LIST_VALUE",
"Search": {
"Facetable": true,
"Searchable": true,
"Displayable": true
}
},
{
"Name": "EVENT",
"Type": "STRING_LIST_VALUE",
"Search": {
"Facetable": true,
"Searchable": true,
"Displayable": true
}
},
{
"Name": "LOCATION",
"Type": "STRING_LIST_VALUE",
"Search": {
"Facetable": true,
"Searchable": true,
"Displayable": true
}
},
{
"Name": "ORGANIZATION",
"Type": "STRING_LIST_VALUE",
"Search": {
"Facetable": true,
"Searchable": true,
"Displayable": true
}
},
{
"Name": "OTHER",
"Type": "STRING_LIST_VALUE",
"Search": {
"Facetable": true,
"Searchable": true,
"Displayable": true
}
},
{
"Name": "PERSON",
"Type": "STRING_LIST_VALUE",
"Search": {
"Facetable": true,
"Searchable": true,
"Displayable": true
}
},
{
"Name": "QUANTITY",
"Type": "STRING_LIST_VALUE",
"Search": {
"Facetable": true,
"Searchable": true,
"Displayable": true
}
},
{
"Name": "TITLE",
"Type": "STRING_LIST_VALUE",
"Search": {
"Facetable": true,
"Searchable": true,
"Displayable": true
}
}
]
```
1. Para criar campos personalizados no índice, use o comando [update-index](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/update-index.html):
------
#### [ Linux ]
```
aws kendra update-index \
--id kendra-index-id \
--document-metadata-configuration-updates file://path/custom-attributes.json \
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *path/*é o caminho do arquivo para `custom-attributes.json` o seu dispositivo local
+ *aws-region*é a sua AWS região.
------
#### [ macOS ]
```
aws kendra update-index \
--id kendra-index-id \
--document-metadata-configuration-updates file://path/custom-attributes.json \
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *path/*é o caminho do arquivo para `custom-attributes.json` o seu dispositivo local
+ *aws-region*é a sua AWS região.
------
#### [ Windows ]
```
aws kendra update-index ^
--id kendra-index-id ^
--document-metadata-configuration-updates file://path/custom-attributes.json ^
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *path/*é o caminho do arquivo para `custom-attributes.json` o seu dispositivo local
+ *aws-region*é a sua AWS região.
------
1. Para verificar se os atributos personalizados foram adicionados ao índice, use o comando [describe-index](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/describe-index.html):
------
#### [ Linux ]
```
aws kendra describe-index \
--id kendra-index-id \
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
#### [ macOS ]
```
aws kendra describe-index \
--id kendra-index-id \
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
#### [ Windows ]
```
aws kendra describe-index ^
--id kendra-index-id ^
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
## Adicionar um bucket do Amazon S3 como fonte de dados para o índice
Antes de sincronizar o índice, conecte a fonte de dados do S3 a ele.
### Para conectar um bucket do S3 ao índice do Amazon Kendra (console)
1. Abra o console Amazon Kendra em. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)
1. Na lista de **Índices**, clique em `kendra-index`.
1. No menu de navegação à esquerda, em **Gerenciamento de dados**, escolha **Fontes de dados**.
1. Na seção **Selecionar tipo de conector da fonte de dados**, navegue até **Amazon S3** e escolha **Adicionar** conector.
1. Na página **Especificar detalhes da fonte de dados**, faça o seguinte:
1. Em **Nome e descrição**, para **Nome da fonte de dados**, insira um **S3-data-source**.
1. Mantenha a seção **Descrição** em branco.
1. Mantenha a configuração padrão para **Tags**.
1. Escolha **Próximo**.
1. Na página **Definir configurações**, na seção **Escopo de sincronização**, faça o seguinte:
1. Em **Inserir o local da fonte de dados**, escolha **Procurar no S3**.
1. Em **Escolher recursos**, selecione so bucket do S3 e escolha **Escolher**.
1. Em **Localização da pasta de prefixo de arquivos de metadados**, escolha **Procurar S3**.
1. Em **Escolher recursos**, clique no nome do bucket na lista de buckets.
1. Em **Objetos**, selecione o botão de opção para `metadata` e escolha **Escolher**. O campo de localização agora deve dizer `metadata/`.
1. Mantenha as configurações padrão para a **Localização do arquivo de configuração da lista de controle de acesso**, **Selecionar chave de descriptografia** e **Configuração adicional**.
1. Para o **perfil do IAM**, na página **Definir configurações de sincronização**, escolha `kendra-role`.
1. Na página **Definir configurações de sincronização**, em **Agenda de execução da sincronização**, em **Frequência**, escolha **Executar sob demanda** e, em seguida, escolha **Avançar**.
1. Na página **Revisar e criar**, analise os detalhes da fonte de dados e escolha **Criar fonte de dados**.
### Para conectar um bucket do S3 ao índice do Amazon Kendra (AWS CLI)
1. Salve a política de confiança a seguir como um arquivo JSON chamado `S3-data-connector.json` em um editor ou texto em seu computador.
```
{
"S3Configuration":{
"BucketName":"amzn-s3-demo-bucket",
"DocumentsMetadataConfiguration":{
"S3Prefix":"metadata"
}
}
}
```
Substitua amzn-s3-demo-bucket pelo nome do seu bucket do S3.
1. Para conectar seu bucket do S3 ao seu índice, use o [create-data-source](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/create-data-source.html)comando:
------
#### [ Linux ]
```
aws kendra create-data-source \
--index-id kendra-index-id \
--name S3-data-source \
--type S3 \
--configuration file://path/S3-data-connector.json \
--role-arn role-arn \
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *path/*é o caminho do arquivo para `S3-data-connector.json` o seu dispositivo local
+ *role-arn*é seu salvo`kendra-role-arn`,
+ *aws-region*é a sua AWS região.
------
#### [ macOS ]
```
aws kendra create-data-source \
--index-id kendra-index-id \
--name S3-data-source \
--type S3 \
--configuration file://path/S3-data-connector.json \
--role-arn role-arn \
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *path/*é o caminho do arquivo para `S3-data-connector.json` o seu dispositivo local
+ *role-arn*é seu salvo`kendra-role-arn`,
+ *aws-region*é a sua AWS região.
------
#### [ Windows ]
```
aws kendra create-data-source ^
--index-id kendra-index-id ^
--name S3-data-source ^
--type S3 ^
--configuration file://path/S3-data-connector.json ^
--role-arn role-arn ^
--region aws-region
```
Em que:
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *path/*é o caminho do arquivo para `S3-data-connector.json` o seu dispositivo local
+ *role-arn*é seu salvo`kendra-role-arn`,
+ *aws-region*é a sua AWS região.
------
1. Copie o índice `Id` e salve-o em um editor de texto como `S3-connector-id`. `Id` ajuda você a rastrear o status do processo de conexão de dados.
1. Para garantir que sua fonte de dados do S3 tenha sido conectada com êxito, use o [describe-data-source](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/describe-data-source.html)comando:
------
#### [ Linux ]
```
aws kendra describe-data-source \
--id S3-connector-id \
--index-id kendra-index-id \
--region aws-region
```
Em que:
+ *S3-connector-id*é seu salvo`S3-connector-id`,
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
#### [ macOS ]
```
aws kendra describe-data-source \
--id S3-connector-id \
--index-id kendra-index-id \
--region aws-region
```
Em que:
+ *S3-connector-id*é seu salvo`S3-connector-id`,
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
#### [ Windows ]
```
aws kendra describe-data-source ^
--id S3-connector-id ^
--index-id kendra-index-id ^
--region aws-region
```
Em que:
+ *S3-connector-id*é seu salvo`S3-connector-id`,
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
Ao final dessa etapa, a fonte de dados do Amazon S3 é conectada ao índice.
## Sincronizar o índice do Amazon Kendra
Com a fonte de dados do Amazon S3 adicionada, agora você sincroniza o índice Amazon Kendra com ela.
### Para sincronizar um índice do Amazon Kendra (console)
1. Abra o console Amazon Kendra em. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)
1. Na lista de **Índices**, clique em `kendra-index`.
1. No menu de navegação à esquerda, escolha **Fontes de dados**.
1. Em **Fontes de dados**, selecione `S3-data-source`.
1. Na barra de navegação superior, escolha **Sincronizar agora**.
### Para sincronizar um índice do Amazon Kendra (AWS CLI)
1. Para sincronizar seu índice, use o comando [start-data-source-sync-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/start-data-source-sync-job.html):
------
#### [ Linux ]
```
aws kendra start-data-source-sync-job \
--id S3-connector-id \
--index-id kendra-index-id \
--region aws-region
```
Em que:
+ *S3-connector-id*é seu salvo`S3-connector-id`,
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
#### [ macOS ]
```
aws kendra start-data-source-sync-job \
--id S3-connector-id \
--index-id kendra-index-id \
--region aws-region
```
Em que:
+ *S3-connector-id*é seu salvo`S3-connector-id`,
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
#### [ Windows ]
```
aws kendra start-data-source-sync-job ^
--id S3-connector-id ^
--index-id kendra-index-id ^
--region aws-region
```
Em que:
+ *S3-connector-id*é seu salvo`S3-connector-id`,
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
1. Para verificar o status da sincronização do índice, use o comando [list-data-source-sync-jobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/list-data-source-sync-jobs.html):
------
#### [ Linux ]
```
aws kendra list-data-source-sync-jobs \
--id S3-connector-id \
--index-id kendra-index-id \
--region aws-region
```
Em que:
+ *S3-connector-id*é seu salvo`S3-connector-id`,
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
#### [ macOS ]
```
aws kendra list-data-source-sync-jobs \
--id S3-connector-id \
--index-id kendra-index-id \
--region aws-region
```
Em que:
+ *S3-connector-id*é seu salvo`S3-connector-id`,
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
#### [ Windows ]
```
aws kendra list-data-source-sync-jobs ^
--id S3-connector-id ^
--index-id kendra-index-id ^
--region aws-region
```
Em que:
+ *S3-connector-id*é seu salvo`S3-connector-id`,
+ *kendra-index-id*é seu salvo`kendra-index-id`,
+ *aws-region*é a sua AWS região.
------
Ao final desta etapa, você criou um índice Amazon Kendra pesquisável e filtrável para o conjunto de dados.