aws-sdk-kinesis 1.37.0 → 1.38.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: c91723142b5af71d83df6b4288b60b2bcadfe073e677da98744840646112c784
4
- data.tar.gz: 5674b5b158b109a117c54703a6c155374af924b96067050835705bae4d19059a
3
+ metadata.gz: eac4d4cecdba7a2a01bf4c7eaa8fdb618c1241b2095425c14fdee808a03f06d8
4
+ data.tar.gz: 6140ade32140e09d1e732a489dcb41642cbb4dda3b4831260d7c3ca173c304ae
5
5
  SHA512:
6
- metadata.gz: fd7d84fa7efd2a309a770b3e3b5457752d927d1b00c9c1806b0c0833e42d2fe685352de892a808b14779fa5aecfdf30206b64bef423e46dd408cd3fdaf3027a7
7
- data.tar.gz: e33320e8c8f0ede9cde9b6abe0f42101bf60add9fd851cb6ec82c7bcacc126bdf65d54285eaba4b51583dac8077438a42217354f64dbc6d1178e6dd83da14d4d
6
+ metadata.gz: 9c54f5ba41fd45fccf416c1654397e3fc48a84c33973b5f36f2047968c4478518701f76fedbaea75ace5fb4c44f71897587d48585ff932b08070c7674943e93c
7
+ data.tar.gz: 6feebd9c5ebc17f96ddb23398534b9128359c25bd7290c7940252e0acea54418badb2e469121eecfcf06f6c6a529377bc00e10924539888db517c8a8c3e804c2
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.38.0 (2021-11-30)
5
+ ------------------
6
+
7
+ * Feature - Amazon Kinesis Data Streams now supports on demand streams.
8
+
4
9
  1.37.0 (2021-11-04)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.37.0
1
+ 1.38.0
@@ -98,7 +98,9 @@ module Aws::Kinesis
98
98
  # * EC2/ECS IMDS instance profile - When used by default, the timeouts
99
99
  # are very aggressive. Construct and pass an instance of
100
100
  # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
101
- # enable retries and extended timeouts.
101
+ # enable retries and extended timeouts. Instance profile credential
102
+ # fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
103
+ # to true.
102
104
  #
103
105
  # @option options [required, String] :region
104
106
  # The AWS region to connect to. The configured `:region` is
@@ -276,8 +278,9 @@ module Aws::Kinesis
276
278
  # If you call `SubscribeToShard` again with the same `ConsumerARN` and
277
279
  # `ShardId` within 5 seconds of a successful call, you'll get a
278
280
  # `ResourceInUseException`. If you call `SubscribeToShard` 5 seconds or
279
- # more after a successful call, the first connection will expire and the
280
- # second call will take over the subscription.
281
+ # more after a successful call, the second call takes over the
282
+ # subscription and the previous connection expires or fails with a
283
+ # `ResourceInUseException`.
281
284
  #
282
285
  # For an example of how to use this operations, see [Enhanced Fan-Out
283
286
  # Using the Kinesis Data Streams
@@ -292,6 +295,8 @@ module Aws::Kinesis
292
295
  # shards for a given stream, use ListShards.
293
296
  #
294
297
  # @option params [required, Types::StartingPosition] :starting_position
298
+ # The starting position in the data stream from which to start
299
+ # streaming.
295
300
  #
296
301
  # @return [Types::SubscribeToShardOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
297
302
  #
@@ -563,7 +568,7 @@ module Aws::Kinesis
563
568
  http_response: Seahorse::Client::Http::AsyncResponse.new,
564
569
  config: config)
565
570
  context[:gem_name] = 'aws-sdk-kinesis'
566
- context[:gem_version] = '1.37.0'
571
+ context[:gem_version] = '1.38.0'
567
572
  Seahorse::Client::Request.new(handlers, context)
568
573
  end
569
574
 
@@ -121,7 +121,9 @@ module Aws::Kinesis
121
121
  # * EC2/ECS IMDS instance profile - When used by default, the timeouts
122
122
  # are very aggressive. Construct and pass an instance of
123
123
  # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
124
- # enable retries and extended timeouts.
124
+ # enable retries and extended timeouts. Instance profile credential
125
+ # fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
126
+ # to true.
125
127
  #
126
128
  # @option options [required, String] :region
127
129
  # The AWS region to connect to. The configured `:region` is
