aws-sdk-kinesis 1.22.0 → 1.27.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: def11d9ea166ae0e3582f3e7eaf97a1efd74a4df29d2e36980a4cfea83a279b9
4
- data.tar.gz: 0ac31606c17612fb8ec70885a056293884234a205fadbb99df5fe122fe604948
3
+ metadata.gz: 402a2a96aba832c9e8b4df7f5619665770e471603260951ddcca0be5c4ecddad
4
+ data.tar.gz: dfa0a56f52c7e5ff3b8992c608b70bf2f0bbfe8e51bfd34ba5c6bcdfc4513734
5
5
  SHA512:
6
- metadata.gz: 9978c6457020e7b7e5a4a5d3eecef9df071e4abaf28885725ea0ce0d39caf25583bfbb57de8d8728099da4ac53b82f2dc9e006020444c15b993eb5ffc514c9d2
7
- data.tar.gz: ac4ba901bfa03e78ceaeffda9a1381ebd73b4b86b37e69abd8a14ab0862854c0c102412ecee904f4c240edf0901f16327fd2f08d228e43359aea261fedf96006
6
+ metadata.gz: fc909f9743f05544980d2ec71883265543b26e28c9cbf0ed0e6d2930f1734ee3f44f3063f808c550f4f99add4c7872f06c2b363d7357d629c48de220fcb28506
7
+ data.tar.gz: c7da65816c05722c6d6d25234cdc67df1f4f03075cfc17622c35378a493baf4c065103da2b62244fa9a99c6825bab0fa8a9fc51a908be32616b52507c97d72c6
@@ -1,3 +1,5 @@
1
+ # frozen_string_literal: true
2
+
1
3
  # WARNING ABOUT GENERATED CODE
2
4
  #
3
5
  # This file is generated. See the contributing guide for more information:
@@ -48,6 +50,6 @@ require_relative 'aws-sdk-kinesis/event_streams'
48
50
  # @service
49
51
  module Aws::Kinesis
50
52
 
51
- GEM_VERSION = '1.22.0'
53
+ GEM_VERSION = '1.27.0'
52
54
 
53
55
  end
@@ -1,3 +1,5 @@
1
+ # frozen_string_literal: true
2
+
1
3
  # WARNING ABOUT GENERATED CODE
2
4
  #
3
5
  # This file is generated. See the contributing guide for more information:
@@ -23,6 +25,7 @@ require 'aws-sdk-core/plugins/regional_endpoint.rb'
23
25
  require 'aws-sdk-core/plugins/stub_responses.rb'
24
26
  require 'aws-sdk-core/plugins/idempotency_token.rb'
25
27
  require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
28
+ require 'aws-sdk-core/plugins/http_checksum.rb'
26
29
  require 'aws-sdk-core/plugins/invocation_id.rb'
27
30
  require 'aws-sdk-core/plugins/signature_v4.rb'
28
31
  require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
@@ -52,6 +55,7 @@ module Aws::Kinesis
52
55
  add_plugin(Aws::Plugins::StubResponses)
53
56
  add_plugin(Aws::Plugins::IdempotencyToken)
54
57
  add_plugin(Aws::Plugins::JsonvalueConverter)
58
+ add_plugin(Aws::Plugins::HttpChecksum)
55
59
  add_plugin(Aws::Plugins::InvocationId)
56
60
  add_plugin(Aws::Plugins::SignatureV4)
57
61
  add_plugin(Aws::Plugins::Protocols::JsonRpc)
@@ -116,7 +120,7 @@ module Aws::Kinesis
116
120
  # @option options [String] :endpoint
117
121
  # The client endpoint is normally constructed from the `:region`
118
122
  # option. You should only configure an `:endpoint` when connecting
119
- # to test endpoints. This should be a valid HTTP(S) URI.
123
+ # to test or custom endpoints. This should be a valid HTTP(S) URI.
120
124
  #
121
125
  # @option options [Proc] :event_stream_handler
122
126
  # When an EventStream or Proc object is provided, it will be used as callback for each chunk of event stream response received along the way.
@@ -228,19 +232,36 @@ module Aws::Kinesis
228
232
 
