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 livraison Amazon S3
<a name="data-delivery-s3-create"></a>

 Créez une diffusion qui envoie les enregistrements d'un flux Amazon Kinesis Data Streams vers un compartiment Amazon S3 à usage général. Vous pouvez créer une livraison avec le Console de gestion AWS ou le AWS CLI. Les enregistrements sont fournis dans leur format source, regroupés en objets de taille optimale, avec une compression configurable et une structure de clés S3 que vous définissez. 

**Note**  
 Avant de créer une livraison, remplissez les conditions requises dans[Commencer à utiliser la livraison à usage général S3](data-delivery-s3-getting-started.md), y compris le rôle d'exécution du service IAM décrit dans. [Autorisations IAM pour la livraison de données](data-delivery-iam.md) 

## Utilisation de Console de gestion AWS
<a name="data-delivery-s3-create-console"></a>

1. Ouvrez la console Kinesis à l'adresse. [https://console.aws.amazon.com/kinesis](https://console.aws.amazon.com/kinesis)

1. Dans le volet de navigation, choisissez **S3 general purpose delivery**, puis **Create delivery**.

1. **Étape 1 : Configuration de la source** Sous **Détails de livraison**, entrez un **nom de livraison**. Pour **Source**, choisissez le On-Demand flux à partir duquel vous souhaitez diffuser. Seuls On-Demand les streams sont affichés. Choisissez **Suivant**.

1. **Étape 2 : Configuration de la destination** Choisissez un **format d'enregistrement** (**JSON**, **STRING** ou **BYTE\_ARRAY**), puis spécifiez la destination :
   + **ARN du compartiment S3** : l'ARN du compartiment Amazon S3 à usage général de destination.
   + **Propriétaire attendu du compartiment** : Compte AWS identifiant à 12 chiffres du propriétaire attendu du compartiment.
   + **Type de compression** **: choisissez **GZIP**, **ZSTD ou Aucun**.**
   + **Classe de stockage** : choisissez éventuellement une classe de stockage Amazon S3.
   + **Modèle de clé de sortie** : définissez éventuellement la structure de clé d'objet Amazon S3. Pour plus de détails, consultez [Modèle de clé de sortie S3 pour la livraison d'Amazon S3](data-delivery-s3-key-template.md).
   + **Actualité des données** : durée maximale de mise en mémoire tampon en secondes avant la livraison des enregistrements (minimum 300, maximum 900).

   Choisissez **Suivant**.

1. **Étape 3 : Configuration supplémentaire** Configurez le chiffrement, l'accès au service (le rôle IAM), une file d'attente optionnelle contenant des lettres mortes, la livraison des journaux et les balises. Choisissez **Suivant**.

1. **Étape 4 : Révisez et créez** Vérifiez votre configuration, puis choisissez **Create delivery**. La livraison passe de CREATING à ACTIVE une fois le provisionnement terminé.

## Utilisation de AWS CLI
<a name="data-delivery-s3-create-cli"></a>

 Utilisez la `create-channel` commande pour créer une livraison Amazon S3 qui envoie des enregistrements vers un compartiment Amazon S3 à usage général au format JSON et à la compression GZIP : 

```
aws kinesis create-channel \
    --channel-name "my-s3-delivery" \
    --service-execution-role-arn "arn:aws:iam::111122223333:role/my-channel-role" \
    --stream-configuration-list '[
        {
            "StreamARN": "arn:aws:kinesis:us-east-1:111122223333:stream/my-stream",
            "RecordConfiguration": {
                "RecordFormatType": "JSON"
            }
        }
    ]' \
    --s3-destination-configuration '{
        "DataFreshnessInSeconds": 300,
        "StorageConfiguration": {
            "BucketARN": "arn:aws:s3:::amzn-s3-demo-destination-bucket",
            "ExpectedBucketOwner": "111122223333",
            "CompressionType": "GZIP",
            "StorageClass": "STANDARD"
        }
    }'
```

 La commande renvoie le canal ARN (`ChannelARN`). Utilisez-le avec `describe-channel` pour vérifier que la livraison atteint l'état ACTIF. Consultez [Décrire une livraison Amazon S3](data-delivery-s3-describe.md). Pour personnaliser la structure des clés d'objet Amazon S3, consultez[Modèle de clé de sortie S3 pour la livraison d'Amazon S3](data-delivery-s3-key-template.md). 

 **Référence d'API** : voir `CreateChannel` la référence d'*API Amazon Kinesis Data Streams*.