@@ -357,10 +359,8 @@ module Aws::Kinesis
357
359
 
358
360
  # @!group API Operations
359
361
 
360
- # Adds or updates tags for the specified Kinesis data stream. Each time
361
- # you invoke this operation, you can specify up to 10 tags. If you want
362
- # to add more than 10 tags to your stream, you can invoke this operation
363
- # multiple times. In total, each stream can have up to 50 tags.
362
+ # Adds or updates tags for the specified Kinesis data stream. You can
363
+ # assign up to 50 tags to a data stream.
364
364
  #
365
365
  # If tags have already been assigned to the stream, `AddTagsToStream`
366
366
  # overwrites any existing tags that correspond to the specified tag
@@ -408,11 +408,11 @@ module Aws::Kinesis
408
408
  # write total of 1 MiB per second. If the amount of data input increases
409
409
  # or decreases, you can add or remove shards.
410
410
  #
411
- # The stream name identifies the stream. The name is scoped to the AWS
412
- # account used by the application. It is also scoped by AWS Region. That
413
- # is, two streams in two different accounts can have the same name, and
414
- # two streams in the same account, but in two different Regions, can
415
- # have the same name.
411
+ # The stream name identifies the stream. The name is scoped to the
412
+ # Amazon Web Services account used by the application. It is also scoped
413
+ # by Amazon Web Services Region. That is, two streams in two different
414
+ # accounts can have the same name, and two streams in the same account,
415
+ # but in two different Regions, can have the same name.
416
416
  #
417
417
  # `CreateStream` is an asynchronous operation. Upon receiving a
418
418
  # `CreateStream` request, Kinesis Data Streams immediately returns and
@@ -428,11 +428,12 @@ module Aws::Kinesis
428
428
  #
429
429
  # * Create more shards than are authorized for your account.
430
430
  #
431
- # For the default shard limit for an AWS account, see [Amazon Kinesis
432
- # Data Streams Limits][1] in the *Amazon Kinesis Data Streams Developer
433
- # Guide*. To increase this limit, [contact AWS Support][2].
431
+ # For the default shard limit for an Amazon Web Services account, see
432
+ # [Amazon Kinesis Data Streams Limits][1] in the *Amazon Kinesis Data
433
+ # Streams Developer Guide*. To increase this limit, [contact Amazon Web
434
+ # Services Support][2].
434
435
  #
435
- # You can use `DescribeStream` to check the stream status, which is
436
+ # You can use DescribeStreamSummary to check the stream status, which is
436
437
  # returned in `StreamStatus`.
437
438
  #
438
439
  # CreateStream has a limit of five transactions per second per account.
@@ -443,24 +444,33 @@ module Aws::Kinesis
443
444
  # [2]: https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html
444
445
  #
445
446
  # @option params [required, String] :stream_name
446
- # A name to identify the stream. The stream name is scoped to the AWS
447
- # account used by the application that creates the stream. It is also
448
- # scoped by AWS Region. That is, two streams in two different AWS
449
- # accounts can have the same name. Two streams in the same AWS account
450
- # but in two different Regions can also have the same name.
451
- #
452
- # @option params [required, Integer] :shard_count
447
+ # A name to identify the stream. The stream name is scoped to the Amazon
448
+ # Web Services account used by the application that creates the stream.
449
+ # It is also scoped by Amazon Web Services Region. That is, two streams
450
+ # in two different Amazon Web Services accounts can have the same name.
451
+ # Two streams in the same Amazon Web Services account but in two
452
+ # different Regions can also have the same name.
453
+ #
454
+ # @option params [Integer] :shard_count
453
455
  # The number of shards that the stream will use. The throughput of the
454
456
  # stream is a function of the number of shards; more shards are required
455
457
  # for greater provisioned throughput.
456
458
  #
459
+ # @option params [Types::StreamModeDetails] :stream_mode_details
460
+ # Indicates the capacity mode of the data stream. Currently, in Kinesis
461
+ # Data Streams, you can choose between an **on-demand** capacity mode
462
+ # and a **provisioned** capacity mode for your data streams.
463
+ #
457
464
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
458
465
  #
459
466
  # @example Request syntax with placeholder values
460
467
  #
461
468
  # resp = client.create_stream({
462
469
  # stream_name: "StreamName", # required
463
- # shard_count: 1, # required
470
+ # shard_count: 1,
471
+ # stream_mode_details: {
472
+ # stream_mode: "PROVISIONED", # required, accepts PROVISIONED, ON_DEMAND
473
+ # },
464
474
  # })