229
233
  # @!group API Operations
230
234
 
231
- # Call this operation from your consumer after you call
235
+ # This operation establishes an HTTP/2 connection between the consumer
236
+ # you specify in the `ConsumerARN` parameter and the shard you specify
237
+ # in the `ShardId` parameter. After the connection is successfully
238
+ # established, Kinesis Data Streams pushes records from the shard to the
239
+ # consumer over this connection. Before you call this operation, call
232
240
  # RegisterStreamConsumer to register the consumer with Kinesis Data
233
- # Streams. If the call succeeds, your consumer starts receiving events
234
- # of type SubscribeToShardEvent for up to 5 minutes, after which time
235
- # you need to call `SubscribeToShard` again to renew the subscription if
236
- # you want to continue to receive records.
237
- #
238
- # You can make one call to `SubscribeToShard` per second per
239
- # `ConsumerARN`. If your call succeeds, and then you call the operation
240
- # again less than 5 seconds later, the second call generates a
241
- # ResourceInUseException. If you call the operation a second time more
242
- # than 5 seconds after the first call succeeds, the second call succeeds
243
- # and the first connection gets shut down.
241
+ # Streams.
242
+ #
243
+ # When the `SubscribeToShard` call succeeds, your consumer starts
244
+ # receiving events of type SubscribeToShardEvent over the HTTP/2
245
+ # connection for up to 5 minutes, after which time you need to call
246
+ # `SubscribeToShard` again to renew the subscription if you want to
247
+ # continue to receive records.
248
+ #
249
+ # You can make one call to `SubscribeToShard` per second per registered
250
+ # consumer per shard. For example, if you have a 4000 shard stream and
251
+ # two registered stream consumers, you can make one `SubscribeToShard`
252
+ # request per second for each combination of shard and registered
253
+ # consumer, allowing you to subscribe both consumers to all 4000 shards
254
+ # in one second.
255
+ #
256
+ # If you call `SubscribeToShard` again with the same `ConsumerARN` and
257
+ # `ShardId` within 5 seconds of a successful call, you'll get a
258
+ # `ResourceInUseException`. If you call `SubscribeToShard` 5 seconds or
259
+ # more after a successful call, the first connection will expire and the
260
+ # second call will take over the subscription.
261
+ #
262
+ # For an example of how to use this operations, see [Enhanced Fan-Out
263
+ # Using the Kinesis Data Streams
264
+ # API](/streams/latest/dev/building-enhanced-consumers-api.html).
244
265
  #
245
266
  # @option params [required, String] :consumer_arn
246
267
  # For this parameter, use the value you obtained when you called
@@ -452,6 +473,12 @@ module Aws::Kinesis
452
473
  # event.records[0].encryption_type #=> String, one of "NONE", "KMS"
453
474
  # event.continuation_sequence_number #=> String
454
475
  # event.millis_behind_latest #=> Integer
476
+ # event.child_shards #=> Array
477
+ # event.child_shards[0].shard_id #=> String
478
+ # event.child_shards[0].parent_shards #=> Array
479
+ # event.child_shards[0].parent_shards[0] #=> String
480
+ # event.child_shards[0].hash_key_range.starting_hash_key #=> String
481
+ # event.child_shards[0].hash_key_range.ending_hash_key #=> String
455
482
  #
456
483
  # For :resource_not_found_exception event available at #on_resource_not_found_exception_event callback and response eventstream enumerator:
457
484
  # event.message #=> String
@@ -516,7 +543,7 @@ module Aws::Kinesis
516
543
  http_response: Seahorse::Client::Http::AsyncResponse.new,
517
544
  config: config)
518
545
  context[:gem_name] = 'aws-sdk-kinesis'
519
- context[:gem_version] = '1.22.0'
546
+ context[:gem_version] = '1.27.0'
520
547
  Seahorse::Client::Request.new(handlers, context)
521
548
  end
522
549
 
@@ -1,3 +1,5 @@
1
+ # frozen_string_literal: true
2
+
1
3
  # WARNING ABOUT GENERATED CODE
2
4
  #
