Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Fase 4: creazione di un indice Amazon Kendra e acquisizione dei metadati
Per implementare la tua soluzione di ricerca intelligente, crei un indice Amazon Kendra e inserisci i dati e i metadati S3 al suo interno.
Prima di aggiungere metadati all'indice Amazon Kendra, crei campi indice personalizzati corrispondenti agli attributi personalizzati del documento, che a loro volta corrispondono ai tipi di entità Amazon Comprehend. Amazon Kendra utilizza i campi indice e gli attributi di documento personalizzati che crei per cercare e filtrare i documenti.
Per ulteriori informazioni, consulta [Indicizzazione](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index.html) e [creazione di attributi di documento personalizzati](https://docs.aws.amazon.com/kendra/latest/dg/custom-attributes.html).
**Topics**
+ [Creazione di un indice Amazon Kendra](#tutorial-search-metadata-create-index)
+ [Aggiornamento del ruolo IAM per l'accesso ad Amazon S3](#tutorial-search-metadata-create-index-update-IAM)
+ [Creazione di campi dell'indice di ricerca personalizzati di Amazon Kendra](#tutorial-search-metadata-create-index-custom-fields)
+ [Aggiungere il bucket Amazon S3 come origine dati per l'indice](#tutorial-search-metadata-create-index-connect-data)
+ [Sincronizzazione dell'indice Amazon Kendra](#tutorial-search-metadata-create-index-sync)
## Creazione di un indice Amazon Kendra
Per interrogare i tuoi documenti di origine, crei un indice Amazon Kendra.
Se utilizzi AWS CLI in questa fase, crei e alleghi un ruolo e una policy AWS IAM che consentano ad Amazon Kendra di accedere ai CloudWatch tuoi log prima di creare un indice. Per ulteriori informazioni, consulta [Prerequisiti](https://docs.aws.amazon.com/kendra/latest/dg/gs-prerequisites.html).
### Per creare un indice Amazon Kendra (console)
1. Apri la console Amazon Kendra all'indirizzo. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)
**Importante**
Assicurati di trovarti nella stessa regione in cui hai creato il job di analisi delle entità Amazon Comprehend e il bucket Amazon S3. Se ti trovi in un'altra regione, scegli la AWS regione in cui hai creato il tuo bucket Amazon S3 dal **selettore Regione nella barra di navigazione** in alto.
1. Scegli **Crea un indice**.
1. Per **i dettagli dell'indice** nella pagina **Specificare i dettagli dell'indice**, procedi come segue:
1. Per **Index name (Nome indice)**, inserisci **kendra-index**.
1. Mantieni vuoto il campo **Descrizione**.
1. Per **Ruolo IAM**, scegli **Crea un nuovo ruolo**. Questo ruolo fornisce l'accesso al tuo bucket Amazon S3.
1. Per **Nome ruolo**, inserisci **kendra-role**. Il ruolo IAM avrà il prefisso. `AmazonKendra-`
1. Mantieni le impostazioni predefinite per **Encryption** e **Tags** e scegli **Avanti**.
1. Per **le impostazioni di controllo degli accessi** nella pagina **Configura il controllo dell'accesso utente**, scegli **No**, quindi scegli **Avanti**.
1. **Per le **edizioni Provisioning** nella pagina dei **dettagli di Provisioning**, scegli **Developer edition** e scegli Crea.**
### Per creare un indice Amazon Kendra ()AWS CLI
1. Per creare e associare un ruolo IAM per Amazon Kendra che lo riconosca come entità affidabile, procedi come segue:
1. Salva la seguente politica di attendibilità come file JSON richiamato `kendra-trust-policy.json` in un editor di testo sul tuo dispositivo locale.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": {
"Effect": "Allow",
"Principal": {
"Service": "kendra.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
}
```
------
1. Per creare un ruolo IAM chiamato `kendra-role` e allegare ad esso il `kendra-trust-policy.json` file salvato, usa il 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
```
Dove:
+ *path/*è il percorso del file `kendra-trust-policy.json` sul dispositivo locale.
------
#### [ macOS ]
```
aws iam create-role \
--role-name kendra-role \
--assume-role-policy-document file://path/kendra-trust-policy.json
```
Dove:
+ *path/*è il percorso del file `kendra-trust-policy.json` sul dispositivo locale.
------
#### [ Windows ]
```
aws iam create-role ^
--role-name kendra-role ^
--assume-role-policy-document file://path/kendra-trust-policy.json
```
Dove:
+ *path/*è il percorso del file `kendra-trust-policy.json` sul dispositivo locale.
------
1. Copia l'Amazon Resource Name (ARN) nel tuo editor di testo e salvalo localmente come. `kendra-role-arn`
**Nota**
L'ARN ha un formato simile a. *arn:aws:iam::123456789012:role/kendra-role* È necessario l'ARN salvato `kendra-role-arn` per eseguire i job di Amazon Kendra.
1. Prima di creare un indice, devi fornire `kendra-role` l'autorizzazione per scrivere su Logs. CloudWatch Per farlo, completa le seguenti fasi.
1. Salva la seguente politica di attendibilità come file JSON richiamato `kendra-cloudwatch-policy.json` in un editor di testo sul tuo dispositivo locale.
*aws-region*Sostituiscilo con la tua AWS regione e *aws-account-id* con l'ID del tuo account a 12 cifre AWS .
1. [Per creare una policy IAM per accedere ai CloudWatch log, usa il 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
```
Dove:
+ *path/*è il percorso del file `kendra-cloudwatch-policy.json` sul dispositivo locale.
------
#### [ macOS ]
```
aws iam create-policy \
--policy-name kendra-cloudwatch-policy \
--policy-document file://path/kendra-cloudwatch-policy.json
```
Dove:
+ *path/*è il percorso del file `kendra-cloudwatch-policy.json` sul dispositivo locale.
------
#### [ Windows ]
```
aws iam create-policy ^
--policy-name kendra-cloudwatch-policy ^
--policy-document file://path/kendra-cloudwatch-policy.json
```
Dove:
+ *path/*è il percorso del file `kendra-cloudwatch-policy.json` sul dispositivo locale.
------
1. Copia l'Amazon Resource Name (ARN) nel tuo editor di testo e salvalo localmente come. `kendra-cloudwatch-arn`
**Nota**
L'ARN ha un formato simile a. *arn:aws:iam::123456789012:role/kendra-cloudwatch-policy* Hai bisogno dell'ARN che hai salvato `kendra-cloudwatch-arn` per collegarlo `kendra-cloudwatch-policy` al tuo ruolo IAM.
1. Per collegarlo `kendra-cloudwatch-policy` al tuo ruolo IAM, usa il [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
```
Dove:
+ *policy-arn*è tuo salvato`kendra-cloudwatch-arn`.
------
#### [ macOS ]
```
aws iam attach-role-policy \
--policy-arn policy-arn \
--role-name kendra-role
```
Dove:
+ *policy-arn*è tuo salvato`kendra-cloudwatch-arn`.
------
#### [ Windows ]
```
aws iam attach-role-policy ^
--policy-arn policy-arn ^
--role-name kendra-role
```
Dove:
+ *policy-arn*è tuo salvato`kendra-cloudwatch-arn`.
------
1. Per creare un indice, usa il 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
```
Dove:
+ *role-arn*è tuo salvato, `kendra-role-arn`
+ *aws-region*è la tua AWS regione.
------
#### [ macOS ]
```
aws kendra create-index \
--name kendra-index \
--edition DEVELOPER_EDITION \
--role-arn role-arn \
--region aws-region
```
Dove:
+ *role-arn*è la tua salvezza`kendra-role-arn`,
+ *aws-region*è la tua AWS regione.
------
#### [ Windows ]
```
aws kendra create-index ^
--name kendra-index ^
--edition DEVELOPER_EDITION ^
--role-arn role-arn ^
--region aws-region
```
Dove:
+ *role-arn*è la tua salvezza`kendra-role-arn`,
+ *aws-region*è la tua AWS regione.
------
1. Copia l'indice `Id` e salvalo in un editor di testo come`kendra-index-id`. Ti `Id` aiuta a tenere traccia dello stato della creazione dell'indice.
1. Per tenere traccia dello stato di avanzamento del processo di creazione dell'indice, utilizzate il 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
```
Dove:
+ *kendra-index-id*è tuo salvato, `kendra-index-id`
+ *aws-region*è la tua AWS regione.
------
#### [ macOS ]
```
aws kendra describe-index \
--id kendra-index-id \
--region aws-region
```
Dove:
+ *kendra-index-id*è la tua salvezza`kendra-index-id`,
+ *aws-region*è la tua AWS regione.
------
#### [ Windows ]
```
aws kendra describe-index ^
--id kendra-index-id ^
--region aws-region
```
Dove:
+ *kendra-index-id*è la tua salvezza`kendra-index-id`,
+ *aws-region*è la tua AWS regione.
------
Il processo di creazione dell'indice richiede in media 15 minuti, ma può richiedere più tempo. Quando lo stato dell'indice è attivo, l'indice è pronto per l'uso. Durante la creazione dell'indice, puoi iniziare la fase successiva.
Se utilizzi il AWS CLI in questa fase, crei e alleghi una policy IAM al tuo ruolo IAM di Amazon Kendra che concede all'indice le autorizzazioni per accedere al tuo bucket S3.
## Aggiornamento del ruolo IAM per l'accesso ad Amazon S3
Durante la creazione dell'indice, aggiorni il tuo ruolo IAM di Amazon Kendra per consentire all'indice che hai creato di leggere i dati dal tuo bucket Amazon S3. Per ulteriori informazioni, consulta i [ruoli di accesso IAM per Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html).
### Per aggiornare il tuo ruolo IAM (Console)
1. Aprire la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Nel riquadro di navigazione a sinistra, scegli **Ruoli** e inserisci **kendra-role** nella casella **di ricerca** sopra il **nome del ruolo**.
1. Tra le opzioni suggerite, fai clic su`kendra-role`.
1. In **Riepilogo**, scegli **Allega politiche**.
1. In **Allega autorizzazioni**, nella casella **Cerca**, inserisci **S3** e seleziona la casella di controllo accanto alla ReadOnlyAccess politica **AmazonS3** tra le opzioni suggerite.
1. Scegli **Collega policy**. Nella pagina di **riepilogo**, ora vedrai due policy associate al ruolo IAM.
1. Torna alla console Amazon Kendra [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)all'indirizzo e attendi che lo stato dell'indice passi **da** Creato ad Attivo prima di **procedere** con il passaggio successivo.
### Per aggiornare il tuo ruolo IAM ()AWS CLI
1. Salva il testo seguente in un file JSON chiamato `kendra-S3-access-policy.json` in un editor di testo sul tuo dispositivo locale.
Sostituisci amzn-s3-demo-bucket con il nome del tuo bucket S3, con la tua AWS regione, con il tuo ID account a 12 cifre e *aws-region* con i dati salvati. *aws-account-id* AWS *kendra-index-id* `kendra-index-id`
1. [Per creare una policy IAM per accedere al tuo bucket S3, usa il 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
```
Dove:
+ *path/*è il percorso del file sul dispositivo locale. `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
```
Dove:
+ *path/*è il percorso del file `kendra-S3-access-policy.json` sul dispositivo locale.
------
#### [ Windows ]
```
aws iam create-policy ^
--policy-name kendra-S3-access-policy ^
--policy-document file://path/kendra-S3-access-policy.json
```
Dove:
+ *path/*è il percorso del file `kendra-S3-access-policy.json` sul dispositivo locale.
------
1. Copia l'Amazon Resource Name (ARN) nel tuo editor di testo e salvalo localmente come. `kendra-S3-access-arn`
**Nota**
L'ARN ha un formato simile a. *arn:aws:iam::123456789012:role/kendra-S3-access-policy* Hai bisogno dell'ARN che hai salvato `kendra-S3-access-arn` per collegarlo `kendra-S3-access-policy` al tuo ruolo IAM.
1. Per collegarlo `kendra-S3-access-policy` al tuo ruolo IAM di Amazon Kendra, usa il 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
```
Dove:
+ *policy-arn*è tuo salvato. `kendra-S3-access-arn`
------
#### [ macOS ]
```
aws iam attach-role-policy \
--policy-arn policy-arn \
--role-name kendra-role
```
Dove:
+ *policy-arn*è tuo salvato`kendra-S3-access-arn`.
------
#### [ Windows ]
```
aws iam attach-role-policy ^
--policy-arn policy-arn ^
--role-name kendra-role
```
Dove:
+ *policy-arn*è tuo salvato`kendra-S3-access-arn`.
------
## Creazione di campi dell'indice di ricerca personalizzati di Amazon Kendra
Per preparare Amazon Kendra a riconoscere i tuoi metadati come attributi di documento personalizzati, crei campi personalizzati corrispondenti ai tipi di entità Amazon Comprehend. Inserisci i seguenti nove tipi di entità Amazon Comprehend come campi personalizzati:
+ ARTICOLO\$1COMMERCIALE
+ DATE
+ EVENT
+ LOCATION
+ ORGANIZZAZIONE
+ OTHER
+ PERSONA
+ QUANTITÀ
+ TITOLO
**Importante**
I tipi di entità con errori di ortografia non verranno riconosciuti dall'indice.
### Per creare campi personalizzati per il tuo indice Amazon Kendra (Console)
1. Apri la console Amazon Kendra all'indirizzo. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)
1. Dall'elenco degli **indici**, fai clic su. `kendra-index`
1. Dal pannello di navigazione a sinistra, in **Gestione dati**, scegli Definizione delle **sfaccettature**.
1. Dal menu **Campi indice**, scegli **Aggiungi campo**.
1. Nella finestra di dialogo **Aggiungi campo indice**, procedi come segue:
1. In **Nome campo**, immettete**COMMERCIAL\$1ITEM**.
1. In **Tipo di dati**, scegli **Elenco stringhe**.
1. **In **Tipi di utilizzo**, seleziona **Facetable**, **Ricercabile e **Visualizzabile****, quindi scegli Aggiungi.**
1. Ripeti i passaggi da a c per ogni tipo di entità Amazon Comprehend: COMMERCIAL\$1ITEM, DATE, EVENT, LOCATION, ORGANIZATION, OTHER, PERSON, QUANTITY, TITLE.
La console visualizza i messaggi di aggiunta dei campi con esito positivo. Puoi scegliere di chiuderli prima di procedere con il passaggio successivo.
### Per creare campi personalizzati per il tuo indice Amazon Kendra ()AWS CLI
1. Salva il testo seguente come file JSON richiamato `custom-attributes.json` in un editor di testo sul tuo dispositivo locale.
```
[
{
"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. Per creare campi personalizzati nel tuo indice, usa il 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
```
Dove:
+ *kendra-index-id*è tuo salvato, `kendra-index-id`
+ *path/*è il percorso del file `custom-attributes.json` sul dispositivo locale,
+ *aws-region*è la tua AWS regione.
------
#### [ macOS ]
```
aws kendra update-index \
--id kendra-index-id \
--document-metadata-configuration-updates file://path/custom-attributes.json \
--region aws-region
```
Dove:
+ *kendra-index-id*è la tua salvezza`kendra-index-id`,
+ *path/*è il percorso del file `custom-attributes.json` sul dispositivo locale,
+ *aws-region*è la tua AWS regione.
------
#### [ Windows ]
```
aws kendra update-index ^
--id kendra-index-id ^
--document-metadata-configuration-updates file://path/custom-attributes.json ^
--region aws-region
```
Dove:
+ *kendra-index-id*è la tua salvezza`kendra-index-id`,
+ *path/*è il percorso del file `custom-attributes.json` sul dispositivo locale,
+ *aws-region*è la tua AWS regione.
------
1. Per verificare che gli attributi personalizzati siano stati aggiunti al tuo indice, usa il 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
```
Dove:
+ *kendra-index-id*è stato salvato, `kendra-index-id`
+ *aws-region*è la tua AWS regione.
------
#### [ macOS ]
```
aws kendra describe-index \
--id kendra-index-id \
--region aws-region
```
Dove:
+ *kendra-index-id*è la tua salvezza`kendra-index-id`,
+ *aws-region*è la tua AWS regione.
------
#### [ Windows ]
```
aws kendra describe-index ^
--id kendra-index-id ^
--region aws-region
```
Dove:
+ *kendra-index-id*è la tua salvezza`kendra-index-id`,
+ *aws-region*è la tua AWS regione.
------
## Aggiungere il bucket Amazon S3 come origine dati per l'indice
Prima di poter sincronizzare l'indice, devi connettere l'origine dati S3 ad esso.
### Per connettere un bucket S3 al tuo indice Amazon Kendra (console)
1. Apri la console Amazon Kendra all'indirizzo. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)
1. Dall'elenco degli **indici**, fai clic su. `kendra-index`
1. Dal menu di navigazione a sinistra, in **Gestione dei dati**, scegli Fonti di **dati**.
1. Nella sezione **Seleziona il tipo di connettore di origine dati**, accedi ad **Amazon S3** e scegli **Aggiungi** connettore.
1. Nella pagina **Specificare i dettagli dell'origine dati**, procedi come segue:
1. In **Nome e descrizione**, per **Nome origine dati**, immettere**S3-data-source**.
1. Mantieni vuota la sezione **Descrizione**.
1. Mantieni le impostazioni predefinite per i **tag**.
1. Scegli **Next (Successivo)**.
1. Nella pagina **Configura le impostazioni di sincronizzazione**, nella sezione **Ambito di sincronizzazione**, procedi come segue:
1. In **Inserisci la posizione dell'origine dati**, scegli **Browse S3**.
1. **In **Scegli le risorse**, seleziona il tuo bucket S3, quindi scegli Scegli.**
1. **In **Posizione della cartella del prefisso dei file di metadati**, scegli Sfoglia S3.**
1. In **Scegli le risorse**, fai clic sul nome del tuo bucket dall'elenco dei bucket.
1. **Per **Oggetti**, seleziona la casella di opzione per `metadata` e scegli Scegli.** Il campo della posizione dovrebbe ora indicare`metadata/`.
1. Mantieni le impostazioni predefinite per la **posizione del file di configurazione dell'elenco di controllo degli accessi**, **Seleziona la chiave di decrittografia** e la configurazione **aggiuntiva**.
1. Per il **ruolo IAM, nella** pagina **Configura le impostazioni di sincronizzazione**, scegli. `kendra-role`
1. Nella pagina **Configura le impostazioni di sincronizzazione**, in **Pianificazione di esecuzione della sincronizzazione**, per **Frequenza**, scegli **Esegui su richiesta**, quindi scegli **Avanti**.
1. Nella pagina **Rivedi e crea**, esamina le tue scelte relative ai dettagli dell'origine dati e scegli **Aggiungi origine dati**.
### Per connettere un bucket S3 al tuo indice Amazon Kendra ()AWS CLI
1. Salva il testo seguente come file JSON richiamato `S3-data-connector.json` in un editor di testo sul tuo dispositivo locale.
```
{
"S3Configuration":{
"BucketName":"amzn-s3-demo-bucket",
"DocumentsMetadataConfiguration":{
"S3Prefix":"metadata"
}
}
}
```
Sostituisci amzn-s3-demo-bucket con il nome del tuo bucket S3.
1. Per connettere il bucket S3 all'indice, usa il comando: [create-data-source](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/create-data-source.html)
------
#### [ 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
```
Dove:
+ *kendra-index-id*è tuo salvato, `kendra-index-id`
+ *path/*è il percorso del file `S3-data-connector.json` sul dispositivo locale,
+ *role-arn*è tuo salvato`kendra-role-arn`,
+ *aws-region*è la tua AWS regione.
------
#### [ 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
```
Dove:
+ *kendra-index-id*è la tua salvezza`kendra-index-id`,
+ *path/*è il percorso del file `S3-data-connector.json` sul dispositivo locale,
+ *role-arn*è tuo salvato`kendra-role-arn`,
+ *aws-region*è la tua AWS regione.
------
#### [ 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
```
Dove:
+ *kendra-index-id*è la tua salvezza`kendra-index-id`,
+ *path/*è il percorso del file `S3-data-connector.json` sul dispositivo locale,
+ *role-arn*è tuo salvato`kendra-role-arn`,
+ *aws-region*è la tua AWS regione.
------
1. Copia il connettore `Id` e salvalo in un editor di testo come`S3-connector-id`. Ti `Id` aiuta a tenere traccia dello stato del processo di connessione dati.
1. Per assicurarti che la tua fonte di dati S3 sia stata connessa correttamente, usa il comando: [describe-data-source](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/describe-data-source.html)
------
#### [ Linux ]
```
aws kendra describe-data-source \
--id S3-connector-id \
--index-id kendra-index-id \
--region aws-region
```
Dove:
+ *S3-connector-id*è stato salvato`S3-connector-id`,
+ *kendra-index-id*è tuo salvato`kendra-index-id`,
+ *aws-region*è la tua AWS regione.
------
#### [ macOS ]
```
aws kendra describe-data-source \
--id S3-connector-id \
--index-id kendra-index-id \
--region aws-region
```
Dove:
+ *S3-connector-id*è la tua salvezza`S3-connector-id`,
+ *kendra-index-id*è tuo salvato`kendra-index-id`,
+ *aws-region*è la tua AWS regione.
------
#### [ Windows ]
```
aws kendra describe-data-source ^
--id S3-connector-id ^
--index-id kendra-index-id ^
--region aws-region
```
Dove:
+ *S3-connector-id*è la tua salvezza`S3-connector-id`,
+ *kendra-index-id*è tuo salvato`kendra-index-id`,
+ *aws-region*è la tua AWS regione.
------
Al termine di questo passaggio, l'origine dati Amazon S3 è connessa all'indice.
## Sincronizzazione dell'indice Amazon Kendra
Con l'aggiunta dell'origine dati Amazon S3, ora puoi sincronizzare il tuo indice Amazon Kendra con essa.
### Per sincronizzare il tuo indice Amazon Kendra (console)
1. Apri la console Amazon Kendra all'indirizzo. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)
1. Dall'elenco degli **indici**, fai clic su. `kendra-index`
1. Dal menu di navigazione a sinistra, scegli **Origini dati**.
1. Da **Fonti dati, seleziona**. `S3-data-source`
1. Nella barra di navigazione in alto, scegli **Sincronizza ora**.
### Per sincronizzare il tuo indice Amazon Kendra ()AWS CLI
1. Per sincronizzare l'indice, usa il 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
```
Dove:
+ *S3-connector-id*è tuo salvato`S3-connector-id`,
+ *kendra-index-id*è tuo salvato`kendra-index-id`,
+ *aws-region*è la tua AWS regione.
------
#### [ macOS ]
```
aws kendra start-data-source-sync-job \
--id S3-connector-id \
--index-id kendra-index-id \
--region aws-region
```
Dove:
+ *S3-connector-id*è la tua salvezza`S3-connector-id`,
+ *kendra-index-id*è tuo salvato`kendra-index-id`,
+ *aws-region*è la tua AWS regione.
------
#### [ Windows ]
```
aws kendra start-data-source-sync-job ^
--id S3-connector-id ^
--index-id kendra-index-id ^
--region aws-region
```
Dove:
+ *S3-connector-id*è la tua salvezza`S3-connector-id`,
+ *kendra-index-id*è tuo salvato`kendra-index-id`,
+ *aws-region*è la tua AWS regione.
------
1. Per verificare lo stato della sincronizzazione dell'indice, usa il 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
```
Dove:
+ *S3-connector-id*è stato salvato`S3-connector-id`,
+ *kendra-index-id*è tuo salvato`kendra-index-id`,
+ *aws-region*è la tua AWS regione.
------
#### [ macOS ]
```
aws kendra list-data-source-sync-jobs \
--id S3-connector-id \
--index-id kendra-index-id \
--region aws-region
```
Dove:
+ *S3-connector-id*è la tua salvezza`S3-connector-id`,
+ *kendra-index-id*è tuo salvato`kendra-index-id`,
+ *aws-region*è la tua AWS regione.
------
#### [ Windows ]
```
aws kendra list-data-source-sync-jobs ^
--id S3-connector-id ^
--index-id kendra-index-id ^
--region aws-region
```
Dove:
+ *S3-connector-id*è la tua salvezza`S3-connector-id`,
+ *kendra-index-id*è tuo salvato`kendra-index-id`,
+ *aws-region*è la tua AWS regione.
------
Al termine di questo passaggio, hai creato un indice Amazon Kendra ricercabile e filtrabile per il tuo set di dati.