465
475
  #
466
476
  # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02/CreateStream AWS API Documentation
@@ -521,8 +531,8 @@ module Aws::Kinesis
521
531
  # When you delete a stream, any shards in that stream are also deleted,
522
532
  # and any tags are dissociated from the stream.
523
533
  #
524
- # You can use the DescribeStream operation to check the state of the
525
- # stream, which is returned in `StreamStatus`.
534
+ # You can use the DescribeStreamSummary operation to check the state of
535
+ # the stream, which is returned in `StreamStatus`.
526
536
  #
527
537
  # DeleteStream has a limit of five transactions per second per account.
528
538
  #
@@ -565,8 +575,8 @@ module Aws::Kinesis
565
575
  #
566
576
  # @option params [String] :stream_arn
567
577
  # The ARN of the Kinesis data stream that the consumer is registered
568
- # with. For more information, see [Amazon Resource Names (ARNs) and AWS
569
- # Service Namespaces][1].
578
+ # with. For more information, see [Amazon Resource Names (ARNs) and
579
+ # Amazon Web Services Service Namespaces][1].
570
580
  #
571
581
  #
572
582
  #
@@ -613,11 +623,15 @@ module Aws::Kinesis
613
623
  #
614
624
  # * {Types::DescribeLimitsOutput#shard_limit #shard_limit} => Integer
615
625
  # * {Types::DescribeLimitsOutput#open_shard_count #open_shard_count} => Integer
626
+ # * {Types::DescribeLimitsOutput#on_demand_stream_count #on_demand_stream_count} => Integer
627
+ # * {Types::DescribeLimitsOutput#on_demand_stream_count_limit #on_demand_stream_count_limit} => Integer
616
628
  #
617
629
  # @example Response structure
618
630
  #
619
631
  # resp.shard_limit #=> Integer
620
632
  # resp.open_shard_count #=> Integer
633
+ # resp.on_demand_stream_count #=> Integer
634
+ # resp.on_demand_stream_count_limit #=> Integer
621
635
  #
622
636
  # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02/DescribeLimits AWS API Documentation
623
637
  #
@@ -630,6 +644,14 @@ module Aws::Kinesis
630
644
 
631
645
  # Describes the specified Kinesis data stream.
632
646
  #
647
+ # <note markdown="1"> This API has been revised. It's highly recommended that you use the
648
+ # DescribeStreamSummary API to get a summarized description of the
649
+ # specified Kinesis data stream and the ListShards API to list the
650
+ # shards in a specified data stream and obtain information about each
651
+ # shard.
652
+ #
653
+ # </note>
654
+ #
633
655
  # The information returned includes the stream name, Amazon Resource
634
656
  # Name (ARN), creation time, enhanced metric configuration, and shard
635
657
  # map. The shard map is an array of shard objects. For each shard
@@ -659,11 +681,19 @@ module Aws::Kinesis
659
681
  # @option params [Integer] :limit
660
682
  # The maximum number of shards to return in a single call. The default
661
683
  # value is 100. If you specify a value greater than 100, at most 100
662
- # shards are returned.
684
+ # results are returned.
663
685
  #
664
686
  # @option params [String] :exclusive_start_shard_id
665
687
  # The shard ID of the shard to start with.
666
688
  #
689
+ # Specify this parameter to indicate that you want to describe the
690
+ # stream starting with the shard whose ID immediately follows
691
+ # `ExclusiveStartShardId`.
692
+ #
693
+ # If you don't specify this parameter, the default behavior for
694
+ # `DescribeStream` is to describe the stream starting with the first
695
+ # shard in the stream.
696
+ #
667
697
  # @return [Types::DescribeStreamOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
668
698
  #
669
699
  # * {Types::DescribeStreamOutput#stream_description #stream_description} => Types::StreamDescription
@@ -683,6 +713,7 @@ module Aws::Kinesis
683
713
  # resp.stream_description.stream_name #=> String
684
714
  # resp.stream_description.stream_arn #=> String
685
715
  # resp.stream_description.stream_status #=> String, one of "CREATING", "DELETING", "ACTIVE", "UPDATING"
716
+ # resp.stream_description.stream_mode_details.stream_mode #=> String, one of "PROVISIONED", "ON_DEMAND"
686
717
  # resp.stream_description.shards #=> Array
