Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Paso 4: Creación de un índice de Amazon Kendra e ingesta de los metadatos
Para implementar su solución de búsqueda inteligente, debe crear un índice de Amazon Kendra e incorporar en él los datos y metadatos de S3.
Antes de añadir metadatos a su índice de Amazon Kendra, debe crear campos de índice personalizados correspondientes a los atributos de los documentos personalizados, que a su vez corresponden a los tipos de entidad de Amazon Comprehend. Amazon Kendra utiliza los campos de índice y los atributos de documentos personalizados que cree para buscar y filtrar sus documentos.
Para obtener más información, consulte [Indexación](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index.html) y [Creación de atributos de documentos personalizados](https://docs.aws.amazon.com/kendra/latest/dg/custom-attributes.html).
**Topics**
+ [Creación de un índice de Amazon Kendra](#tutorial-search-metadata-create-index)
+ [Actualización del rol de IAM para el acceso a Amazon S3](#tutorial-search-metadata-create-index-update-IAM)
+ [Creación de campos de índice de búsqueda personalizados de Amazon Kendra](#tutorial-search-metadata-create-index-custom-fields)
+ [Agregar el bucket de Amazon S3 como origen de datos para el índice](#tutorial-search-metadata-create-index-connect-data)
+ [Sincronización del índice de Amazon Kendra](#tutorial-search-metadata-create-index-sync)
## Creación de un índice de Amazon Kendra
Para consultar los documentos fuente, debe crear un índice de Amazon Kendra.
Si utiliza este paso, debe crear y adjuntar un rol y una política de AWS IAM que permitan a Amazon Kendra acceder a CloudWatch sus registros antes de crear un índice. AWS CLI Para más información, consulte [Requisitos previos](https://docs.aws.amazon.com/kendra/latest/dg/gs-prerequisites.html).
### Creación de un índice de Amazon Kendra (consola)
1. Abra la consola Amazon Kendra en. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)
**importante**
Asegúrese de que se encuentra en la misma región en la que creó su trabajo de análisis de entidades de Amazon Comprehend y su bucket de Amazon S3. Si se encuentra en otra región, elija la AWS región en la que creó su bucket de Amazon S3 en el **selector de regiones** de la barra de navegación superior.
1. Elija **Crear índice**.
1. Para los **Detalles del índice** en la página **Especificar detalles del índice**, haga lo siguiente:
1. En **Nombre de índice**, ingrese el **kendra-index**.
1. Mantenga el campo **Descripción** en blanco.
1. En **Rol de IAM**, elija **Crear un nuevo rol**. Este rol proporciona acceso a su bucket de Amazon S3.
1. En **Nombre del rol**, ingrese **kendra-role**. El rol de IAM tendrá el prefijo `AmazonKendra-`.
1. Mantenga la configuración predeterminada para el **Cifrado** y las **etiquetas** y seleccione **Siguiente**.
1. En **Configuración del control de acceso** en la página **Configurar el control de acceso de los usuarios**, elija **No** y, a continuación, **Siguiente**.
1. Para las **Ediciones de aprovisionamiento** en la página de **Detalles de aprovisionamiento**, elija **Edición de desarrollador** y seleccione **Crear**.
### Crea un índice de Amazon Kendra (AWS CLI)
1. Para crear y adjuntar un rol de IAM para Amazon Kendra que lo reconozca como una entidad de confianza, haga lo siguiente:
1. Guarde la siguiente política de confianza como un archivo JSON llamado `kendra-trust-policy.json` en un editor de texto de su dispositivo local.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": {
"Effect": "Allow",
"Principal": {
"Service": "kendra.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
}
```
------
1. Para crear un rol de IAM llamado `kendra-role` y adjuntarle el archivo `kendra-trust-policy.json` guardado, use el 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
```
Donde:
+ *path/*es la ruta de acceso al archivo `kendra-trust-policy.json` en su dispositivo local.
------
#### [ macOS ]
```
aws iam create-role \
--role-name kendra-role \
--assume-role-policy-document file://path/kendra-trust-policy.json
```
Donde:
+ *path/*es la ruta de acceso al archivo `kendra-trust-policy.json` en su dispositivo local.
------
#### [ Windows ]
```
aws iam create-role ^
--role-name kendra-role ^
--assume-role-policy-document file://path/kendra-trust-policy.json
```
Donde:
+ *path/*es la ruta de acceso al archivo `kendra-trust-policy.json` en su dispositivo local.
------
1. Copie el nombre de recurso de Amazon (ARN) en el editor de texto y guárdelo de forma local como `kendra-role-arn`.
**nota**
El ARN tiene un formato similar a *arn:aws:iam::123456789012:role/kendra-role*. Necesita el ARN que guardó como `kendra-role-arn` para ejecutar los trabajos de Amazon Kendra.
1. Antes de crear un índice, debe proporcionar su `kendra-role` permiso para escribir en Logs. CloudWatch Para ello, siga los pasos que se describen a continuación:
1. Guarde la siguiente política de confianza como un archivo JSON llamado `kendra-cloudwatch-policy.json` en un editor de texto de su dispositivo local.
*aws-region*Sustitúyalo por tu AWS región y *aws-account-id* por tu ID de AWS cuenta de 12 dígitos.
1. Para crear una política de IAM para acceder a los CloudWatch registros, usa el 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
```
Donde:
+ *path/*es la ruta de acceso al archivo en su dispositivo local. `kendra-cloudwatch-policy.json`
------
#### [ macOS ]
```
aws iam create-policy \
--policy-name kendra-cloudwatch-policy \
--policy-document file://path/kendra-cloudwatch-policy.json
```
Donde:
+ *path/*es la ruta de acceso al archivo `kendra-cloudwatch-policy.json` en su dispositivo local.
------
#### [ Windows ]
```
aws iam create-policy ^
--policy-name kendra-cloudwatch-policy ^
--policy-document file://path/kendra-cloudwatch-policy.json
```
Donde:
+ *path/*es la ruta de acceso al archivo `kendra-cloudwatch-policy.json` en su dispositivo local.
------
1. Copie el nombre de recurso de Amazon (ARN) en el editor de texto y guárdelo de forma local como `kendra-cloudwatch-arn`.
**nota**
El ARN tiene un formato similar a *arn:aws:iam::123456789012:role/kendra-cloudwatch-policy*. Necesita el ARN que guardó como `kendra-cloudwatch-arn` para asociar el `kendra-cloudwatch-policy` a su rol de IAM.
1. Para asociarlo `kendra-cloudwatch-policy` a su función de IAM, utilice el 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
```
Donde:
+ *policy-arn*es tu guardado`kendra-cloudwatch-arn`.
------
#### [ macOS ]
```
aws iam attach-role-policy \
--policy-arn policy-arn \
--role-name kendra-role
```
Donde:
+ *policy-arn*es tu salvado`kendra-cloudwatch-arn`.
------
#### [ Windows ]
```
aws iam attach-role-policy ^
--policy-arn policy-arn ^
--role-name kendra-role
```
Donde:
+ *policy-arn*es tu salvado`kendra-cloudwatch-arn`.
------
1. Para crear un índice, utilice el 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
```
Donde:
+ *role-arn*es tu salvado`kendra-role-arn`,
+ *aws-region*es tu AWS región.
------
#### [ macOS ]
```
aws kendra create-index \
--name kendra-index \
--edition DEVELOPER_EDITION \
--role-arn role-arn \
--region aws-region
```
Donde:
+ *role-arn*es tu salvado`kendra-role-arn`,
+ *aws-region*es tu AWS región.
------
#### [ Windows ]
```
aws kendra create-index ^
--name kendra-index ^
--edition DEVELOPER_EDITION ^
--role-arn role-arn ^
--region aws-region
```
Donde:
+ *role-arn*es tu salvado`kendra-role-arn`,
+ *aws-region*es tu AWS región.
------
1. Copie el índice `Id` y guárdelo en un editor de texto como `kendra-index-id`. El `Id` ayuda a realizar el seguimiento del estado de creación del índice.
1. Para realizar un seguimiento del progreso de su trabajo de creación de índices, utilice el 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
```
Donde:
+ *kendra-index-id*es tu salvado`kendra-index-id`,
+ *aws-region*es tu AWS región.
------
#### [ macOS ]
```
aws kendra describe-index \
--id kendra-index-id \
--region aws-region
```
Donde:
+ *kendra-index-id*es tu salvado`kendra-index-id`,
+ *aws-region*es tu AWS región.
------
#### [ Windows ]
```
aws kendra describe-index ^
--id kendra-index-id ^
--region aws-region
```
Donde:
+ *kendra-index-id*es tu salvado`kendra-index-id`,
+ *aws-region*es tu AWS región.
------
El proceso de creación del índice tarda una media de 15 minutos, pero puede tardar más. Cuando el estado del índice es activo, su índice está listo para ser utilizado. Mientras se crea el índice, puede iniciar el siguiente paso.
Si lo utiliza AWS CLI en este paso, debe crear y adjuntar una política de IAM a su rol de IAM de Amazon Kendra que otorgue a su índice permisos para acceder a su bucket de S3.
## Actualización del rol de IAM para el acceso a Amazon S3
Mientras se crea el índice, usted actualiza su rol de IAM en Amazon Kendra para permitir que el índice que creó lea los datos de su bucket de Amazon S3. Para obtener más información, consulte [Roles de IAM para Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html).
### Para actualizar su rol de IAM (Consola)
1. Abra la consola de IAM en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. En el panel de navegación izquierdo, elija **Roles** e introduzca **kendra-role** en el cuadro de **búsqueda** situado encima del **nombre del rol**.
1. En las opciones sugeridas, haga clic en `kendra-role`.
1. En **Resumen**, seleccione **Asociar políticas**.
1. En **Adjuntar permisos**, en el cuadro de **búsqueda**, introduce **S3** y selecciona la casilla situada junto a la ReadOnlyAccess política de **Amazon S3 entre las opciones sugeridas**.
1. Elija **Asociar política**. En la página de **resumen**, ahora verá dos políticas asociadas al rol de IAM.
1. Regrese a la consola de Amazon Kendra en [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)y espere a que el estado del índice cambie de **Creating** a **Active** antes de continuar con el siguiente paso.
### Para actualizar su rol de IAM (AWS CLI)
1. Guarde el siguiente texto en un archivo JSON llamado `kendra-S3-access-policy.json` en un editor de texto en su dispositivo local.
Sustituya amzn-s3-demo-bucket por el nombre de su bucket de S3, por su AWS región, *aws-account-id* por su *aws-region* ID de cuenta de 12 AWS dígitos y por el guardado. *kendra-index-id* `kendra-index-id`
1. Para crear una política de IAM para acceder a su bucket de S3, utilice el 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
```
Donde:
+ *path/*es la ruta de acceso al archivo en su dispositivo local. `kendra-S3-access-policy.json`
------
#### [ macOS ]
```
aws iam create-policy \
--policy-name kendra-S3-access-policy \
--policy-document file://path/kendra-S3-access-policy.json
```
Donde:
+ *path/*es la ruta de acceso al archivo `kendra-S3-access-policy.json` en su dispositivo local.
------
#### [ Windows ]
```
aws iam create-policy ^
--policy-name kendra-S3-access-policy ^
--policy-document file://path/kendra-S3-access-policy.json
```
Donde:
+ *path/*es la ruta de acceso al archivo `kendra-S3-access-policy.json` en su dispositivo local.
------
1. Copie el nombre de recurso de Amazon (ARN) en el editor de texto y guárdelo de forma local como `kendra-S3-access-arn`.
**nota**
El ARN tiene un formato similar a *arn:aws:iam::123456789012:role/kendra-S3-access-policy*. Necesita el ARN que guardó como `kendra-S3-access-arn` para asociar el `kendra-S3-access-policy` a su rol de IAM.
1. Para asociarlo `kendra-S3-access-policy` a su rol de IAM de Amazon Kendra, utilice el 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
```
Donde:
+ *policy-arn*es su guardado. `kendra-S3-access-arn`
------
#### [ macOS ]
```
aws iam attach-role-policy \
--policy-arn policy-arn \
--role-name kendra-role
```
Donde:
+ *policy-arn*es tu salvado`kendra-S3-access-arn`.
------
#### [ Windows ]
```
aws iam attach-role-policy ^
--policy-arn policy-arn ^
--role-name kendra-role
```
Donde:
+ *policy-arn*es tu salvado`kendra-S3-access-arn`.
------
## Creación de campos de índice de búsqueda personalizados de Amazon Kendra
Para preparar a Amazon Kendra para que reconozca sus metadatos como atributos de documentos personalizados, debe crear campos personalizados correspondientes a los tipos de entidad de Amazon Comprehend. Puede introducir los siguientes nueve tipos de entidades de Amazon Comprehend como campos personalizados:
+ COMMERCIAL\$1ITEM
+ DATE
+ EVENT
+ UBICACIÓN
+ ORGANIZATION
+ OTHER
+ PERSON
+ QUANTITY
+ TITLE
**importante**
El índice no reconocerá los tipos de entidades mal escritos.
### Para crear campos personalizados para su índice de Amazon Kendra (Consola)
1. Abra la consola Amazon Kendra en. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)
1. En la lista de **índices**, haga clic en `kendra-index`.
1. En el panel de navegación izquierdo, en **Administración de datos**, elija **Definición de faceta**.
1. En el menú **Campos de índice**, seleccione **Agregar campo**.
1. En el cuadro de diálogo **Agregar campo de índice**, haga lo siguiente:
1. En el campo **Nombre**, escriba **COMMERCIAL\$1ITEM**.
1. En **Tipo de datos**, elija **Lista de cadenas**.
1. En **Tipos de uso**, seleccione **Facetable**, **Aparece en búsquedas** y **Visualizable** y, a continuación, seleccione **Agregar**.
1. Repita los pasos a a c para cada tipo de entidad de Amazon Comprehend: COMMERCIAL\$1ITEM, DATE, EVENT, LOCATION, ORGANIZATION, OTHER, PERSON, QUANTITY, TITLE.
La consola muestra los mensajes de adición de campos realizados correctamente. Puede optar por cerrarlos antes de continuar con el siguiente paso.
### Para crear campos personalizados para su índice de Amazon Kendra (AWS CLI)
1. Guarde el siguiente texto en un archivo JSON llamado `custom-attributes.json` en un editor de texto en su dispositivo local.
```
[
{
"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 crear campos personalizados en el índice, use el 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
```
Donde:
+ *kendra-index-id*es tu salvado`kendra-index-id`,
+ *path/*es la ruta de acceso al archivo `custom-attributes.json` en su dispositivo local,
+ *aws-region*es tu región. AWS
------
#### [ macOS ]
```
aws kendra update-index \
--id kendra-index-id \
--document-metadata-configuration-updates file://path/custom-attributes.json \
--region aws-region
```
Donde:
+ *kendra-index-id*es tu salvado`kendra-index-id`,
+ *path/*es la ruta de acceso al archivo `custom-attributes.json` en su dispositivo local,
+ *aws-region*es tu región. AWS
------
#### [ Windows ]
```
aws kendra update-index ^
--id kendra-index-id ^
--document-metadata-configuration-updates file://path/custom-attributes.json ^
--region aws-region
```
Donde:
+ *kendra-index-id*es tu salvado`kendra-index-id`,
+ *path/*es la ruta de acceso al archivo `custom-attributes.json` en su dispositivo local,
+ *aws-region*es tu región. AWS
------
1. Para comprobar que los atributos personalizados se han añadido a su índice, utilice el 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
```
Donde:
+ *kendra-index-id*es tu salvado`kendra-index-id`,
+ *aws-region*es tu AWS región.
------
#### [ macOS ]
```
aws kendra describe-index \
--id kendra-index-id \
--region aws-region
```
Donde:
+ *kendra-index-id*es tu salvado`kendra-index-id`,
+ *aws-region*es tu AWS región.
------
#### [ Windows ]
```
aws kendra describe-index ^
--id kendra-index-id ^
--region aws-region
```
Donde:
+ *kendra-index-id*es tu salvado`kendra-index-id`,
+ *aws-region*es tu AWS región.
------
## Agregar el bucket de Amazon S3 como origen de datos para el índice
Antes de poder sincronizar el índice, debe conectar el origen de datos de S3 a él.
### Para conectar un bucket de S3 a su índice de Amazon Kendra (Consola)
1. Abra la consola Amazon Kendra en. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)
1. En la lista de **índices**, haga clic en `kendra-index`.
1. En el menú de navegación de la izquierda, en **Administración de datos**, seleccione **Origen de datos**.
1. En la sección **Seleccione el tipo de conector de origen de datos**, vaya a **Amazon S3** y elija **Agregar conector**.
1. En la página **Especificar detalles**, haga lo siguiente:
1. En **Nombre y descripción**, para **Nombre del origen de datos**, introduzca **S3-data-source**.
1. Mantenga la sección **Descripción** en blanco.
1. Mantenga la configuración predeterminada para **Etiquetas**.
1. Elija **Siguiente**.
1. En la página **Configurar los ajustes de sincronización**, en la sección **Ámbito de sincronización**, haga lo siguiente:
1. En **Introducir la ubicación del origen de datos**, elija **Examinar S3**.
1. En **Elegir recursos**, seleccione su bucket de S3 y, a continuación, seleccione **Elegir**.
1. En la **Ubicación de la carpeta de prefijos de los archivos de metadatos**, elija **Examinar S3**.
1. En **Elegir recursos**, haga clic en el nombre de su bucket en la lista de buckets.
1. Para **Objetos**, seleccione la caja de opción para `metadata` y seleccione **Elegir**. El campo de ubicación ahora debería decir `metadata/`.
1. Mantenga los ajustes predeterminados para la **ubicación del archivo de configuración de la lista de control de acceso**, **la clave de descifrado seleccionada** y la **configuración adicional**.
1. Para el **rol de IAM**, en la página **Configurar los ajustes de sincronización**, elija `kendra-role`.
1. En la página **Configurar los ajustes de sincronización**, en **Sincronizar programación de ejecución**, para **Frecuencia**, selecciona **Ejecutar bajo demanda** y, a continuación, selecciona **Siguiente**.
1. En la página **Revisar y crear**, revise sus opciones para los detalles del origen de datos y seleccione **Añadir origen de datos**.
### Para conectar un bucket de S3 a su índice de Amazon Kendra (AWS CLI)
1. Guarde el siguiente texto en un archivo JSON llamado `S3-data-connector.json` en un editor de texto en su dispositivo local.
```
{
"S3Configuration":{
"BucketName":"amzn-s3-demo-bucket",
"DocumentsMetadataConfiguration":{
"S3Prefix":"metadata"
}
}
}
```
Sustituya amzn-s3-demo-bucket por el nombre del bucket de S3.
1. Para conectar su bucket de S3 a su índice, utilice el [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
```
Donde:
+ *kendra-index-id*es tu guardado`kendra-index-id`,
+ *path/*es la ruta de acceso al archivo `S3-data-connector.json` en su dispositivo local,
+ *role-arn*es tu guardado, `kendra-role-arn`
+ *aws-region*es tu AWS región.
------
#### [ 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
```
Donde:
+ *kendra-index-id*es tu salvado`kendra-index-id`,
+ *path/*es la ruta de acceso al archivo `S3-data-connector.json` en su dispositivo local,
+ *role-arn*es tu guardado, `kendra-role-arn`
+ *aws-region*es tu AWS región.
------
#### [ 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
```
Donde:
+ *kendra-index-id*es tu salvado`kendra-index-id`,
+ *path/*es la ruta de acceso al archivo `S3-data-connector.json` en su dispositivo local,
+ *role-arn*es tu guardado, `kendra-role-arn`
+ *aws-region*es tu AWS región.
------
1. Copie el conector `Id` y guárdelo en un editor de texto como `S3-connector-id`. El `Id` le ayuda a rastrear el estado del proceso de conexión de datos.
1. Para asegurarse de que la fuente de datos de S3 se conectó correctamente, utilice el [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
```
Donde:
+ *S3-connector-id*está guardado`S3-connector-id`,
+ *kendra-index-id*es tu salvado`kendra-index-id`,
+ *aws-region*es tu AWS región.
------
#### [ macOS ]
```
aws kendra describe-data-source \
--id S3-connector-id \
--index-id kendra-index-id \
--region aws-region
```
Donde:
+ *S3-connector-id*es tu salvado`S3-connector-id`,
+ *kendra-index-id*es tu salvado`kendra-index-id`,
+ *aws-region*es tu AWS región.
------
#### [ Windows ]
```
aws kendra describe-data-source ^
--id S3-connector-id ^
--index-id kendra-index-id ^
--region aws-region
```
Donde:
+ *S3-connector-id*es tu salvado`S3-connector-id`,
+ *kendra-index-id*es tu salvado`kendra-index-id`,
+ *aws-region*es tu AWS región.
------
Al final de este paso, el origen de datos de Amazon S3 se conecta al índice.
## Sincronización del índice de Amazon Kendra
Con el origen de datos de Amazon S3 añadido, ahora puede sincronizar su índice de Amazon Kendra con él.
### Para sincronizar su índice de Amazon Kendra (Consola)
1. Abra la consola Amazon Kendra en. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)
1. En la lista de **índices**, haga clic en `kendra-index`.
1. En el menú de navegación izquierdo, elija **Origen de datos**.
1. En **Origen de datos**, seleccione `S3-data-source`.
1. En la barra de navegación superior, elija **Sincronizar ahora**.
### Para sincronizar su índice de Amazon Kendra (AWS CLI)
1. Para sincronizar el índice, utilice el 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
```
Donde:
+ *S3-connector-id*es tu guardado`S3-connector-id`,
+ *kendra-index-id*es tu salvado`kendra-index-id`,
+ *aws-region*es tu AWS región.
------
#### [ macOS ]
```
aws kendra start-data-source-sync-job \
--id S3-connector-id \
--index-id kendra-index-id \
--region aws-region
```
Donde:
+ *S3-connector-id*es tu salvado`S3-connector-id`,
+ *kendra-index-id*es tu salvado`kendra-index-id`,
+ *aws-region*es tu AWS región.
------
#### [ Windows ]
```
aws kendra start-data-source-sync-job ^
--id S3-connector-id ^
--index-id kendra-index-id ^
--region aws-region
```
Donde:
+ *S3-connector-id*es tu salvado`S3-connector-id`,
+ *kendra-index-id*es tu salvado`kendra-index-id`,
+ *aws-region*es tu AWS región.
------
1. Para comprobar el estado de la sincronización del índice, utilice el 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
```
Donde:
+ *S3-connector-id*está guardado`S3-connector-id`,
+ *kendra-index-id*es tu salvado`kendra-index-id`,
+ *aws-region*es tu AWS región.
------
#### [ macOS ]
```
aws kendra list-data-source-sync-jobs \
--id S3-connector-id \
--index-id kendra-index-id \
--region aws-region
```
Donde:
+ *S3-connector-id*es tu salvado`S3-connector-id`,
+ *kendra-index-id*es tu salvado`kendra-index-id`,
+ *aws-region*es tu AWS región.
------
#### [ Windows ]
```
aws kendra list-data-source-sync-jobs ^
--id S3-connector-id ^
--index-id kendra-index-id ^
--region aws-region
```
Donde:
+ *S3-connector-id*es tu salvado`S3-connector-id`,
+ *kendra-index-id*es tu salvado`kendra-index-id`,
+ *aws-region*es tu AWS región.
------
Al final de este paso, ha creado un índice de Amazon Kendra que permite realizar búsquedas y filtrar para su conjunto de datos.