Update a stream
You can update the details of a stream using the Kinesis Data Streams console, the Kinesis Data Streams API, or the Amazon CLI.
Note
You can enable server-side encryption for existing streams, or for streams that you have recently created.
Use the console
To update a data stream using the console
-
Open the Amazon Kinesis console at https://console.amazonaws.cn/kinesis/
. -
In the navigation bar, expand the Region selector and choose a Region.
-
Choose the name of your stream in the list. The Stream Details page displays a summary of your stream configuration and monitoring information.
-
To switch between on-demand and provisioned capacity modes for a data stream, choose Edit capacity mode in the Configuration tab. For more information, see Choose the data stream capacity mode.
Important
For each data stream in your Amazon account, you can switch between the on-demand and provisioned modes twice within 24 hours.
-
For a data stream with the provisioned mode, to edit the number of shards, choose Edit provisioned shards in the Configuration tab, and then enter a new shard count.
-
To enable server-side encryption of data records, choose Edit in the Server-side encryption section. Choose a KMS key to use as the master key for encryption, or use the default master key, aws/kinesis, managed by Kinesis. If you enable encryption for a stream and use your own Amazon KMS master key, ensure that your producer and consumer applications have access to the Amazon KMS master key that you used. To assign permissions to an application to access a user-generated Amazon KMS key, see Permissions to use user-generated KMS keys.
-
To edit the data retention period, choose Edit in the Data retention period section, and then enter a new data retention period.
-
If you have enabled custom metrics on your account, choose Edit in the Shard level metrics section, and then specify metrics for your stream. For more information, see Monitor the Amazon Kinesis Data Streams service with Amazon CloudWatch.
Use the API
To update stream details using the API, see the following methods:
Use the Amazon CLI
For information about updating a stream using the Amazon CLI, see the Kinesis CLI reference.