687
718
  # resp.stream_description.shards[0].shard_id #=> String
688
719
  # resp.stream_description.shards[0].parent_shard_id #=> String
@@ -728,8 +759,8 @@ module Aws::Kinesis
728
759
  #
729
760
  # @option params [String] :stream_arn
730
761
  # The ARN of the Kinesis data stream that the consumer is registered
731
- # with. For more information, see [Amazon Resource Names (ARNs) and AWS
732
- # Service Namespaces][1].
762
+ # with. For more information, see [Amazon Resource Names (ARNs) and
763
+ # Amazon Web Services Service Namespaces][1].
733
764
  #
734
765
  #
735
766
  #
@@ -799,6 +830,7 @@ module Aws::Kinesis
799
830
  # resp.stream_description_summary.stream_name #=> String
800
831
  # resp.stream_description_summary.stream_arn #=> String
801
832
  # resp.stream_description_summary.stream_status #=> String, one of "CREATING", "DELETING", "ACTIVE", "UPDATING"
833
+ # resp.stream_description_summary.stream_mode_details.stream_mode #=> String, one of "PROVISIONED", "ON_DEMAND"
802
834
  # resp.stream_description_summary.retention_period_hours #=> Integer
803
835
  # resp.stream_description_summary.stream_creation_timestamp #=> Time
804
836
  # resp.stream_description_summary.enhanced_monitoring #=> Array
@@ -982,9 +1014,12 @@ module Aws::Kinesis
982
1014
  # The maximum number of records that can be returned per call is 10,000.
983
1015
  #
984
1016
  # The size of the data returned by GetRecords varies depending on the
985
- # utilization of the shard. The maximum size of data that GetRecords can
986
- # return is 10 MiB. If a call returns this amount of data, subsequent
987
- # calls made within the next 5 seconds throw
1017
+ # utilization of the shard. It is recommended that consumer applications
1018
+ # retrieve records via the `GetRecords` command using the 5 TPS limit to
1019
+ # remain caught up. Retrieving records less frequently can lead to
1020
+ # consumer applications falling behind. The maximum size of data that
1021
+ # GetRecords can return is 10 MiB. If a call returns this amount of
1022
+ # data, subsequent calls made within the next 5 seconds throw
988
1023
  # `ProvisionedThroughputExceededException`. If there is insufficient
989
1024
  # provisioned throughput on the stream, subsequent calls made within the
990
1025
  # next 1 second throw `ProvisionedThroughputExceededException`.
@@ -1187,8 +1222,8 @@ module Aws::Kinesis
1187
1222
 
1188
1223
  # Increases the Kinesis data stream's retention period, which is the
1189
1224
  # length of time data records are accessible after they are added to the
1190
- # stream. The maximum value of a stream's retention period is 168 hours
1191
- # (7 days).
1225
+ # stream. The maximum value of a stream's retention period is 8760
1226
+ # hours (365 days).
1192
1227
  #
1193
1228
  # If you choose a longer stream retention period, this operation
1194
1229
  # increases the time period during which records that have not yet
@@ -1225,18 +1260,23 @@ module Aws::Kinesis
1225
1260
  end
1226
1261
 
1227
1262
  # Lists the shards in a stream and provides information about each
1228
- # shard. This operation has a limit of 100 transactions per second per
1263
+ # shard. This operation has a limit of 1000 transactions per second per
1229
1264
  # data stream.
1230
1265
  #
1266
+ # This action does not list expired shards. For information about
1267
+ # expired shards, see [Data Routing, Data Persistence, and Shard State
1268
+ # after a Reshard][1].
1269
+ #
1231
1270
  # This API is a new operation that is used by the Amazon Kinesis Client
1232
1271
  # Library (KCL). If you have a fine-grained IAM policy that only allows
1233
1272
  # specific operations, you must update your policy to allow calls to
1234
1273
  # this API. For more information, see [Controlling Access to Amazon
1235
- # Kinesis Data Streams Resources Using IAM][1].
1274
+ # Kinesis Data Streams Resources Using IAM][2].
1236
1275
  #
1237
1276
  #
1238
1277
  #
1239
- # [1]: https://docs.aws.amazon.com/streams/latest/dev/controlling-access.html
1278
+ # [1]: https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-after-resharding.html#kinesis-using-sdk-java-resharding-data-routing
1279
+ # [2]: https://docs.aws.amazon.com/streams/latest/dev/controlling-access.html
1240
1280
  #