3
5
  # This file is generated. See the contributing guide for more information:
@@ -24,6 +26,7 @@ require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
24
26
  require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
25
27
  require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
26
28
  require 'aws-sdk-core/plugins/transfer_encoding.rb'
29
+ require 'aws-sdk-core/plugins/http_checksum.rb'
27
30
  require 'aws-sdk-core/plugins/signature_v4.rb'
28
31
  require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
29
32
  require 'aws-sdk-core/plugins/event_stream_configuration.rb'
@@ -70,6 +73,7 @@ module Aws::Kinesis
70
73
  add_plugin(Aws::Plugins::ClientMetricsPlugin)
71
74
  add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
72
75
  add_plugin(Aws::Plugins::TransferEncoding)
76
+ add_plugin(Aws::Plugins::HttpChecksum)
73
77
  add_plugin(Aws::Plugins::SignatureV4)
74
78
  add_plugin(Aws::Plugins::Protocols::JsonRpc)
75
79
  add_plugin(Aws::Plugins::EventStreamConfiguration)
@@ -163,7 +167,7 @@ module Aws::Kinesis
163
167
  # @option options [String] :endpoint
164
168
  # The client endpoint is normally constructed from the `:region`
165
169
  # option. You should only configure an `:endpoint` when connecting
166
- # to test endpoints. This should be a valid HTTP(S) URI.
170
+ # to test or custom endpoints. This should be a valid HTTP(S) URI.
167
171
  #
168
172
  # @option options [Integer] :endpoint_cache_max_entries (1000)
169
173
  # Used for the maximum size limit of the LRU cache storing endpoints data
@@ -178,7 +182,7 @@ module Aws::Kinesis
178
182
  # requests fetching endpoints information. Defaults to 60 sec.
179
183
  #
180
184
  # @option options [Boolean] :endpoint_discovery (false)
181
- # When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
185
+ # When set to `true`, endpoint discovery will be enabled for operations when available.
182
186
  #
183
187
  # @option options [Proc] :event_stream_handler
184
188
  # When an EventStream or Proc object is provided, it will be used as callback for each chunk of event stream response received along the way.
@@ -375,9 +379,9 @@ module Aws::Kinesis
375
379
  #
376
380
  # You specify and control the number of shards that a stream is composed
377
381
  # of. Each shard can support reads up to five transactions per second,
378
- # up to a maximum data read total of 2 MB per second. Each shard can
382
+ # up to a maximum data read total of 2 MiB per second. Each shard can
379
383
  # support writes up to 1,000 records per second, up to a maximum data
380
- # write total of 1 MB per second. If the amount of data input increases
384
+ # write total of 1 MiB per second. If the amount of data input increases
381
385
  # or decreases, you can add or remove shards.
382
386
  #
383
387
  # The stream name identifies the stream. The name is scoped to the AWS
@@ -411,8 +415,8 @@ module Aws::Kinesis
411
415
  #
412
416
  #
413
417
  #
414
- # [1]: http://docs.aws.amazon.com/kinesis/latest/dev/service-sizes-and-limits.html
415
- # [2]: http://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html
418
+ # [1]: https://docs.aws.amazon.com/kinesis/latest/dev/service-sizes-and-limits.html
419
+ # [2]: https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html
416
420
  #
417
421
  # @option params [required, String] :stream_name
418
422
  # A name to identify the stream. The stream name is scoped to the AWS
@@ -426,8 +430,6 @@ module Aws::Kinesis
426
430
  # stream is a function of the number of shards; more shards are required
427
431
  # for greater provisioned throughput.
428
432
  #
429
- # DefaultShardLimit;
430
- #
431
433
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
432
434
  #
433
435
  # @example Request syntax with placeholder values
@@ -535,8 +537,7 @@ module Aws::Kinesis
535
537
  # all the consumers that are currently registered with a given data
536
538
  # stream. The description of a consumer contains its name and ARN.
537
539
  #
538
- # This operation has a limit of five transactions per second per
539
- # account.
540
+ # This operation has a limit of five transactions per second per stream.
540
541
  #
541
542
  # @option params [String] :stream_arn
