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à.

# Creazione di una fonte di dati Amazon S3
<a name="create-ds-s3"></a>

Gli esempi seguenti illustrano la creazione di un'origine Amazon S3 dati. Gli esempi presuppongono che siano già stati creati un indice e un IAM ruolo con l'autorizzazione a leggere i dati dall'indice. Per ulteriori informazioni sul IAM ruolo, vedi [ruoli di IAM accesso](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Per ulteriori informazioni sulla creazione di un indice, vedere [Creazione di un indice](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html).

------
#### [ CLI ]

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

------
#### [ Python ]

Il seguente frammento di codice Python crea una fonte di dati. Amazon S3 Per l'esempio completo, vedi. [Nozioni di base (AWS SDK per Python (Boto3))](gs-python.md)

```
print("Create an Amazon S3 data source.")
    
    # Provide a name for the data source
    name = "getting-started-data-source"
    # Provide an optional description for the data source
    description = "Getting started data source."
    # Provide the IAM role ARN required for data sources
    role_arn = "arn:aws:iam::${accountID}:role/${roleName}"
    # Provide the data soource connection information
    s3_bucket_name = "S3-bucket-name"
    type = "S3"
    # Configure the data source
    configuration = {"S3DataSourceConfiguration":
        {
            "BucketName": s3_bucket_name
        }
    }

    data_source_response = kendra.create_data_source(
        Configuration = configuration,
        Name = name,
        Description = description,
        RoleArn = role_arn,
        Type = type,
        IndexId = index_id
    )
```

------

La creazione dell'origine dati può richiedere del tempo. Puoi monitorare i progressi utilizzando l'[DescribeDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DescribeDataSource.html)API. Quando lo stato dell'origine dati è impostato`ACTIVE`, l'origine dati è pronta per l'uso. 

Gli esempi seguenti mostrano come ottenere lo stato di un'origine dati.

------
#### [ CLI ]

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

------
#### [ Python ]

Il seguente frammento di codice Python ottiene informazioni su una fonte di dati S3. Per l'esempio completo, vedi. [Nozioni di base (AWS SDK per Python (Boto3))](gs-python.md)

```
print("Wait for Amazon Kendra to create the data source.")

    while True:
        data_source_description = kendra.describe_data_source(
            Id = "{{data-source-id}}",
            IndexId = "{{index-id}}"
        )
        status = data_source_description["Status"]
        print(" Creating data source. Status: "+status)
        time.sleep(60)
        if status != "CREATING":
            break
```

------

Questa fonte di dati non ha una pianificazione, quindi non viene eseguita automaticamente. Per indicizzare l'origine dati, si chiama [StartDataSourceSyncJob](https://docs.aws.amazon.com/kendra/latest/APIReference/API_StartDataSourceSyncJob.html)per sincronizzare l'indice con l'origine dati.

Gli esempi seguenti mostrano la sincronizzazione di un'origine dati.

------
#### [ CLI ]

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

------
#### [ Python ]

Il seguente frammento di codice Python sincronizza un'origine dati. Amazon S3 Per l'esempio completo, vedi. [Nozioni di base (AWS SDK per Python (Boto3))](gs-python.md)

```
print("Synchronize the data source.")

    sync_response = kendra.start_data_source_sync_job(
        Id = "{{data-source-id}}",
        IndexId = "{{index-id}}"
    )
```

------