1241
1281
  # @option params [String] :stream_name
1242
1282
  # The name of the data stream whose shards you want to list.
@@ -1281,8 +1321,9 @@ module Aws::Kinesis
1281
1321
  #
1282
1322
  # @option params [Integer] :max_results
1283
1323
  # The maximum number of shards to return in a single call to
1284
- # `ListShards`. The minimum value you can specify for this parameter is
1285
- # 1, and the maximum is 10,000, which is also the default.
1324
+ # `ListShards`. The maximum number of shards to return in a single call.
1325
+ # The default value is 1000. If you specify a value greater than 1000,
1326
+ # at most 1000 results are returned.
1286
1327
  #
1287
1328
  # When the number of shards to be listed is greater than the value of
1288
1329
  # `MaxResults`, the response contains a `NextToken` value that you can
@@ -1300,6 +1341,28 @@ module Aws::Kinesis
1300
1341
  # parameter.
1301
1342
  #
1302
1343
  # @option params [Types::ShardFilter] :shard_filter
1344
+ # Enables you to filter out the response of the `ListShards` API. You
1345
+ # can only specify one filter at a time.
1346
+ #
1347
+ # If you use the `ShardFilter` parameter when invoking the ListShards
1348
+ # API, the `Type` is the required property and must be specified. If you
1349
+ # specify the `AT_TRIM_HORIZON`, `FROM_TRIM_HORIZON`, or `AT_LATEST`
1350
+ # types, you do not need to specify either the `ShardId` or the
1351
+ # `Timestamp` optional properties.
1352
+ #
1353
+ # If you specify the `AFTER_SHARD_ID` type, you must also provide the
1354
+ # value for the optional `ShardId` property. The `ShardId` property is
1355
+ # identical in fuctionality to the `ExclusiveStartShardId` parameter of
1356
+ # the `ListShards` API. When `ShardId` property is specified, the
1357
+ # response includes the shards starting with the shard whose ID
1358
+ # immediately follows the `ShardId` that you provided.
1359
+ #
1360
+ # If you specify the `AT_TIMESTAMP` or `FROM_TIMESTAMP_ID` type, you
1361
+ # must also provide the value for the optional `Timestamp` property. If
1362
+ # you specify the AT\_TIMESTAMP type, then all shards that were open at
1363
+ # the provided timestamp are returned. If you specify the
1364
+ # FROM\_TIMESTAMP type, then all shards starting from the provided
1365
+ # timestamp to TIP are returned.
1303
1366
  #
1304
1367
  # @return [Types::ListShardsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1305
1368
  #
@@ -1350,7 +1413,7 @@ module Aws::Kinesis
1350
1413
  # @option params [required, String] :stream_arn
1351
1414
  # The ARN of the Kinesis data stream for which you want to list the
1352
1415
  # registered consumers. For more information, see [Amazon Resource Names
1353
- # (ARNs) and AWS Service Namespaces][1].
1416
+ # (ARNs) and Amazon Web Services Service Namespaces][1].
1354
1417
  #
1355
1418
  #
1356
1419
  #
@@ -1384,7 +1447,8 @@ module Aws::Kinesis
1384
1447
  #
1385
1448
  # @option params [Integer] :max_results
1386
1449
  # The maximum number of consumers that you want a single call of
1387
- # `ListStreamConsumers` to return.
1450
+ # `ListStreamConsumers` to return. The default value is 100. If you
1451
+ # specify a value greater than 100, at most 100 results are returned.
1388
1452
  #
1389
1453
  # @option params [Time,DateTime,Date,Integer,String] :stream_creation_timestamp
1390
1454
  # Specify this input parameter to distinguish data streams that have the
@@ -1436,7 +1500,7 @@ module Aws::Kinesis
1436
1500
  # `ListStreams`. You can limit the number of returned streams using the
1437
1501
  # `Limit` parameter. If you do not specify a value for the `Limit`
1438
1502
  # parameter, Kinesis Data Streams uses the default limit, which is
1439
- # currently 10.
1503
+ # currently 100.
1440
1504
  #
1441
1505
  # You can detect if there are more streams available to list by using
1442
1506
  # the `HasMoreStreams` flag from the returned output. If there are more
@@ -1450,7 +1514,9 @@ module Aws::Kinesis
1450
1514
  # ListStreams has a limit of five transactions per second per account.
