WIP Alert This is a work in progress. Current information is correct but more content will probably be added in the future.
HEADS-UP If you have not yet installed the aws cli, you need to install it and set up you credentials
Create a stream
$ aws create-stream \ --stream-name "my-stream" \ --shard-count 1
Reshard a stream
I.e. add more shards to a stream.
Note that you can only set the new number of shards up to the limit of double your current number of shards.
my-stream currently has one single shard and we want to increase it to 2):
$ aws kinesis update-shard-count \ --stream-name "my-stream" \ --target-shard-count 2 \ --scaling-type "UNIFORM_SCALING"
Enable enhanced monitoring
I.e. unlock shard-level (not just stream-level) cloudwatch metrics.
$ aws kinesis \ --stream-name "my-stream" \ --shard-level-metrics "ALL"
This can happen for a variety of reasons, such as:
Trying to update the number of shards (resharding) more than twice in a single day
Trying to create more than 5 shards in a short period of time
Overall, if you see this exception upon trying to do something, chances are it'll go away by itself if you try again some other time (wait a couple of hours or maybe a day or two).