View a markdown version of this page

Mettre à jour un stream - Amazon Kinesis Data Streams
Utilisation de la consoleUtilisation de l’APIUtilisez la commande AWS CLI

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.

Mettre à jour un stream

Vous pouvez mettre à jour les détails d'un flux à l'aide de la console Kinesis Data Streams, de l'API Kinesis Data Streams ou de la AWS CLI.

Note

Vous pouvez activer un chiffrement côté serveur pour des flux de données existants ou pour des flux que vous avez créé récemment.

Utilisation de la console

Pour mettre à jour un flux de données avec la console

  1. Ouvrez la console Amazon Kinesis à https://console.aws.amazon.com/kinesis/ l'adresse.

  2. Dans la barre de navigation, développez le sélecteur de région et choisissez une région.

  3. Choisissez le nom de votre flux dans la liste. La page Détails du flux affiche un récapitulatif de la configuration de flux, ainsi que des informations de surveillance.

  4. Pour passer du mode de capacité à la demande au mode de capacité provisionnée pour un flux de données, choisissez le mode Modifier la capacité dans l'onglet Configuration. Pour de plus amples informations, veuillez consulter Choisissez le bon mode de diffusion.

    Important

    Pour chaque flux de données de votre AWS compte, vous pouvez basculer entre le mode à la demande et le mode provisionné deux fois en 24 heures.

  5. Pour un flux de données en mode à la demande avec le mode On-demand Advantage activé, vous pouvez configurer le débit chaud pour augmenter ou diminuer la capacité d'ingestion du flux.

    Pour augmenter la capacité d'ingestion

    Dans l'onglet Configuration, choisissez Modifier le débit chaud et entrez une valeur de débit cible (en MB/s) supérieure à la capacité actuelle du flux. Le flux fournit immédiatement de la capacité au moins au débit chaud spécifié, garantissant ainsi qu'il peut gérer le trafic attendu sans limitation. Par exemple, si vous prévoyez qu'un événement à venir atteindra un pic autour de 200 MB/s, réglez le débit chaud à 200 à l' MB/s avance, sans frais supplémentaires.

    Pour réduire la capacité d'ingestion

    Si l'échelle du flux a dépassé de manière significative sa valeur de débit chaud, reconfigurez le débit chaud à cette valeur ou à une valeur inférieure pour déclencher une réduction d'échelle. Le flux s'adapte au nombre demandé ou à la capacité requise pour prendre en charge les pics d'utilisation des données ingérés observés au cours de la dernière heure, selon la valeur la plus élevée. Cela garantit que le flux conserve toujours une capacité suffisante pour gérer les modèles de trafic récents.

    L'utilisation du débit chaud n'entraîne aucun coût supplémentaire. Pour de plus amples informations, veuillez consulter On-demand Fonctionnalités et cas d'utilisation du mode Advantage.

  6. Pour un flux de données en mode provisionné, pour modifier le nombre de partitions, choisissez Modifier les partitions provisionnées dans l'onglet Configuration, puis saisissez un nouveau nombre de partitions.

  7. Pour activer le chiffrement côté serveur des enregistrements de données, choisissez Modifier dans la section Server-side Chiffrement. Choisissez une clé KMS à utiliser comme clé principale pour le chiffrement, ou utilisez la clé principale par défaut aws/kinesis, gérée par Kinesis. Si vous activez le chiffrement d'un flux et que vous utilisez votre propre clé AWS KMS principale, assurez-vous que vos applications de production et de consommation ont accès à la clé AWS KMS principale que vous avez utilisée. Pour attribuer des autorisations à une application afin qu'elle puisse accéder à une clé AWS KMS générée par un utilisateur, consultez Autorisations d'utilisation des clés KMS générées par l'utilisateur.

  8. Pour modifier la période de conservation des données, choisissez Modifier dans la section Durée de conservation des données, puis saisissez une nouvelle durée de conservation des données.

  9. Si vous avez activé les métriques personnalisées sur votre compte, choisissez Modifier dans la section Mesures au niveau des partitions, puis spécifiez les métriques pour votre flux. Pour de plus amples informations, veuillez consulter Surveillez le service Amazon Kinesis Data Streams avec Amazon CloudWatch.

Utilisation de l’API

Pour mettre à jour les détails d'un flux à l'aide de l'API, consultez les méthodes suivantes :

Utilisez la commande AWS CLI

Pour plus d'informations sur la mise à jour d'un flux à l'aide de AWS CLI, consultez la référence de l'interface de ligne de commande Kinesis.

Pour configurer le débit chaud à l'aide de AWS CLI, utilisez la update-stream-warm-throughput commande. Par exemple :

aws kinesis update-stream-warm-throughput \
    --stream-arn arn:aws:kinesis:us-east-1:123456789012:stream/my-stream \
    --warm-throughput-mi-bps=200

Pour réduire la capacité, reconfigurez warm-throughput-mi-bps à la même valeur ou à une valeur inférieure :

aws kinesis update-stream-warm-throughput \
    --stream-arn arn:aws:kinesis:us-east-1:123456789012:stream/my-stream \
    --warm-throughput-mi-bps=50

Le flux s'adapte au débit chaud demandé ou à la capacité requise pour prendre en charge les pics récents d'utilisation des données ingérées, selon la valeur la plus élevée.