1451
1515
  #
1452
1516
  # @option params [Integer] :limit
1453
- # The maximum number of streams to list.
1517
+ # The maximum number of streams to list. The default value is 100. If
1518
+ # you specify a value greater than 100, at most 100 results are
1519
+ # returned.
1454
1520
  #
1455
1521
  # @option params [String] :exclusive_start_stream_name
1456
1522
  # The name of the stream to start the list with.
@@ -1553,8 +1619,8 @@ module Aws::Kinesis
1553
1619
  # stream does not exist, `MergeShards` returns a
1554
1620
  # `ResourceNotFoundException`.
1555
1621
  #
1556
- # You can use DescribeStream to check the state of the stream, which is
1557
- # returned in `StreamStatus`.
1622
+ # You can use DescribeStreamSummary to check the state of the stream,
1623
+ # which is returned in `StreamStatus`.
1558
1624
  #
1559
1625
  # `MergeShards` is an asynchronous operation. Upon receiving a
1560
1626
  # `MergeShards` request, Amazon Kinesis Data Streams immediately returns
@@ -1563,8 +1629,8 @@ module Aws::Kinesis
1563
1629
  # to `ACTIVE`. Read and write operations continue to work while the
1564
1630
  # stream is in the `UPDATING` state.
1565
1631
  #
1566
- # You use DescribeStream to determine the shard IDs that are specified
1567
- # in the `MergeShards` request.
1632
+ # You use DescribeStreamSummary and the ListShards APIs to determine the
1633
+ # shard IDs that are specified in the `MergeShards` request.
1568
1634
  #
1569
1635
  # If you try to operate on too many streams in parallel using
1570
1636
  # CreateStream, DeleteStream, `MergeShards`, or SplitShard, you receive
@@ -1870,7 +1936,7 @@ module Aws::Kinesis
1870
1936
  # @option params [required, String] :stream_arn
1871
1937
  # The ARN of the Kinesis data stream that you want to register the
1872
1938
  # consumer with. For more info, see [Amazon Resource Names (ARNs) and
1873
- # AWS Service Namespaces][1].
1939
+ # Amazon Web Services Service Namespaces][1].
1874
1940
  #
1875
1941
  #
1876
1942
  #
@@ -1961,9 +2027,10 @@ module Aws::Kinesis
1961
2027
  # mapped into the shard. For more information, see [Split a Shard][1] in
1962
2028
  # the *Amazon Kinesis Data Streams Developer Guide*.
1963
2029
  #
1964
- # You can use DescribeStream to determine the shard ID and hash key
1965
- # values for the `ShardToSplit` and `NewStartingHashKey` parameters that
1966
- # are specified in the `SplitShard` request.
2030
+ # You can use DescribeStreamSummary and the ListShards APIs to determine
2031
+ # the shard ID and hash key values for the `ShardToSplit` and
2032
+ # `NewStartingHashKey` parameters that are specified in the `SplitShard`
2033
+ # request.
1967
2034
  #
1968
2035
  # `SplitShard` is an asynchronous operation. Upon receiving a
1969
2036
  # `SplitShard` request, Kinesis Data Streams immediately returns a
@@ -1972,19 +2039,19 @@ module Aws::Kinesis
1972
2039
  # Read and write operations continue to work while the stream is in the
1973
2040
  # `UPDATING` state.
1974
2041
  #
1975
- # You can use `DescribeStream` to check the status of the stream, which
1976
- # is returned in `StreamStatus`. If the stream is in the `ACTIVE` state,
1977
- # you can call `SplitShard`. If a stream is in `CREATING` or `UPDATING`
1978
- # or `DELETING` states, `DescribeStream` returns a
1979
- # `ResourceInUseException`.
2042
+ # You can use DescribeStreamSummary to check the status of the stream,
2043
+ # which is returned in `StreamStatus`. If the stream is in the `ACTIVE`
2044
+ # state, you can call `SplitShard`.
1980
2045
  #
1981
- # If the specified stream does not exist, `DescribeStream` returns a
1982
- # `ResourceNotFoundException`. If you try to create more shards than are
1983
- # authorized for your account, you receive a `LimitExceededException`.
2046
+ # If the specified stream does not exist, DescribeStreamSummary returns
2047
+ # a `ResourceNotFoundException`. If you try to create more shards than
2048
+ # are authorized for your account, you receive a
2049
+ # `LimitExceededException`.
1984
2050
  #
