import datetime import time import pytest import boto3 from botocore.exceptions import ClientError from dateutil.tz import tzlocal from moto import mock_kinesis from moto.core import DEFAULT_ACCOUNT_ID as ACCOUNT_ID import sure # noqa # pylint: disable=unused-import @mock_kinesis def test_stream_creation_on_demand(): client = boto3.client("kinesis", region_name="eu-west-1") client.create_stream( StreamName="my_stream", StreamModeDetails={"StreamMode": "ON_DEMAND"} ) # AWS starts with 4 shards by default shard_list = client.list_shards(StreamName="my_stream")["Shards"] shard_list.should.have.length_of(4) # Cannot update-shard-count when we're in on-demand mode with pytest.raises(ClientError) as exc: client.update_shard_count( StreamName="my_stream", TargetShardCount=3, ScalingType="UNIFORM_SCALING" ) err = exc.value.response["Error"] err["Code"].should.equal("ValidationException") err["Message"].should.equal( f"Request is invalid. Stream my_stream under account {ACCOUNT_ID} is in On-Demand mode." ) @mock_kinesis def test_update_stream_mode(): client = boto3.client("kinesis", region_name="eu-west-1") resp = client.create_stream( StreamName="my_stream", StreamModeDetails={"StreamMode": "ON_DEMAND"} ) arn = client.describe_stream(StreamName="my_stream")["StreamDescription"][ "StreamARN" ] client.update_stream_mode( StreamARN=arn, StreamModeDetails={"StreamMode": "PROVISIONED"} ) resp = client.describe_stream_summary(StreamName="my_stream") stream = resp["StreamDescriptionSummary"] stream.should.have.key("StreamModeDetails").equals({"StreamMode": "PROVISIONED"}) @mock_kinesis def test_describe_non_existent_stream_boto3(): client = boto3.client("kinesis", region_name="us-west-2") with pytest.raises(ClientError) as exc: client.describe_stream_summary(StreamName="not-a-stream") err = exc.value.response["Error"] err["Code"].should.equal("ResourceNotFoundException") err["Message"].should.equal( "Stream not-a-stream under account 123456789012 not found." ) @mock_kinesis def test_list_and_delete_stream_boto3(): client = boto3.client("kinesis", region_name="us-west-2") client.list_streams()["StreamNames"].should.have.length_of(0) client.create_stream(StreamName="stream1", ShardCount=1) client.create_stream(StreamName="stream2", ShardCount=1) client.list_streams()["StreamNames"].should.have.length_of(2) client.delete_stream(StreamName="stream1") client.list_streams()["StreamNames"].should.have.length_of(1) @mock_kinesis def test_delete_unknown_stream(): client = boto3.client("kinesis", region_name="us-west-2") with pytest.raises(ClientError) as exc: client.delete_stream(StreamName="not-a-stream") err = exc.value.response["Error"] err["Code"].should.equal("ResourceNotFoundException") err["Message"].should.equal( "Stream not-a-stream under account 123456789012 not found." ) @mock_kinesis def test_list_many_streams(): conn = boto3.client("kinesis", region_name="us-west-2") for i in range(11): conn.create_stream(StreamName=f"stream{i}", ShardCount=1) resp = conn.list_streams() stream_names = resp["StreamNames"] has_more_streams = resp["HasMoreStreams"] stream_names.should.have.length_of(10) has_more_streams.should.be(True) resp2 = conn.list_streams(ExclusiveStartStreamName=stream_names[-1]) stream_names = resp2["StreamNames"] has_more_streams = resp2["HasMoreStreams"] stream_names.should.have.length_of(1) has_more_streams.should.equal(False) @mock_kinesis def test_describe_stream_summary(): conn = boto3.client("kinesis", region_name="us-west-2") stream_name = "my_stream_summary" shard_count = 5 conn.create_stream(StreamName=stream_name, ShardCount=shard_count) resp = conn.describe_stream_summary(StreamName=stream_name) stream = resp["StreamDescriptionSummary"] stream["StreamName"].should.equal(stream_name) stream["OpenShardCount"].should.equal(shard_count) stream["StreamARN"].should.equal( f"arn:aws:kinesis:us-west-2:{ACCOUNT_ID}:stream/{stream_name}" ) stream["StreamStatus"].should.equal("ACTIVE") @mock_kinesis def test_basic_shard_iterator_boto3(): client = boto3.client("kinesis", region_name="us-west-1") stream_name = "mystream" client.create_stream(StreamName=stream_name, ShardCount=1) stream = client.describe_stream(StreamName=stream_name)["StreamDescription"] shard_id = stream["Shards"][0]["ShardId"] resp = client.get_shard_iterator( StreamName=stream_name, ShardId=shard_id, ShardIteratorType="TRIM_HORIZON" ) shard_iterator = resp["ShardIterator"] resp = client.get_records(ShardIterator=shard_iterator) resp.should.have.key("Records").length_of(0) resp.should.have.key("MillisBehindLatest").equal(0) @mock_kinesis def test_get_invalid_shard_iterator_boto3(): client = boto3.client("kinesis", region_name="us-west-1") stream_name = "mystream" client.create_stream(StreamName=stream_name, ShardCount=1) with pytest.raises(ClientError) as exc: client.get_shard_iterator( StreamName=stream_name, ShardId="123", ShardIteratorType="TRIM_HORIZON" ) err = exc.value.response["Error"] err["Code"].should.equal("ResourceNotFoundException") # There is some magic in AWS, that '123' is automatically converted into 'shardId-000000000123' # AWS itself returns this normalized ID in the error message, not the given id err["Message"].should.equal( f"Shard 123 in stream {stream_name} under account {ACCOUNT_ID} does not exist" ) @mock_kinesis def test_put_records_boto3(): client = boto3.client("kinesis", region_name="eu-west-2") stream_name = "my_stream_summary" client.create_stream(StreamName=stream_name, ShardCount=1) stream = client.describe_stream(StreamName=stream_name)["StreamDescription"] shard_id = stream["Shards"][0]["ShardId"] data = b"hello world" partition_key = "1234" response = client.put_record( StreamName=stream_name, Data=data, PartitionKey=partition_key ) response["SequenceNumber"].should.equal("1") resp = client.get_shard_iterator( StreamName=stream_name, ShardId=shard_id, ShardIteratorType="TRIM_HORIZON" ) shard_iterator = resp["ShardIterator"] resp = client.get_records(ShardIterator=shard_iterator) resp["Records"].should.have.length_of(1) record = resp["Records"][0] record["Data"].should.equal(b"hello world") record["PartitionKey"].should.equal("1234") record["SequenceNumber"].should.equal("1") @mock_kinesis def test_get_records_limit_boto3(): client = boto3.client("kinesis", region_name="eu-west-2") stream_name = "my_stream_summary" client.create_stream(StreamName=stream_name, ShardCount=1) stream = client.describe_stream(StreamName=stream_name)["StreamDescription"] shard_id = stream["Shards"][0]["ShardId"] data = b"hello world" for index in range(5): client.put_record(StreamName=stream_name, Data=data, PartitionKey=str(index)) resp = client.get_shard_iterator( StreamName=stream_name, ShardId=shard_id, ShardIteratorType="TRIM_HORIZON" ) shard_iterator = resp["ShardIterator"] # Retrieve only 3 records resp = client.get_records(ShardIterator=shard_iterator, Limit=3) resp["Records"].should.have.length_of(3) # Then get the rest of the results next_shard_iterator = resp["NextShardIterator"] response = client.get_records(ShardIterator=next_shard_iterator) response["Records"].should.have.length_of(2) @mock_kinesis def test_get_records_at_sequence_number_boto3(): client = boto3.client("kinesis", region_name="eu-west-2") stream_name = "my_stream_summary" client.create_stream(StreamName=stream_name, ShardCount=1) stream = client.describe_stream(StreamName=stream_name)["StreamDescription"] shard_id = stream["Shards"][0]["ShardId"] for index in range(1, 5): client.put_record( StreamName=stream_name, Data=f"data_{index}".encode("utf-8"), PartitionKey=str(index), ) resp = client.get_shard_iterator( StreamName=stream_name, ShardId=shard_id, ShardIteratorType="TRIM_HORIZON" ) shard_iterator = resp["ShardIterator"] # Retrieve only 2 records resp = client.get_records(ShardIterator=shard_iterator, Limit=2) sequence_nr = resp["Records"][1]["SequenceNumber"] # Then get a new iterator starting at that id resp = client.get_shard_iterator( StreamName=stream_name, ShardId=shard_id, ShardIteratorType="AT_SEQUENCE_NUMBER", StartingSequenceNumber=sequence_nr, ) shard_iterator = resp["ShardIterator"] resp = client.get_records(ShardIterator=shard_iterator) # And the first result returned should be the second item resp["Records"][0]["SequenceNumber"].should.equal(sequence_nr) resp["Records"][0]["Data"].should.equal(b"data_2") @mock_kinesis def test_get_records_after_sequence_number_boto3(): client = boto3.client("kinesis", region_name="eu-west-2") stream_name = "my_stream_summary" client.create_stream(StreamName=stream_name, ShardCount=1) stream = client.describe_stream(StreamName=stream_name)["StreamDescription"] shard_id = stream["Shards"][0]["ShardId"] for index in range(1, 5): client.put_record( StreamName=stream_name, Data=f"data_{index}".encode("utf-8"), PartitionKey=str(index), ) resp = client.get_shard_iterator( StreamName=stream_name, ShardId=shard_id, ShardIteratorType="TRIM_HORIZON" ) shard_iterator = resp["ShardIterator"] # Retrieve only 2 records resp = client.get_records(ShardIterator=shard_iterator, Limit=2) sequence_nr = resp["Records"][1]["SequenceNumber"] # Then get a new iterator starting at that id resp = client.get_shard_iterator( StreamName=stream_name, ShardId=shard_id, ShardIteratorType="AFTER_SEQUENCE_NUMBER", StartingSequenceNumber=sequence_nr, ) shard_iterator = resp["ShardIterator"] resp = client.get_records(ShardIterator=shard_iterator) # And the first result returned should be the second item resp["Records"][0]["SequenceNumber"].should.equal("3") resp["Records"][0]["Data"].should.equal(b"data_3") resp["MillisBehindLatest"].should.equal(0) @mock_kinesis def test_get_records_latest_boto3(): client = boto3.client("kinesis", region_name="eu-west-2") stream_name = "my_stream_summary" client.create_stream(StreamName=stream_name, ShardCount=1) stream = client.describe_stream(StreamName=stream_name)["StreamDescription"] shard_id = stream["Shards"][0]["ShardId"] for index in range(1, 5): client.put_record( StreamName=stream_name, Data=f"data_{index}".encode("utf-8"), PartitionKey=str(index), ) resp = client.get_shard_iterator( StreamName=stream_name, ShardId=shard_id, ShardIteratorType="TRIM_HORIZON" ) shard_iterator = resp["ShardIterator"] # Retrieve only 2 records resp = client.get_records(ShardIterator=shard_iterator, Limit=2) sequence_nr = resp["Records"][1]["SequenceNumber"] # Then get a new iterator starting at that id resp = client.get_shard_iterator( StreamName=stream_name, ShardId=shard_id, ShardIteratorType="LATEST", StartingSequenceNumber=sequence_nr, ) shard_iterator = resp["ShardIterator"] client.put_record( StreamName=stream_name, Data=b"last_record", PartitionKey="last_record" ) resp = client.get_records(ShardIterator=shard_iterator) # And the first result returned should be the second item resp["Records"].should.have.length_of(1) resp["Records"][0]["SequenceNumber"].should.equal("5") resp["Records"][0]["PartitionKey"].should.equal("last_record") resp["Records"][0]["Data"].should.equal(b"last_record") resp["MillisBehindLatest"].should.equal(0) @mock_kinesis def test_get_records_at_timestamp(): # AT_TIMESTAMP - Read the first record at or after the specified timestamp conn = boto3.client("kinesis", region_name="us-west-2") stream_name = "my_stream" conn.create_stream(StreamName=stream_name, ShardCount=1) # Create some data for index in range(1, 5): conn.put_record( StreamName=stream_name, Data=str(index), PartitionKey=str(index) ) # When boto3 floors the timestamp that we pass to get_shard_iterator to # second precision even though AWS supports ms precision: # http://docs.aws.amazon.com/kinesis/latest/APIReference/API_GetShardIterator.html # To test around this limitation we wait until we well into the next second # before capturing the time and storing the records we expect to retrieve. time.sleep(1.0) timestamp = datetime.datetime.utcnow() keys = [str(i) for i in range(5, 10)] for k in keys: conn.put_record(StreamName=stream_name, Data=k, PartitionKey=k) # Get a shard iterator response = conn.describe_stream(StreamName=stream_name) shard_id = response["StreamDescription"]["Shards"][0]["ShardId"] response = conn.get_shard_iterator( StreamName=stream_name, ShardId=shard_id, ShardIteratorType="AT_TIMESTAMP", Timestamp=timestamp, ) shard_iterator = response["ShardIterator"] response = conn.get_records(ShardIterator=shard_iterator) response["Records"].should.have.length_of(len(keys)) partition_keys = [r["PartitionKey"] for r in response["Records"]] partition_keys.should.equal(keys) response["MillisBehindLatest"].should.equal(0) @mock_kinesis def test_get_records_at_very_old_timestamp(): conn = boto3.client("kinesis", region_name="us-west-2") stream_name = "my_stream" conn.create_stream(StreamName=stream_name, ShardCount=1) # Create some data keys = [str(i) for i in range(1, 5)] for k in keys: conn.put_record(StreamName=stream_name, Data=k, PartitionKey=k) # Get a shard iterator response = conn.describe_stream(StreamName=stream_name) shard_id = response["StreamDescription"]["Shards"][0]["ShardId"] response = conn.get_shard_iterator( StreamName=stream_name, ShardId=shard_id, ShardIteratorType="AT_TIMESTAMP", Timestamp=1, ) shard_iterator = response["ShardIterator"] response = conn.get_records(ShardIterator=shard_iterator) response["Records"].should.have.length_of(len(keys)) partition_keys = [r["PartitionKey"] for r in response["Records"]] partition_keys.should.equal(keys) response["MillisBehindLatest"].should.equal(0) @mock_kinesis def test_get_records_timestamp_filtering(): conn = boto3.client("kinesis", region_name="us-west-2") stream_name = "my_stream" conn.create_stream(StreamName=stream_name, ShardCount=1) conn.put_record(StreamName=stream_name, Data="0", PartitionKey="0") time.sleep(1.0) timestamp = datetime.datetime.now(tz=tzlocal()) conn.put_record(StreamName=stream_name, Data="1", PartitionKey="1") response = conn.describe_stream(StreamName=stream_name) shard_id = response["StreamDescription"]["Shards"][0]["ShardId"] response = conn.get_shard_iterator( StreamName=stream_name, ShardId=shard_id, ShardIteratorType="AT_TIMESTAMP", Timestamp=timestamp, ) shard_iterator = response["ShardIterator"] response = conn.get_records(ShardIterator=shard_iterator) response["Records"].should.have.length_of(1) response["Records"][0]["PartitionKey"].should.equal("1") response["Records"][0]["ApproximateArrivalTimestamp"].should.be.greater_than( timestamp ) response["MillisBehindLatest"].should.equal(0) @mock_kinesis def test_get_records_millis_behind_latest(): conn = boto3.client("kinesis", region_name="us-west-2") stream_name = "my_stream" conn.create_stream(StreamName=stream_name, ShardCount=1) conn.put_record(StreamName=stream_name, Data="0", PartitionKey="0") time.sleep(1.0) conn.put_record(StreamName=stream_name, Data="1", PartitionKey="1") response = conn.describe_stream(StreamName=stream_name) shard_id = response["StreamDescription"]["Shards"][0]["ShardId"] response = conn.get_shard_iterator( StreamName=stream_name, ShardId=shard_id, ShardIteratorType="TRIM_HORIZON" ) shard_iterator = response["ShardIterator"] response = conn.get_records(ShardIterator=shard_iterator, Limit=1) response["Records"].should.have.length_of(1) response["MillisBehindLatest"].should.be.greater_than(0) @mock_kinesis def test_get_records_at_very_new_timestamp(): conn = boto3.client("kinesis", region_name="us-west-2") stream_name = "my_stream" conn.create_stream(StreamName=stream_name, ShardCount=1) # Create some data keys = [str(i) for i in range(1, 5)] for k in keys: conn.put_record(StreamName=stream_name, Data=k, PartitionKey=k) timestamp = datetime.datetime.utcnow() + datetime.timedelta(seconds=1) # Get a shard iterator response = conn.describe_stream(StreamName=stream_name) shard_id = response["StreamDescription"]["Shards"][0]["ShardId"] response = conn.get_shard_iterator( StreamName=stream_name, ShardId=shard_id, ShardIteratorType="AT_TIMESTAMP", Timestamp=timestamp, ) shard_iterator = response["ShardIterator"] response = conn.get_records(ShardIterator=shard_iterator) response["Records"].should.have.length_of(0) response["MillisBehindLatest"].should.equal(0) @mock_kinesis def test_get_records_from_empty_stream_at_timestamp(): conn = boto3.client("kinesis", region_name="us-west-2") stream_name = "my_stream" conn.create_stream(StreamName=stream_name, ShardCount=1) timestamp = datetime.datetime.utcnow() # Get a shard iterator response = conn.describe_stream(StreamName=stream_name) shard_id = response["StreamDescription"]["Shards"][0]["ShardId"] response = conn.get_shard_iterator( StreamName=stream_name, ShardId=shard_id, ShardIteratorType="AT_TIMESTAMP", Timestamp=timestamp, ) shard_iterator = response["ShardIterator"] response = conn.get_records(ShardIterator=shard_iterator) response["Records"].should.have.length_of(0) response["MillisBehindLatest"].should.equal(0) @mock_kinesis def test_valid_increase_stream_retention_period(): conn = boto3.client("kinesis", region_name="us-west-2") stream_name = "my_stream" conn.create_stream(StreamName=stream_name, ShardCount=1) conn.increase_stream_retention_period( StreamName=stream_name, RetentionPeriodHours=40 ) response = conn.describe_stream(StreamName=stream_name) response["StreamDescription"]["RetentionPeriodHours"].should.equal(40) @mock_kinesis def test_invalid_increase_stream_retention_period(): conn = boto3.client("kinesis", region_name="us-west-2") stream_name = "my_stream" conn.create_stream(StreamName=stream_name, ShardCount=1) conn.increase_stream_retention_period( StreamName=stream_name, RetentionPeriodHours=30 ) with pytest.raises(ClientError) as ex: conn.increase_stream_retention_period( StreamName=stream_name, RetentionPeriodHours=25 ) ex.value.response["Error"]["Code"].should.equal("InvalidArgumentException") ex.value.response["Error"]["Message"].should.equal( "Requested retention period (25 hours) for stream my_stream can not be shorter than existing retention period (30 hours). Use DecreaseRetentionPeriod API." ) @mock_kinesis def test_invalid_increase_stream_retention_too_low(): conn = boto3.client("kinesis", region_name="us-west-2") stream_name = "my_stream" conn.create_stream(StreamName=stream_name, ShardCount=1) with pytest.raises(ClientError) as ex: conn.increase_stream_retention_period( StreamName=stream_name, RetentionPeriodHours=20 ) err = ex.value.response["Error"] err["Code"].should.equal("InvalidArgumentException") err["Message"].should.equal( "Minimum allowed retention period is 24 hours. Requested retention period (20 hours) is too short." ) @mock_kinesis def test_invalid_increase_stream_retention_too_high(): conn = boto3.client("kinesis", region_name="us-west-2") stream_name = "my_stream" conn.create_stream(StreamName=stream_name, ShardCount=1) with pytest.raises(ClientError) as ex: conn.increase_stream_retention_period( StreamName=stream_name, RetentionPeriodHours=9999 ) err = ex.value.response["Error"] err["Code"].should.equal("InvalidArgumentException") err["Message"].should.equal( "Maximum allowed retention period is 8760 hours. Requested retention period (9999 hours) is too long." ) @mock_kinesis def test_valid_decrease_stream_retention_period(): conn = boto3.client("kinesis", region_name="us-west-2") stream_name = "decrease_stream" conn.create_stream(StreamName=stream_name, ShardCount=1) conn.increase_stream_retention_period( StreamName=stream_name, RetentionPeriodHours=30 ) conn.decrease_stream_retention_period( StreamName=stream_name, RetentionPeriodHours=25 ) response = conn.describe_stream(StreamName=stream_name) response["StreamDescription"]["RetentionPeriodHours"].should.equal(25) @mock_kinesis def test_decrease_stream_retention_period_upwards(): conn = boto3.client("kinesis", region_name="us-west-2") stream_name = "decrease_stream" conn.create_stream(StreamName=stream_name, ShardCount=1) with pytest.raises(ClientError) as ex: conn.decrease_stream_retention_period( StreamName=stream_name, RetentionPeriodHours=40 ) err = ex.value.response["Error"] err["Code"].should.equal("InvalidArgumentException") err["Message"].should.equal( "Requested retention period (40 hours) for stream decrease_stream can not be longer than existing retention period (24 hours). Use IncreaseRetentionPeriod API." ) @mock_kinesis def test_decrease_stream_retention_period_too_low(): conn = boto3.client("kinesis", region_name="us-west-2") stream_name = "decrease_stream" conn.create_stream(StreamName=stream_name, ShardCount=1) with pytest.raises(ClientError) as ex: conn.decrease_stream_retention_period( StreamName=stream_name, RetentionPeriodHours=4 ) err = ex.value.response["Error"] err["Code"].should.equal("InvalidArgumentException") err["Message"].should.equal( "Minimum allowed retention period is 24 hours. Requested retention period (4 hours) is too short." ) @mock_kinesis def test_decrease_stream_retention_period_too_high(): conn = boto3.client("kinesis", region_name="us-west-2") stream_name = "decrease_stream" conn.create_stream(StreamName=stream_name, ShardCount=1) with pytest.raises(ClientError) as ex: conn.decrease_stream_retention_period( StreamName=stream_name, RetentionPeriodHours=9999 ) err = ex.value.response["Error"] err["Code"].should.equal("InvalidArgumentException") err["Message"].should.equal( "Maximum allowed retention period is 8760 hours. Requested retention period (9999 hours) is too long." ) @mock_kinesis def test_invalid_shard_iterator_type_boto3(): client = boto3.client("kinesis", region_name="eu-west-2") stream_name = "my_stream_summary" client.create_stream(StreamName=stream_name, ShardCount=1) stream = client.describe_stream(StreamName=stream_name)["StreamDescription"] shard_id = stream["Shards"][0]["ShardId"] with pytest.raises(ClientError) as exc: client.get_shard_iterator( StreamName=stream_name, ShardId=shard_id, ShardIteratorType="invalid-type" ) err = exc.value.response["Error"] err["Code"].should.equal("InvalidArgumentException") err["Message"].should.equal("Invalid ShardIteratorType: invalid-type") @mock_kinesis def test_add_list_remove_tags_boto3(): client = boto3.client("kinesis", region_name="eu-west-2") stream_name = "my_stream_summary" client.create_stream(StreamName=stream_name, ShardCount=1) client.add_tags_to_stream( StreamName=stream_name, Tags={"tag1": "val1", "tag2": "val2", "tag3": "val3", "tag4": "val4"}, ) tags = client.list_tags_for_stream(StreamName=stream_name)["Tags"] tags.should.have.length_of(4) tags.should.contain({"Key": "tag1", "Value": "val1"}) tags.should.contain({"Key": "tag2", "Value": "val2"}) tags.should.contain({"Key": "tag3", "Value": "val3"}) tags.should.contain({"Key": "tag4", "Value": "val4"}) client.add_tags_to_stream(StreamName=stream_name, Tags={"tag5": "val5"}) tags = client.list_tags_for_stream(StreamName=stream_name)["Tags"] tags.should.have.length_of(5) tags.should.contain({"Key": "tag5", "Value": "val5"}) client.remove_tags_from_stream(StreamName=stream_name, TagKeys=["tag2", "tag3"]) tags = client.list_tags_for_stream(StreamName=stream_name)["Tags"] tags.should.have.length_of(3) tags.should.contain({"Key": "tag1", "Value": "val1"}) tags.should.contain({"Key": "tag4", "Value": "val4"}) tags.should.contain({"Key": "tag5", "Value": "val5"}) @mock_kinesis def test_merge_shards_boto3(): client = boto3.client("kinesis", region_name="eu-west-2") stream_name = "my_stream_summary" client.create_stream(StreamName=stream_name, ShardCount=4) for index in range(1, 100): client.put_record( StreamName=stream_name, Data=f"data_{index}".encode("utf-8"), PartitionKey=str(index), ) stream = client.describe_stream(StreamName=stream_name)["StreamDescription"] shards = stream["Shards"] shards.should.have.length_of(4) client.merge_shards( StreamName=stream_name, ShardToMerge="shardId-000000000000", AdjacentShardToMerge="shardId-000000000001", ) stream = client.describe_stream(StreamName=stream_name)["StreamDescription"] shards = stream["Shards"] # Old shards still exist, but are closed. A new shard is created out of the old one shards.should.have.length_of(5) # Only three shards are active - the two merged shards are closed active_shards = [ shard for shard in shards if "EndingSequenceNumber" not in shard["SequenceNumberRange"] ] active_shards.should.have.length_of(3) client.merge_shards( StreamName=stream_name, ShardToMerge="shardId-000000000004", AdjacentShardToMerge="shardId-000000000002", ) stream = client.describe_stream(StreamName=stream_name)["StreamDescription"] shards = stream["Shards"] active_shards = [ shard for shard in shards if "EndingSequenceNumber" not in shard["SequenceNumberRange"] ] active_shards.should.have.length_of(2) for shard in active_shards: del shard["HashKeyRange"] del shard["SequenceNumberRange"] # Original shard #3 is still active (0,1,2 have been merged and closed active_shards.should.contain({"ShardId": "shardId-000000000003"}) # Shard #4 was the child of #0 and #1 # Shard #5 is the child of #4 (parent) and #2 (adjacent-parent) active_shards.should.contain( { "ShardId": "shardId-000000000005", "ParentShardId": "shardId-000000000004", "AdjacentParentShardId": "shardId-000000000002", } ) @mock_kinesis def test_merge_shards_invalid_arg(): client = boto3.client("kinesis", region_name="eu-west-2") stream_name = "my_stream_summary" client.create_stream(StreamName=stream_name, ShardCount=4) with pytest.raises(ClientError) as exc: client.merge_shards( StreamName=stream_name, ShardToMerge="shardId-000000000000", AdjacentShardToMerge="shardId-000000000002", ) err = exc.value.response["Error"] err["Code"].should.equal("InvalidArgumentException") err["Message"].should.equal("shardId-000000000002")