542
543
  # The ARN of the Kinesis data stream that the consumer is registered
@@ -626,7 +627,7 @@ module Aws::Kinesis
626
627
  #
627
628
  #
628
629
  #
629
- # [1]: http://docs.aws.amazon.com/kinesis/latest/dev/kinesis-using-sdk-java-retrieve-shards.html
630
+ # [1]: https://docs.aws.amazon.com/kinesis/latest/dev/kinesis-using-sdk-java-retrieve-shards.html
630
631
  #
631
632
  # @option params [required, String] :stream_name
632
633
  # The name of the stream to describe.
@@ -699,7 +700,7 @@ module Aws::Kinesis
699
700
  # operation to get a list of the descriptions of all the consumers that
700
701
  # are currently registered with a given data stream.
701
702
  #
702
- # This operation has a limit of 20 transactions per second per account.
703
+ # This operation has a limit of 20 transactions per second per stream.
703
704
  #
704
705
  # @option params [String] :stream_arn
705
706
  # The ARN of the Kinesis data stream that the consumer is registered
@@ -753,6 +754,9 @@ module Aws::Kinesis
753
754
  # Name (ARN), status, record retention period, approximate creation
754
755
  # time, monitoring, encryption details, and open shard count.
755
756
  #
757
+ # DescribeStreamSummary has a limit of 20 transactions per second per
758
+ # account.
759
+ #
756
760
  # @option params [required, String] :stream_name
757
761
  # The name of the stream to describe.
758
762
  #
@@ -824,7 +828,7 @@ module Aws::Kinesis
824
828
  #
825
829
  #
826
830
  #
827
- # [1]: http://docs.aws.amazon.com/kinesis/latest/dev/monitoring-with-cloudwatch.html
831
+ # [1]: https://docs.aws.amazon.com/kinesis/latest/dev/monitoring-with-cloudwatch.html
828
832
  #
829
833
  # @return [Types::EnhancedMonitoringOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
830
834
  #
@@ -890,7 +894,7 @@ module Aws::Kinesis
890
894
  #
891
895
  #
892
896
  #
893
- # [1]: http://docs.aws.amazon.com/kinesis/latest/dev/monitoring-with-cloudwatch.html
897
+ # [1]: https://docs.aws.amazon.com/kinesis/latest/dev/monitoring-with-cloudwatch.html
894
898
  #
895
899
  # @return [Types::EnhancedMonitoringOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
896
900
  #
@@ -981,13 +985,12 @@ module Aws::Kinesis
981
985
  # always increasing. For example, records in a shard or across a stream
982
986
  # might have time stamps that are out of order.
983
987
  #
984
- # This operation has a limit of five transactions per second per
985
- # account.
988
+ # This operation has a limit of five transactions per second per shard.
986
989
  #
987
990
  #
988
991
  #
989
- # [1]: http://docs.aws.amazon.com/kinesis/latest/dev/service-sizes-and-limits.html
990
- # [2]: http://docs.aws.amazon.com/kinesis/latest/dev/monitoring.html
992
+ # [1]: https://docs.aws.amazon.com/kinesis/latest/dev/service-sizes-and-limits.html
993
+ # [2]: https://docs.aws.amazon.com/kinesis/latest/dev/monitoring.html
991
994
  #
992
995
  # @option params [required, String] :shard_iterator
993
996
  # The position in the shard from which you want to start sequentially
@@ -997,13 +1000,14 @@ module Aws::Kinesis
997
1000
  # @option params [Integer] :limit
998
1001
  # The maximum number of records to return. Specify a value of up to
999
1002
  # 10,000. If you specify a value that is greater than 10,000, GetRecords
1000
- # throws `InvalidArgumentException`.
1003
+ # throws `InvalidArgumentException`. The default value is 10,000.
1001
1004
  #
1002
1005
  # @return [Types::GetRecordsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1003
1006
  #
1004
1007
  # * {Types::GetRecordsOutput#records #records} => Array<Types::Record>
1005
1008
  # * {Types::GetRecordsOutput#next_shard_iterator #next_shard_iterator} => String