1985
- # For the default shard limit for an AWS account, see [Kinesis Data
1986
- # Streams Limits][2] in the *Amazon Kinesis Data Streams Developer
1987
- # Guide*. To increase this limit, [contact AWS Support][3].
2051
+ # For the default shard limit for an Amazon Web Services account, see
2052
+ # [Kinesis Data Streams Limits][2] in the *Amazon Kinesis Data Streams
2053
+ # Developer Guide*. To increase this limit, [contact Amazon Web Services
2054
+ # Support][3].
1988
2055
  #
1989
2056
  # If you try to operate on too many streams simultaneously using
1990
2057
  # CreateStream, DeleteStream, MergeShards, and/or SplitShard, you
@@ -2033,8 +2100,8 @@ module Aws::Kinesis
2033
2100
  req.send_request(options)
2034
2101
  end
2035
2102
 
2036
- # Enables or updates server-side encryption using an AWS KMS key for a
2037
- # specified stream.
2103
+ # Enables or updates server-side encryption using an Amazon Web Services
2104
+ # KMS key for a specified stream.
2038
2105
  #
2039
2106
  # Starting encryption is an asynchronous operation. Upon receiving the
2040
2107
  # request, Kinesis Data Streams returns immediately and sets the status
@@ -2045,8 +2112,8 @@ module Aws::Kinesis
2045
2112
  # stream while its status is `UPDATING`. Once the status of the stream
2046
2113
  # is `ACTIVE`, encryption begins for records written to the stream.
2047
2114
  #
2048
- # API Limits: You can successfully apply a new AWS KMS key for
2049
- # server-side encryption 25 times in a rolling 24-hour period.
2115
+ # API Limits: You can successfully apply a new Amazon Web Services KMS
2116
+ # key for server-side encryption 25 times in a rolling 24-hour period.
2050
2117
  #
2051
2118
  # Note: It can take up to 5 seconds after the stream is in an `ACTIVE`
2052
2119
  # status before all records written to the stream are encrypted. After
@@ -2060,11 +2127,12 @@ module Aws::Kinesis
2060
2127
  # The encryption type to use. The only valid value is `KMS`.
2061
2128
  #
2062
2129
  # @option params [required, String] :key_id
2063
- # The GUID for the customer-managed AWS KMS key to use for encryption.
2064
- # This value can be a globally unique identifier, a fully specified
2065
- # Amazon Resource Name (ARN) to either an alias or a key, or an alias
2066
- # name prefixed by "alias/".You can also use a master key owned by
2067
- # Kinesis Data Streams by specifying the alias `aws/kinesis`.
2130
+ # The GUID for the customer-managed Amazon Web Services KMS key to use
2131
+ # for encryption. This value can be a globally unique identifier, a
2132
+ # fully specified Amazon Resource Name (ARN) to either an alias or a
2133
+ # key, or an alias name prefixed by "alias/".You can also use a master
2134
+ # key owned by Kinesis Data Streams by specifying the alias
2135
+ # `aws/kinesis`.
2068
2136
  #
2069
2137
  # * Key ARN example:
2070
2138
  # `arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012`
@@ -2126,11 +2194,12 @@ module Aws::Kinesis
2126
2194
  # The encryption type. The only valid value is `KMS`.
2127
2195
  #
2128
2196
  # @option params [required, String] :key_id
2129
- # The GUID for the customer-managed AWS KMS key to use for encryption.
2130
- # This value can be a globally unique identifier, a fully specified
2131
- # Amazon Resource Name (ARN) to either an alias or a key, or an alias
2132
- # name prefixed by "alias/".You can also use a master key owned by
2133
- # Kinesis Data Streams by specifying the alias `aws/kinesis`.
2197
+ # The GUID for the customer-managed Amazon Web Services KMS key to use
2198
+ # for encryption. This value can be a globally unique identifier, a
2199
+ # fully specified Amazon Resource Name (ARN) to either an alias or a
2200
+ # key, or an alias name prefixed by "alias/".You can also use a master
2201
+ # key owned by Kinesis Data Streams by specifying the alias
2202
+ # `aws/kinesis`.
2134
2203
  #
2135
2204
  # * Key ARN example:
2136
2205
  # `arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012`
@@ -2195,17 +2264,17 @@ module Aws::Kinesis
2195
2264
  #
