Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Création d'une source Amazon S3 de données
<a name="create-ds-s3"></a>

Les exemples suivants illustrent la création d'une source de Amazon S3 données. Les exemples supposent que vous avez déjà créé un index et un IAM rôle autorisés à lire les données de l'index. Pour plus d'informations sur le IAM rôle, consultez la section [Rôles IAM d'accès](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds). Pour plus d'informations sur la création d'un index, consultez la section [Création d'un index](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 ]

L'extrait de code Python suivant crée une source de Amazon S3 données. Pour un exemple complet, voir[Démarrer (AWS SDK pour 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 création de votre source de données peut prendre un certain temps. Vous pouvez suivre la progression à l'aide de l'[DescribeDataSource](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DescribeDataSource.html)API. Lorsque le statut de la source de données est `ACTIVE` défini, la source de données est prête à être utilisée. 

Les exemples suivants montrent comment obtenir le statut d'une source de données.

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

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

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

L'extrait de code Python suivant permet d'obtenir des informations sur une source de données S3. Pour un exemple complet, voir[Démarrer (AWS SDK pour 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
```

------

Cette source de données n'a pas de calendrier, elle ne s'exécute donc pas automatiquement. Pour indexer la source de données, vous appelez [StartDataSourceSyncJob](https://docs.aws.amazon.com/kendra/latest/APIReference/API_StartDataSourceSyncJob.html)pour synchroniser l'index avec la source de données.

Les exemples suivants illustrent la synchronisation d'une source de données.

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

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

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

L'extrait de code Python suivant synchronise une Amazon S3 source de données. Pour un exemple complet, voir[Démarrer (AWS SDK pour 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"
    )
```

------