1006
1009
  # * {Types::GetRecordsOutput#millis_behind_latest #millis_behind_latest} => Integer
1010
+ # * {Types::GetRecordsOutput#child_shards #child_shards} => Array<Types::ChildShard>
1007
1011
  #
1008
1012
  # @example Request syntax with placeholder values
1009
1013
  #
@@ -1022,6 +1026,12 @@ module Aws::Kinesis
1022
1026
  # resp.records[0].encryption_type #=> String, one of "NONE", "KMS"
1023
1027
  # resp.next_shard_iterator #=> String
1024
1028
  # resp.millis_behind_latest #=> Integer
1029
+ # resp.child_shards #=> Array
1030
+ # resp.child_shards[0].shard_id #=> String
1031
+ # resp.child_shards[0].parent_shards #=> Array
1032
+ # resp.child_shards[0].parent_shards[0] #=> String
1033
+ # resp.child_shards[0].hash_key_range.starting_hash_key #=> String
1034
+ # resp.child_shards[0].hash_key_range.ending_hash_key #=> String
1025
1035
  #
1026
1036
  # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02/GetRecords AWS API Documentation
1027
1037
  #
@@ -1077,7 +1087,7 @@ module Aws::Kinesis
1077
1087
  #
1078
1088
  #
1079
1089
  #
1080
- # [1]: http://docs.aws.amazon.com/kinesis/latest/dev/service-sizes-and-limits.html
1090
+ # [1]: https://docs.aws.amazon.com/kinesis/latest/dev/service-sizes-and-limits.html
1081
1091
  #
1082
1092
  # @option params [required, String] :stream_name
1083
1093
  # The name of the Amazon Kinesis data stream.
@@ -1248,7 +1258,7 @@ module Aws::Kinesis
1248
1258
  # @option params [Integer] :max_results
1249
1259
  # The maximum number of shards to return in a single call to
1250
1260
  # `ListShards`. The minimum value you can specify for this parameter is
1251
- # 1, and the maximum is 1,000, which is also the default.
1261
+ # 1, and the maximum is 10,000, which is also the default.
1252
1262
  #
1253
1263
  # When the number of shards to be listed is greater than the value of
1254
1264
  # `MaxResults`, the response contains a `NextToken` value that you can
@@ -1265,6 +1275,8 @@ module Aws::Kinesis
1265
1275
  # You cannot specify this parameter if you specify the `NextToken`
1266
1276
  # parameter.
1267
1277
  #
1278
+ # @option params [Types::ShardFilter] :shard_filter
1279
+ #
1268
1280
  # @return [Types::ListShardsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1269
1281
  #
1270
1282
  # * {Types::ListShardsOutput#shards #shards} => Array<Types::Shard>
@@ -1278,6 +1290,11 @@ module Aws::Kinesis
1278
1290
  # exclusive_start_shard_id: "ShardId",
1279
1291
  # max_results: 1,
1280
1292
  # stream_creation_timestamp: Time.now,
1293
+ # shard_filter: {
1294
+ # type: "AFTER_SHARD_ID", # required, accepts AFTER_SHARD_ID, AT_TRIM_HORIZON, FROM_TRIM_HORIZON, AT_LATEST, AT_TIMESTAMP, FROM_TIMESTAMP
1295
+ # shard_id: "ShardId",
1296
+ # timestamp: Time.now,
1297
+ # },
1281
1298
  # })
1282
1299
  #
1283
1300
  # @example Response structure
@@ -1304,7 +1321,7 @@ module Aws::Kinesis
1304
1321
  # Lists the consumers registered to receive data from a stream using
1305
1322
  # enhanced fan-out, and provides information about each consumer.
1306
1323
  #
1307
- # This operation has a limit of 10 transactions per second per account.
1324
+ # This operation has a limit of 5 transactions per second per stream.
1308
1325
  #
1309
1326
  # @option params [required, String] :stream_arn
1310
1327
  # The ARN of the Kinesis data stream for which you want to list the
@@ -1533,7 +1550,7 @@ module Aws::Kinesis
1533
1550
  #
1534
1551
  #