2196
2265
  # * Scale down below half your current shard count for a stream
2197
2266
  #
2198
- # * Scale up to more than 500 shards in a stream
2267
+ # * Scale up to more than 10000 shards in a stream
2199
2268
  #
2200
- # * Scale a stream with more than 500 shards down unless the result is
2201
- # less than 500 shards
2269
+ # * Scale a stream with more than 10000 shards down unless the result is
2270
+ # less than 10000 shards
2202
2271
  #
2203
2272
  # * Scale up to more than the shard limit for your account
2204
2273
  #
2205
- # For the default limits for an AWS account, see [Streams Limits][1] in
2206
- # the *Amazon Kinesis Data Streams Developer Guide*. To request an
2207
- # increase in the call rate limit, the shard limit for this API, or your
2208
- # overall shard limit, use the [limits form][2].
2274
+ # For the default limits for an Amazon Web Services account, see
2275
+ # [Streams Limits][1] in the *Amazon Kinesis Data Streams Developer
2276
+ # Guide*. To request an increase in the call rate limit, the shard limit
2277
+ # for this API, or your overall shard limit, use the [limits form][2].
2209
2278
  #
2210
2279
  #
2211
2280
  #
@@ -2224,12 +2293,12 @@ module Aws::Kinesis
2224
2293
  #
2225
2294
  # * Set this value below half your current shard count for a stream.
2226
2295
  #
2227
- # * Set this value to more than 500 shards in a stream (the default
2228
- # limit for shard count per stream is 500 per account per region),
2296
+ # * Set this value to more than 10000 shards in a stream (the default
2297
+ # limit for shard count per stream is 10000 per account per region),
2229
2298
  # unless you request a limit increase.
2230
2299
  #
2231
- # * Scale a stream with more than 500 shards down unless you set this
2232
- # value to less than 500 shards.
2300
+ # * Scale a stream with more than 10000 shards down unless you set this
2301
+ # value to less than 10000 shards.
2233
2302
  #
2234
2303
  # @option params [required, String] :scaling_type
2235
2304
  # The scaling type. Uniform scaling creates shards of equal size.
@@ -2263,6 +2332,40 @@ module Aws::Kinesis
2263
2332
  req.send_request(options)
2264
2333
  end
2265
2334
 
2335
+ # Updates the capacity mode of the data stream. Currently, in Kinesis
2336
+ # Data Streams, you can choose between an **on-demand** capacity mode
2337
+ # and a **provisioned** capacity mode for your data stream.
2338
+ #
2339
+ # @option params [required, String] :stream_arn
2340
+ # Specifies the ARN of the data stream whose capacity mode you want to
2341
+ # update.
2342
+ #
2343
+ # @option params [required, Types::StreamModeDetails] :stream_mode_details
2344
+ # Specifies the capacity mode to which you want to set your data stream.
2345
+ # Currently, in Kinesis Data Streams, you can choose between an
2346
+ # **on-demand** capacity mode and a **provisioned** capacity mode for
2347
+ # your data streams.
2348
+ #
2349
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2350
+ #
2351
+ # @example Request syntax with placeholder values
2352
+ #
2353
+ # resp = client.update_stream_mode({
2354
+ # stream_arn: "StreamARN", # required
2355
+ # stream_mode_details: { # required
2356
+ # stream_mode: "PROVISIONED", # required, accepts PROVISIONED, ON_DEMAND
2357
+ # },
2358
+ # })
2359
+ #
2360
+ # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02/UpdateStreamMode AWS API Documentation
2361
+ #
2362
+ # @overload update_stream_mode(params = {})
2363
+ # @param [Hash] params ({})
2364
+ def update_stream_mode(params = {}, options = {})
2365
+ req = build_request(:update_stream_mode, params)
2366
+ req.send_request(options)
2367
+ end
2368
+
2266
2369
  # @!endgroup
2267
2370
 
2268
2371
  # @param params ({})
@@ -2276,7 +2379,7 @@ module Aws::Kinesis
2276
2379
  params: params,
2277
2380
  config: config)
2278
2381
  context[:gem_name] = 'aws-sdk-kinesis'
2279
- context[:gem_version] = '1.37.0'
2382
+ context[:gem_version] = '1.38.0'
2280
2383
  Seahorse::Client::Request.new(handlers, context)
2281
2384
  end
2282
2385