1535
1552
  #
1536
- # [1]: http://docs.aws.amazon.com/kinesis/latest/dev/kinesis-using-sdk-java-resharding-merge.html
1553
+ # [1]: https://docs.aws.amazon.com/kinesis/latest/dev/kinesis-using-sdk-java-resharding-merge.html
1537
1554
  #
1538
1555
  # @option params [required, String] :stream_name
1539
1556
  # The name of the stream for the merge.
@@ -1568,7 +1585,7 @@ module Aws::Kinesis
1568
1585
  # `PutRecord` to send data into the stream for real-time ingestion and
1569
1586
  # subsequent processing, one record at a time. Each shard can support
1570
1587
  # writes up to 1,000 records per second, up to a maximum data write
1571
- # total of 1 MB per second.
1588
+ # total of 1 MiB per second.
1572
1589
  #
1573
1590
  # You must specify the name of the stream that captures, stores, and
1574
1591
  # transports the data; a partition key; and the data blob itself.
@@ -1602,6 +1619,9 @@ module Aws::Kinesis
1602
1619
  # [Adding Data to a Stream][1] in the *Amazon Kinesis Data Streams
1603
1620
  # Developer Guide*.
1604
1621
  #
1622
+ # After you write a record to a stream, you cannot modify that record or
1623
+ # its order within the stream.
1624
+ #
1605
1625
  # If a `PutRecord` request cannot be processed because of insufficient
1606
1626
  # provisioned throughput on the shard involved in the request,
1607
1627
  # `PutRecord` throws `ProvisionedThroughputExceededException`.
@@ -1613,16 +1633,16 @@ module Aws::Kinesis
1613
1633
  #
1614
1634
  #
1615
1635
  #
1616
- # [1]: http://docs.aws.amazon.com/kinesis/latest/dev/developing-producers-with-sdk.html#kinesis-using-sdk-java-add-data-to-stream
1636
+ # [1]: https://docs.aws.amazon.com/kinesis/latest/dev/developing-producers-with-sdk.html#kinesis-using-sdk-java-add-data-to-stream
1617
1637
  #
1618
1638
  # @option params [required, String] :stream_name
1619
1639
  # The name of the stream to put the data record into.
1620
1640
  #
1621
- # @option params [required, String, IO] :data
1641
+ # @option params [required, String, StringIO, File] :data
1622
1642
  # The data blob to put into the record, which is base64-encoded when the
1623
1643
  # blob is serialized. When the data blob (the payload before
1624
1644
  # base64-encoding) is added to the partition key size, the total size
1625
- # must not exceed the maximum record size (1 MB).
1645
+ # must not exceed the maximum record size (1 MiB).
1626
1646
  #
1627
1647
  # @option params [required, String] :partition_key
1628
1648
  # Determines which shard in the stream the data record is assigned to.
@@ -1683,10 +1703,10 @@ module Aws::Kinesis
1683
1703
  # to send data into the stream for data ingestion and processing.
1684
1704
  #
1685
1705
  # Each `PutRecords` request can support up to 500 records. Each record
1686
- # in the request can be as large as 1 MB, up to a limit of 5 MB for the
1687
- # entire request, including partition keys. Each shard can support
1706
+ # in the request can be as large as 1 MiB, up to a limit of 5 MiB for
1707
+ # the entire request, including partition keys. Each shard can support
1688
1708
  # writes up to 1,000 records per second, up to a maximum data write
1689
- # total of 1 MB per second.
1709
+ # total of 1 MiB per second.
1690
1710
  #
1691
1711
  # You must specify the name of the stream that captures, stores, and
1692
1712
  # transports the data; and an array of request `Records`, with each
@@ -1723,7 +1743,10 @@ module Aws::Kinesis
1723
1743
  # The response `Records` array includes both successfully and
1724
1744
  # unsuccessfully processed records. Kinesis Data Streams attempts to
1725
1745
  # process all records in each `PutRecords` request. A single record
1726
- # failure does not stop the processing of subsequent records.
1746
+ # failure does not stop the processing of subsequent records. As a
1747
+ # result, PutRecords doesn't guarantee the ordering of records. If you
1748
+ # need to read records in the same order they are written to the stream,
1749
+ # use PutRecord instead of `PutRecords`, and write to the same shard.
1727
1750
  #
1728
1751
  # A successfully processed record includes `ShardId` and
1729
1752
  # `SequenceNumber` values. The `ShardId` parameter identifies the shard
@@ -1742,6 +1765,9 @@ module Aws::Kinesis
1742
1765
  # see [Adding Multiple Records with PutRecords][3] in the *Amazon
1743
1766
  # Kinesis Data Streams Developer Guide*.
1744
1767
  #
1768
+ # After you write a record to a stream, you cannot modify that record or
1769
+ # its order within the stream.
1770
+ #
1745
1771
  # By default, data records are accessible for 24 hours from the time
1746
1772
  # that they are added to a stream. You can use
1747
1773
  # IncreaseStreamRetentionPeriod or DecreaseStreamRetentionPeriod to
@@ -1749,9 +1775,9 @@ module Aws::Kinesis
1749
1775
  #
1750
1776
  #
1751
1777
  #
1752
- # [1]: http://docs.aws.amazon.com/kinesis/latest/dev/developing-producers-with-sdk.html#kinesis-using-sdk-java-add-data-to-stream
1753
- # [2]: http://docs.aws.amazon.com/kinesis/latest/dev/developing-producers-with-sdk.html#kinesis-using-sdk-java-putrecords
1754
- # [3]: http://docs.aws.amazon.com/kinesis/latest/dev/kinesis-using-sdk-java-add-data-to-stream.html#kinesis-using-sdk-java-putrecords
1778
+ # [1]: https://docs.aws.amazon.com/kinesis/latest/dev/developing-producers-with-sdk.html#kinesis-using-sdk-java-add-data-to-stream
1779
+ # [2]: https://docs.aws.amazon.com/kinesis/latest/dev/developing-producers-with-sdk.html#kinesis-using-sdk-java-putrecords
1780
+ # [3]: https://docs.aws.amazon.com/kinesis/latest/dev/kinesis-using-sdk-java-add-data-to-stream.html#kinesis-using-sdk-java-putrecords
1755
1781
  #
1756
1782
  # @option params [required, Array<Types::PutRecordsRequestEntry>] :records
1757
1783
  # The records associated with the request.
@@ -1798,15 +1824,24 @@ module Aws::Kinesis
1798
1824
  end
1799
1825
 
1800
1826
  # Registers a consumer with a Kinesis data stream. When you use this
1801
- # operation, the consumer you register can read data from the stream at
1802
- # a rate of up to 2 MiB per second. This rate is unaffected by the total
1803
- # number of consumers that read from the same stream.
1827
+ # operation, the consumer you register can then call SubscribeToShard to
1828
+ # receive data from the stream using enhanced fan-out, at a rate of up
1829
+ # to 2 MiB per second for every shard you subscribe to. This rate is
1830
+ # unaffected by the total number of consumers that read from the same
1831
+ # stream.
1804
1832
  #
1805
- # You can register up to 5 consumers per stream. A given consumer can
1806
- # only be registered with one stream.
1833
+ # You can register up to 20 consumers per stream. A given consumer can
1834
+ # only be registered with one stream at a time.
1807
1835
  #
1808
- # This operation has a limit of five transactions per second per
1809
- # account.
1836
+ # For an example of how to use this operations, see [Enhanced Fan-Out
1837
+ # Using the Kinesis Data Streams
1838
+ # API](/streams/latest/dev/building-enhanced-consumers-api.html).
1839
+ #
1840
+ # The use of this operation has a limit of five transactions per second
1841
+ # per account. Also, only 5 consumers can be created simultaneously. In
1842
+ # other words, you cannot have more than 5 consumers in a `CREATING`
1843
+ # status at the same time. Registering a 6th consumer while there are 5
1844
+ # in a `CREATING` status results in a `LimitExceededException`.
1810
1845
  #
1811
1846
  # @option params [required, String] :stream_arn
1812
1847
  # The ARN of the Kinesis data stream that you want to register the
@@ -1935,9 +1970,9 @@ module Aws::Kinesis
1935
1970
  #
1936
1971
  #
1937
1972
  #
1938
- # [1]: http://docs.aws.amazon.com/kinesis/latest/dev/kinesis-using-sdk-java-resharding-split.html
1939
- # [2]: http://docs.aws.amazon.com/kinesis/latest/dev/service-sizes-and-limits.html
1940
- # [3]: http://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html
1973
+ # [1]: https://docs.aws.amazon.com/kinesis/latest/dev/kinesis-using-sdk-java-resharding-split.html
1974
+ # [2]: https://docs.aws.amazon.com/kinesis/latest/dev/service-sizes-and-limits.html
1975
+ # [3]: https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html
1941
1976
  #
1942
1977
  # @option params [required, String] :stream_name
1943
1978
  # The name of the stream for the shard split.
@@ -2118,14 +2153,19 @@ module Aws::Kinesis
2118
2153
  #
2119
2154
  # To update the shard count, Kinesis Data Streams performs splits or
2120
2155
  # merges on individual shards. This can cause short-lived shards to be
2121
- # created, in addition to the final shards. We recommend that you double
2122
- # or halve the shard count, as this results in the fewest number of
2123
- # splits or merges.
2156
+ # created, in addition to the final shards. These short-lived shards
2157
+ # count towards your total shard limit for your account in the Region.
2158
+ #
2159
+ # When using this operation, we recommend that you specify a target
2160
+ # shard count that is a multiple of 25% (25%, 50%, 75%, 100%). You can
2161
+ # specify any target value within your shard limit. However, if you
2162
+ # specify a target that isn't a multiple of 25%, the scaling action
2163
+ # might take longer to complete.
2124
2164
  #
2125
2165
  # This operation has the following default limits. By default, you
2126
2166
  # cannot do the following:
2127
2167
  #
2128
- # * Scale more than twice per rolling 24-hour period per stream
2168
+ # * Scale more than ten times per rolling 24-hour period per stream
2129
2169
  #
2130
2170
  # * Scale up to more than double your current shard count for a stream
2131
2171
  #
@@ -2145,14 +2185,27 @@ module Aws::Kinesis
2145
2185
  #
2146
2186
  #
2147
2187
  #
2148
- # [1]: http://docs.aws.amazon.com/kinesis/latest/dev/service-sizes-and-limits.html
2188
+ # [1]: https://docs.aws.amazon.com/kinesis/latest/dev/service-sizes-and-limits.html
2149
2189
  # [2]: https://console.aws.amazon.com/support/v1#/case/create?issueType=service-limit-increase&amp;limitType=service-code-kinesis
2150
2190
  #
2151
2191
  # @option params [required, String] :stream_name
2152
2192
  # The name of the stream.
2153
2193
  #
2154
2194
  # @option params [required, Integer] :target_shard_count
2155
- # The new number of shards.
2195
+ # The new number of shards. This value has the following default limits.
2196
+ # By default, you cannot do the following:
2197
+ #
2198
+ # * Set this value to more than double your current shard count for a
2199
+ # stream.
2200
+ #
2201
+ # * Set this value below half your current shard count for a stream.
2202
+ #
2203
+ # * Set this value to more than 500 shards in a stream (the default
2204
+ # limit for shard count per stream is 500 per account per region),
2205
+ # unless you request a limit increase.
2206
+ #
2207
+ # * Scale a stream with more than 500 shards down unless you set this
2208
+ # value to less than 500 shards.
2156
2209
  #
2157
2210
  # @option params [required, String] :scaling_type
2158
2211
  # The scaling type. Uniform scaling creates shards of equal size.
@@ -2199,7 +2252,7 @@ module Aws::Kinesis
2199
2252
  params: params,
2200
2253
  config: config)
2201
2254
  context[:gem_name] = 'aws-sdk-kinesis'
2202
- context[:gem_version] = '1.22.0'
2255
+ context[:gem_version] = '1.27.0'
2203
2256
  Seahorse::Client::Request.new(handlers, context)
2204
2257
  end
2205
2258