aws-sdk-kinesisvideo 1.87.0 → 1.88.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: b7ff5e099cbb8c3fb791f78f0c228d90fd31065eeb0cbf9a405470f81f0b7c0c
4
- data.tar.gz: 65264fe887be313401ee72cde1786fc59489012bb47ac21912f60df058fcc257
3
+ metadata.gz: 3098d9fb38808fa2479f4ded56c93db62f2ea585b5f8597f6bab7832f0ce3086
4
+ data.tar.gz: 63928020c660e7b53a5d6a7811b923a92dc62bf01c83f5bc22b0cb74f06a0038
5
5
  SHA512:
6
- metadata.gz: 0f6e0f0e70672eca7ab88968b4aba18917f958f58e1b2df7dcbc424464801e0b4c29b80b8bf2952b18011cee1d5553114e30abbda67ead8fcd44556a4516c23a
7
- data.tar.gz: bfa9d1fd4dcfb0c28ca1653675c7dfbff124eda6108a98663e5db91f306a5ae80dcddcff4948090e2f05fe4e67c5fd54ca40073977f6a3895bb58bee0478ebf0
6
+ metadata.gz: 82dfc5630ef8eee6ca815652ee8a35f38ac10ce99468fdf3da69cb8d51f69f86f473f57b28fecfd167ea77a81b29af0c30790747db0cb9a4e986e8f841572795
7
+ data.tar.gz: 2e6e1e586523dec0b26b305617821f74d24b1219ddc3de122a8aec95a8de24eb3b0c8506ea1973a8c8ea0ded5459eb6f27ba618d3c8825930516dd7cbd58b34a
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.88.0 (2025-11-21)
5
+ ------------------
6
+
7
+ * Feature - This release adds support for Tiered Storage
8
+
4
9
  1.87.0 (2025-10-28)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.87.0
1
+ 1.88.0
@@ -491,7 +491,8 @@ module Aws::KinesisVideo
491
491
  #
492
492
  # @option params [Types::SingleMasterConfiguration] :single_master_configuration
493
493
  # A structure containing the configuration for the `SINGLE_MASTER`
494
- # channel type.
494
+ # channel type. The default configuration for the channel message's
495
+ # time to live is 60 seconds (1 minute).
495
496
  #
496
497
  # @option params [Array<Types::Tag>] :tags
497
498
  # A set of tags (key-value pairs) that you want to associate with this
@@ -549,7 +550,7 @@ module Aws::KinesisVideo
549
550
  # @option params [String] :device_name
550
551
  # The name of the device that is writing to the stream.
551
552
  #
552
- # <note markdown="1"> In the current implementation, Kinesis Video Streams does not use this
553
+ # <note markdown="1"> In the current implementation, Kinesis Video Streams doesn't use this
553
554
  # name.
554
555
  #
555
556
  # </note>
@@ -582,7 +583,7 @@ module Aws::KinesisVideo
582
583
  # Video Streams to use to encrypt stream data.
583
584
  #
584
585
  # If no key ID is specified, the default, Kinesis Video-managed key
585
- # (`Amazon Web Services/kinesisvideo`) is used.
586
+ # (`aws/kinesisvideo`) is used.
586
587
  #
587
588
  # For more information, see [DescribeKey][1].
588
589
  #
@@ -596,7 +597,7 @@ module Aws::KinesisVideo
596
597
  # associated with the stream.
597
598
  #
598
599
  # The default value is 0, indicating that the stream does not persist
599
- # data.
600
+ # data. The minimum is 1 hour.
600
601
  #
601
602
  # When the `DataRetentionInHours` value is 0, consumers can still
602
603
  # consume the fragments that remain in the service host buffer, which
@@ -608,6 +609,15 @@ module Aws::KinesisVideo
608
609
  # A list of tags to associate with the specified stream. Each tag is a
609
610
  # key-value pair (the value is optional).
610
611
  #
612
+ # @option params [Types::StreamStorageConfiguration] :stream_storage_configuration
613
+ # The configuration for the stream's storage, including the default
614
+ # storage tier for stream data. This configuration determines how stream
615
+ # data is stored and accessed, with different tiers offering varying
616
+ # levels of performance and cost optimization.
617
+ #
618
+ # If not specified, the stream will use the default storage
619
+ # configuration with HOT tier for optimal performance.
620
+ #
611
621
  # @return [Types::CreateStreamOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
612
622
  #
613
623
  # * {Types::CreateStreamOutput#stream_arn #stream_arn} => String
@@ -623,6 +633,9 @@ module Aws::KinesisVideo
623
633
  # tags: {
624
634
  # "TagKey" => "TagValue",
625
635
  # },
636
+ # stream_storage_configuration: {
637
+ # default_storage_tier: "HOT", # required, accepts HOT, WARM
638
+ # },
626
639
  # })
627
640
  #
628
641
  # @example Response structure
@@ -1070,6 +1083,51 @@ module Aws::KinesisVideo
1070
1083
  req.send_request(options)
1071
1084
  end
1072
1085
 
1086
+ # Retrieves the current storage configuration for the specified Kinesis
1087
+ # video stream.
1088
+ #
1089
+ # In the request, you must specify either the `StreamName` or the
1090
+ # `StreamARN`.
1091
+ #
1092
+ # You must have permissions for the
1093
+ # `KinesisVideo:DescribeStreamStorageConfiguration` action.
1094
+ #
1095
+ # @option params [String] :stream_name
1096
+ # The name of the stream for which you want to retrieve the storage
1097
+ # configuration.
1098
+ #
1099
+ # @option params [String] :stream_arn
1100
+ # The Amazon Resource Name (ARN) of the stream for which you want to
1101
+ # retrieve the storage configuration.
1102
+ #
1103
+ # @return [Types::DescribeStreamStorageConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1104
+ #
1105
+ # * {Types::DescribeStreamStorageConfigurationOutput#stream_name #stream_name} => String
1106
+ # * {Types::DescribeStreamStorageConfigurationOutput#stream_arn #stream_arn} => String
1107
+ # * {Types::DescribeStreamStorageConfigurationOutput#stream_storage_configuration #stream_storage_configuration} => Types::StreamStorageConfiguration
1108
+ #
1109
+ # @example Request syntax with placeholder values
1110
+ #
1111
+ # resp = client.describe_stream_storage_configuration({
1112
+ # stream_name: "StreamName",
1113
+ # stream_arn: "ResourceARN",
1114
+ # })
1115
+ #
1116
+ # @example Response structure
1117
+ #
1118
+ # resp.stream_name #=> String
1119
+ # resp.stream_arn #=> String
1120
+ # resp.stream_storage_configuration.default_storage_tier #=> String, one of "HOT", "WARM"
1121
+ #
1122
+ # @see http://docs.aws.amazon.com/goto/WebAPI/kinesisvideo-2017-09-30/DescribeStreamStorageConfiguration AWS API Documentation
1123
+ #
1124
+ # @overload describe_stream_storage_configuration(params = {})
1125
+ # @param [Hash] params ({})
1126
+ def describe_stream_storage_configuration(params = {}, options = {})
1127
+ req = build_request(:describe_stream_storage_configuration, params)
1128
+ req.send_request(options)
1129
+ end
1130
+
1073
1131
  # Gets an endpoint for a specified stream for either reading or writing.
1074
1132
  # Use this endpoint in your application to read from the specified
1075
1133
  # stream (using the `GetMedia` or `GetMediaForFragmentList` operations)
@@ -1128,7 +1186,9 @@ module Aws::KinesisVideo
1128
1186
  # `Protocols` is used to determine the communication mechanism. For
1129
1187
  # example, if you specify `WSS` as the protocol, this API produces a
1130
1188
  # secure websocket endpoint. If you specify `HTTPS` as the protocol,
1131
- # this API generates an HTTPS endpoint.
1189
+ # this API generates an HTTPS endpoint. If you specify `WEBRTC` as the
1190
+ # protocol, but the signaling channel isn't configured for ingestion,
1191
+ # you will receive the error `InvalidArgumentException`.
1132
1192
  #
1133
1193
  # `Role` determines the messaging permissions. A `MASTER` role results
1134
1194
  # in this API generating an endpoint that a client can use to
@@ -1920,7 +1980,9 @@ module Aws::KinesisVideo
1920
1980
  #
1921
1981
  # @option params [Types::SingleMasterConfiguration] :single_master_configuration
1922
1982
  # The structure containing the configuration for the `SINGLE_MASTER`
1923
- # type of the signaling channel that you want to update.
1983
+ # type of the signaling channel that you want to update. This parameter
1984
+ # and the channel message's time-to-live are required for channels with
1985
+ # the `SINGLE_MASTER` channel type.
1924
1986
  #
1925
1987
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1926
1988
  #
@@ -2013,6 +2075,61 @@ module Aws::KinesisVideo
2013
2075
  req.send_request(options)
2014
2076
  end
2015
2077
 
2078
+ # Updates the storage configuration for an existing Kinesis video
2079
+ # stream.
2080
+ #
2081
+ # This operation allows you to modify the storage tier settings for a
2082
+ # stream, enabling you to optimize storage costs and performance based
2083
+ # on your access patterns.
2084
+ #
2085
+ # `UpdateStreamStorageConfiguration` is an asynchronous operation.
2086
+ #
2087
+ # You must have permissions for the
2088
+ # `KinesisVideo:UpdateStreamStorageConfiguration` action.
2089
+ #
2090
+ # @option params [String] :stream_name
2091
+ # The name of the stream for which you want to update the storage
2092
+ # configuration.
2093
+ #
2094
+ # @option params [String] :stream_arn
2095
+ # The Amazon Resource Name (ARN) of the stream for which you want to
2096
+ # update the storage configuration.
2097
+ #
2098
+ # @option params [required, String] :current_version
2099
+ # The version of the stream whose storage configuration you want to
2100
+ # change. To get the version, call either the `DescribeStream` or the
2101
+ # `ListStreams` API.
2102
+ #
2103
+ # @option params [required, Types::StreamStorageConfiguration] :stream_storage_configuration
2104
+ # The new storage configuration for the stream. This includes the
2105
+ # default storage tier that determines how stream data is stored and
2106
+ # accessed.
2107
+ #
2108
+ # Different storage tiers offer varying levels of performance and cost
2109
+ # optimization to match your specific use case requirements.
2110
+ #
2111
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2112
+ #
2113
+ # @example Request syntax with placeholder values
2114
+ #
2115
+ # resp = client.update_stream_storage_configuration({
2116
+ # stream_name: "StreamName",
2117
+ # stream_arn: "ResourceARN",
2118
+ # current_version: "Version", # required
2119
+ # stream_storage_configuration: { # required
2120
+ # default_storage_tier: "HOT", # required, accepts HOT, WARM
2121
+ # },
2122
+ # })
2123
+ #
2124
+ # @see http://docs.aws.amazon.com/goto/WebAPI/kinesisvideo-2017-09-30/UpdateStreamStorageConfiguration AWS API Documentation
2125
+ #
2126
+ # @overload update_stream_storage_configuration(params = {})
2127
+ # @param [Hash] params ({})
2128
+ def update_stream_storage_configuration(params = {}, options = {})
2129
+ req = build_request(:update_stream_storage_configuration, params)
2130
+ req.send_request(options)
2131
+ end
2132
+
2016
2133
  # @!endgroup
2017
2134
 
2018
2135
  # @param params ({})
@@ -2031,7 +2148,7 @@ module Aws::KinesisVideo
2031
2148
  tracer: tracer
2032
2149
  )
2033
2150
  context[:gem_name] = 'aws-sdk-kinesisvideo'
2034
- context[:gem_version] = '1.87.0'
2151
+ context[:gem_version] = '1.88.0'
2035
2152
  Seahorse::Client::Request.new(handlers, context)
2036
2153
  end
2037
2154
 
@@ -35,6 +35,7 @@ module Aws::KinesisVideo
35
35
  DataEndpoint = Shapes::StringShape.new(name: 'DataEndpoint')
36
36
  DataRetentionChangeInHours = Shapes::IntegerShape.new(name: 'DataRetentionChangeInHours')
37
37
  DataRetentionInHours = Shapes::IntegerShape.new(name: 'DataRetentionInHours')
38
+ DefaultStorageTier = Shapes::StringShape.new(name: 'DefaultStorageTier')
38
39
  DeleteAfterUpload = Shapes::BooleanShape.new(name: 'DeleteAfterUpload')
39
40
  DeleteEdgeConfigurationInput = Shapes::StructureShape.new(name: 'DeleteEdgeConfigurationInput')
40
41
  DeleteEdgeConfigurationOutput = Shapes::StructureShape.new(name: 'DeleteEdgeConfigurationOutput')
@@ -57,6 +58,8 @@ module Aws::KinesisVideo
57
58
  DescribeSignalingChannelOutput = Shapes::StructureShape.new(name: 'DescribeSignalingChannelOutput')
58
59
  DescribeStreamInput = Shapes::StructureShape.new(name: 'DescribeStreamInput')
59
60
  DescribeStreamOutput = Shapes::StructureShape.new(name: 'DescribeStreamOutput')
61
+ DescribeStreamStorageConfigurationInput = Shapes::StructureShape.new(name: 'DescribeStreamStorageConfigurationInput')
62
+ DescribeStreamStorageConfigurationOutput = Shapes::StructureShape.new(name: 'DescribeStreamStorageConfigurationOutput')
60
63
  DestinationRegion = Shapes::StringShape.new(name: 'DestinationRegion')
61
64
  DestinationUri = Shapes::StringShape.new(name: 'DestinationUri')
62
65
  DeviceName = Shapes::StringShape.new(name: 'DeviceName')
@@ -142,6 +145,7 @@ module Aws::KinesisVideo
142
145
  StreamInfoList = Shapes::ListShape.new(name: 'StreamInfoList')
143
146
  StreamName = Shapes::StringShape.new(name: 'StreamName')
144
147
  StreamNameCondition = Shapes::StructureShape.new(name: 'StreamNameCondition')
148
+ StreamStorageConfiguration = Shapes::StructureShape.new(name: 'StreamStorageConfiguration')
145
149
  SyncStatus = Shapes::StringShape.new(name: 'SyncStatus')
146
150
  Tag = Shapes::StructureShape.new(name: 'Tag')
147
151
  TagKey = Shapes::StringShape.new(name: 'TagKey')
@@ -173,6 +177,8 @@ module Aws::KinesisVideo
173
177
  UpdateSignalingChannelOutput = Shapes::StructureShape.new(name: 'UpdateSignalingChannelOutput')
174
178
  UpdateStreamInput = Shapes::StructureShape.new(name: 'UpdateStreamInput')
175
179
  UpdateStreamOutput = Shapes::StructureShape.new(name: 'UpdateStreamOutput')
180
+ UpdateStreamStorageConfigurationInput = Shapes::StructureShape.new(name: 'UpdateStreamStorageConfigurationInput')
181
+ UpdateStreamStorageConfigurationOutput = Shapes::StructureShape.new(name: 'UpdateStreamStorageConfigurationOutput')
176
182
  UploaderConfig = Shapes::StructureShape.new(name: 'UploaderConfig')
177
183
  UploaderStatus = Shapes::StringShape.new(name: 'UploaderStatus')
178
184
  Version = Shapes::StringShape.new(name: 'Version')
@@ -221,6 +227,7 @@ module Aws::KinesisVideo
221
227
  CreateStreamInput.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: KmsKeyId, location_name: "KmsKeyId"))
222
228
  CreateStreamInput.add_member(:data_retention_in_hours, Shapes::ShapeRef.new(shape: DataRetentionInHours, location_name: "DataRetentionInHours"))
223
229
  CreateStreamInput.add_member(:tags, Shapes::ShapeRef.new(shape: ResourceTags, location_name: "Tags"))
230
+ CreateStreamInput.add_member(:stream_storage_configuration, Shapes::ShapeRef.new(shape: StreamStorageConfiguration, location_name: "StreamStorageConfiguration"))
224
231
  CreateStreamInput.struct_class = Types::CreateStreamInput
225
232
 
226
233
  CreateStreamOutput.add_member(:stream_arn, Shapes::ShapeRef.new(shape: ResourceARN, location_name: "StreamARN"))
@@ -308,6 +315,15 @@ module Aws::KinesisVideo
308
315
  DescribeStreamOutput.add_member(:stream_info, Shapes::ShapeRef.new(shape: StreamInfo, location_name: "StreamInfo"))
309
316
  DescribeStreamOutput.struct_class = Types::DescribeStreamOutput
310
317
 
318
+ DescribeStreamStorageConfigurationInput.add_member(:stream_name, Shapes::ShapeRef.new(shape: StreamName, location_name: "StreamName"))
319
+ DescribeStreamStorageConfigurationInput.add_member(:stream_arn, Shapes::ShapeRef.new(shape: ResourceARN, location_name: "StreamARN"))
320
+ DescribeStreamStorageConfigurationInput.struct_class = Types::DescribeStreamStorageConfigurationInput
321
+
322
+ DescribeStreamStorageConfigurationOutput.add_member(:stream_name, Shapes::ShapeRef.new(shape: StreamName, location_name: "StreamName"))
323
+ DescribeStreamStorageConfigurationOutput.add_member(:stream_arn, Shapes::ShapeRef.new(shape: ResourceARN, location_name: "StreamARN"))
324
+ DescribeStreamStorageConfigurationOutput.add_member(:stream_storage_configuration, Shapes::ShapeRef.new(shape: StreamStorageConfiguration, location_name: "StreamStorageConfiguration"))
325
+ DescribeStreamStorageConfigurationOutput.struct_class = Types::DescribeStreamStorageConfigurationOutput
326
+
311
327
  DeviceStreamLimitExceededException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message"))
312
328
  DeviceStreamLimitExceededException.struct_class = Types::DeviceStreamLimitExceededException
313
329
 
@@ -526,6 +542,9 @@ module Aws::KinesisVideo
526
542
  StreamNameCondition.add_member(:comparison_value, Shapes::ShapeRef.new(shape: StreamName, location_name: "ComparisonValue"))
527
543
  StreamNameCondition.struct_class = Types::StreamNameCondition
528
544
 
545
+ StreamStorageConfiguration.add_member(:default_storage_tier, Shapes::ShapeRef.new(shape: DefaultStorageTier, required: true, location_name: "DefaultStorageTier"))
546
+ StreamStorageConfiguration.struct_class = Types::StreamStorageConfiguration
547
+
529
548
  Tag.add_member(:key, Shapes::ShapeRef.new(shape: TagKey, required: true, location_name: "Key"))
530
549
  Tag.add_member(:value, Shapes::ShapeRef.new(shape: TagValue, required: true, location_name: "Value"))
531
550
  Tag.struct_class = Types::Tag
@@ -610,6 +629,14 @@ module Aws::KinesisVideo
610
629
 
611
630
  UpdateStreamOutput.struct_class = Types::UpdateStreamOutput
612
631
 
632
+ UpdateStreamStorageConfigurationInput.add_member(:stream_name, Shapes::ShapeRef.new(shape: StreamName, location_name: "StreamName"))
633
+ UpdateStreamStorageConfigurationInput.add_member(:stream_arn, Shapes::ShapeRef.new(shape: ResourceARN, location_name: "StreamARN"))
634
+ UpdateStreamStorageConfigurationInput.add_member(:current_version, Shapes::ShapeRef.new(shape: Version, required: true, location_name: "CurrentVersion"))
635
+ UpdateStreamStorageConfigurationInput.add_member(:stream_storage_configuration, Shapes::ShapeRef.new(shape: StreamStorageConfiguration, required: true, location_name: "StreamStorageConfiguration"))
636
+ UpdateStreamStorageConfigurationInput.struct_class = Types::UpdateStreamStorageConfigurationInput
637
+
638
+ UpdateStreamStorageConfigurationOutput.struct_class = Types::UpdateStreamStorageConfigurationOutput
639
+
613
640
  UploaderConfig.add_member(:schedule_config, Shapes::ShapeRef.new(shape: ScheduleConfig, required: true, location_name: "ScheduleConfig"))
614
641
  UploaderConfig.struct_class = Types::UploaderConfig
615
642
 
@@ -796,6 +823,18 @@ module Aws::KinesisVideo
796
823
  o.errors << Shapes::ShapeRef.new(shape: NotAuthorizedException)
797
824
  end)
798
825
 
826
+ api.add_operation(:describe_stream_storage_configuration, Seahorse::Model::Operation.new.tap do |o|
827
+ o.name = "DescribeStreamStorageConfiguration"
828
+ o.http_method = "POST"
829
+ o.http_request_uri = "/describeStreamStorageConfiguration"
830
+ o.input = Shapes::ShapeRef.new(shape: DescribeStreamStorageConfigurationInput)
831
+ o.output = Shapes::ShapeRef.new(shape: DescribeStreamStorageConfigurationOutput)
832
+ o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
833
+ o.errors << Shapes::ShapeRef.new(shape: ClientLimitExceededException)
834
+ o.errors << Shapes::ShapeRef.new(shape: InvalidArgumentException)
835
+ o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
836
+ end)
837
+
799
838
  api.add_operation(:get_data_endpoint, Seahorse::Model::Operation.new.tap do |o|
800
839
  o.name = "GetDataEndpoint"
801
840
  o.http_method = "POST"
@@ -1045,6 +1084,20 @@ module Aws::KinesisVideo
1045
1084
  o.errors << Shapes::ShapeRef.new(shape: NotAuthorizedException)
1046
1085
  o.errors << Shapes::ShapeRef.new(shape: VersionMismatchException)
1047
1086
  end)
1087
+
1088
+ api.add_operation(:update_stream_storage_configuration, Seahorse::Model::Operation.new.tap do |o|
1089
+ o.name = "UpdateStreamStorageConfiguration"
1090
+ o.http_method = "POST"
1091
+ o.http_request_uri = "/updateStreamStorageConfiguration"
1092
+ o.input = Shapes::ShapeRef.new(shape: UpdateStreamStorageConfigurationInput)
1093
+ o.output = Shapes::ShapeRef.new(shape: UpdateStreamStorageConfigurationOutput)
1094
+ o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
1095
+ o.errors << Shapes::ShapeRef.new(shape: ClientLimitExceededException)
1096
+ o.errors << Shapes::ShapeRef.new(shape: InvalidArgumentException)
1097
+ o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
1098
+ o.errors << Shapes::ShapeRef.new(shape: ResourceInUseException)
1099
+ o.errors << Shapes::ShapeRef.new(shape: VersionMismatchException)
1100
+ end)
1048
1101
  end
1049
1102
 
1050
1103
  end
@@ -147,7 +147,8 @@ module Aws::KinesisVideo
147
147
  #
148
148
  # @!attribute [rw] single_master_configuration
149
149
  # A structure containing the configuration for the `SINGLE_MASTER`
150
- # channel type.
150
+ # channel type. The default configuration for the channel message's
151
+ # time to live is 60 seconds (1 minute).
151
152
  # @return [Types::SingleMasterConfiguration]
152
153
  #
153
154
  # @!attribute [rw] tags
@@ -181,7 +182,7 @@ module Aws::KinesisVideo
181
182
  # @!attribute [rw] device_name
182
183
  # The name of the device that is writing to the stream.
183
184
  #
184
- # <note markdown="1"> In the current implementation, Kinesis Video Streams does not use
185
+ # <note markdown="1"> In the current implementation, Kinesis Video Streams doesn't use
185
186
  # this name.
186
187
  #
187
188
  # </note>
@@ -217,7 +218,7 @@ module Aws::KinesisVideo
217
218
  # Video Streams to use to encrypt stream data.
218
219
  #
219
220
  # If no key ID is specified, the default, Kinesis Video-managed key
220
- # (`Amazon Web Services/kinesisvideo`) is used.
221
+ # (`aws/kinesisvideo`) is used.
221
222
  #
222
223
  # For more information, see [DescribeKey][1].
223
224
  #
@@ -232,7 +233,7 @@ module Aws::KinesisVideo
232
233
  # associated with the stream.
233
234
  #
234
235
  # The default value is 0, indicating that the stream does not persist
235
- # data.
236
+ # data. The minimum is 1 hour.
236
237
  #
237
238
  # When the `DataRetentionInHours` value is 0, consumers can still
238
239
  # consume the fragments that remain in the service host buffer, which
@@ -246,6 +247,16 @@ module Aws::KinesisVideo
246
247
  # key-value pair (the value is optional).
247
248
  # @return [Hash<String,String>]
248
249
  #
250
+ # @!attribute [rw] stream_storage_configuration
251
+ # The configuration for the stream's storage, including the default
252
+ # storage tier for stream data. This configuration determines how
253
+ # stream data is stored and accessed, with different tiers offering
254
+ # varying levels of performance and cost optimization.
255
+ #
256
+ # If not specified, the stream will use the default storage
257
+ # configuration with HOT tier for optimal performance.
258
+ # @return [Types::StreamStorageConfiguration]
259
+ #
249
260
  # @see http://docs.aws.amazon.com/goto/WebAPI/kinesisvideo-2017-09-30/CreateStreamInput AWS API Documentation
250
261
  #
251
262
  class CreateStreamInput < Struct.new(
@@ -254,7 +265,8 @@ module Aws::KinesisVideo
254
265
  :media_type,
255
266
  :kms_key_id,
256
267
  :data_retention_in_hours,
257
- :tags)
268
+ :tags,
269
+ :stream_storage_configuration)
258
270
  SENSITIVE = []
259
271
  include Aws::Structure
260
272
  end
@@ -664,6 +676,48 @@ module Aws::KinesisVideo
664
676
  include Aws::Structure
665
677
  end
666
678
 
679
+ # @!attribute [rw] stream_name
680
+ # The name of the stream for which you want to retrieve the storage
681
+ # configuration.
682
+ # @return [String]
683
+ #
684
+ # @!attribute [rw] stream_arn
685
+ # The Amazon Resource Name (ARN) of the stream for which you want to
686
+ # retrieve the storage configuration.
687
+ # @return [String]
688
+ #
689
+ # @see http://docs.aws.amazon.com/goto/WebAPI/kinesisvideo-2017-09-30/DescribeStreamStorageConfigurationInput AWS API Documentation
690
+ #
691
+ class DescribeStreamStorageConfigurationInput < Struct.new(
692
+ :stream_name,
693
+ :stream_arn)
694
+ SENSITIVE = []
695
+ include Aws::Structure
696
+ end
697
+
698
+ # @!attribute [rw] stream_name
699
+ # The name of the stream.
700
+ # @return [String]
701
+ #
702
+ # @!attribute [rw] stream_arn
703
+ # The Amazon Resource Name (ARN) of the stream.
704
+ # @return [String]
705
+ #
706
+ # @!attribute [rw] stream_storage_configuration
707
+ # The current storage configuration for the stream, including the
708
+ # default storage tier and other storage-related settings.
709
+ # @return [Types::StreamStorageConfiguration]
710
+ #
711
+ # @see http://docs.aws.amazon.com/goto/WebAPI/kinesisvideo-2017-09-30/DescribeStreamStorageConfigurationOutput AWS API Documentation
712
+ #
713
+ class DescribeStreamStorageConfigurationOutput < Struct.new(
714
+ :stream_name,
715
+ :stream_arn,
716
+ :stream_storage_configuration)
717
+ SENSITIVE = []
718
+ include Aws::Structure
719
+ end
720
+
667
721
  # Not implemented.
668
722
  #
669
723
  # @!attribute [rw] message
@@ -1400,9 +1454,16 @@ module Aws::KinesisVideo
1400
1454
  include Aws::Structure
1401
1455
  end
1402
1456
 
1403
- # The structure that contains the notification information for the KVS
1404
- # images delivery. If this parameter is null, the configuration will be
1405
- # deleted from the stream.
1457
+ # Use this API to configure Amazon Simple Notification Service (Amazon
1458
+ # SNS) notifications for when fragments become available in a stream. If
1459
+ # this parameter is null, the configuration will be deleted from the
1460
+ # stream.
1461
+ #
1462
+ # See [Notifications in Kinesis Video Streams][1] for more information.
1463
+ #
1464
+ #
1465
+ #
1466
+ # [1]: https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/notifications.html
1406
1467
  #
1407
1468
  # @!attribute [rw] status
1408
1469
  # Indicates if a notification configuration is enabled or disabled.
@@ -1439,7 +1500,7 @@ module Aws::KinesisVideo
1439
1500
  end
1440
1501
 
1441
1502
  # The recorder configuration consists of the local `MediaSourceConfig`
1442
- # details that are used as credentials to accesss the local media files
1503
+ # details that are used as credentials to access the local media files
1443
1504
  # streamed on the camera.
1444
1505
  #
1445
1506
  # @!attribute [rw] media_source_config
@@ -1550,7 +1611,7 @@ module Aws::KinesisVideo
1550
1611
  #
1551
1612
  #
1552
1613
  #
1553
- # [1]: http://www.quartz-scheduler.org/documentation/quartz-2.3.0/tutorials/crontrigger.html
1614
+ # [1]: https://www.quartz-scheduler.org/documentation/quartz-2.3.0/tutorials/crontrigger.html
1554
1615
  # @return [String]
1555
1616
  #
1556
1617
  # @!attribute [rw] duration_in_seconds
@@ -1601,8 +1662,9 @@ module Aws::KinesisVideo
1601
1662
  # channel type.
1602
1663
  #
1603
1664
  # @!attribute [rw] message_ttl_seconds
1604
- # The period of time a signaling channel retains undelivered messages
1605
- # before they are discarded.
1665
+ # The period of time (in seconds) a signaling channel retains
1666
+ # undelivered messages before they are discarded. Use to update this
1667
+ # value.
1606
1668
  # @return [Integer]
1607
1669
  #
1608
1670
  # @see http://docs.aws.amazon.com/goto/WebAPI/kinesisvideo-2017-09-30/SingleMasterConfiguration AWS API Documentation
@@ -1782,6 +1844,35 @@ module Aws::KinesisVideo
1782
1844
  include Aws::Structure
1783
1845
  end
1784
1846
 
1847
+ # The configuration for stream storage, including the default storage
1848
+ # tier for stream data. This configuration determines how stream data is
1849
+ # stored and accessed, with different tiers offering varying levels of
1850
+ # performance and cost optimization.
1851
+ #
1852
+ # @!attribute [rw] default_storage_tier
1853
+ # The default storage tier for the stream data. This setting
1854
+ # determines the storage class used for stream data, affecting both
1855
+ # performance characteristics and storage costs.
1856
+ #
1857
+ # Available storage tiers:
1858
+ #
1859
+ # * `HOT` - Optimized for frequent access with the lowest latency and
1860
+ # highest performance. Ideal for real-time applications and
1861
+ # frequently accessed data.
1862
+ #
1863
+ # * `WARM` - Balanced performance and cost for moderately accessed
1864
+ # data. Suitable for data that is accessed regularly but not
1865
+ # continuously.
1866
+ # @return [String]
1867
+ #
1868
+ # @see http://docs.aws.amazon.com/goto/WebAPI/kinesisvideo-2017-09-30/StreamStorageConfiguration AWS API Documentation
1869
+ #
1870
+ class StreamStorageConfiguration < Struct.new(
1871
+ :default_storage_tier)
1872
+ SENSITIVE = []
1873
+ include Aws::Structure
1874
+ end
1875
+
1785
1876
  # A key and value pair that is associated with the specified signaling
1786
1877
  # channel.
1787
1878
  #
@@ -2061,7 +2152,9 @@ module Aws::KinesisVideo
2061
2152
  #
2062
2153
  # @!attribute [rw] single_master_configuration
2063
2154
  # The structure containing the configuration for the `SINGLE_MASTER`
2064
- # type of the signaling channel that you want to update.
2155
+ # type of the signaling channel that you want to update. This
2156
+ # parameter and the channel message's time-to-live are required for
2157
+ # channels with the `SINGLE_MASTER` channel type.
2065
2158
  # @return [Types::SingleMasterConfiguration]
2066
2159
  #
2067
2160
  # @see http://docs.aws.amazon.com/goto/WebAPI/kinesisvideo-2017-09-30/UpdateSignalingChannelInput AWS API Documentation
@@ -2134,6 +2227,46 @@ module Aws::KinesisVideo
2134
2227
  #
2135
2228
  class UpdateStreamOutput < Aws::EmptyStructure; end
2136
2229
 
2230
+ # @!attribute [rw] stream_name
2231
+ # The name of the stream for which you want to update the storage
2232
+ # configuration.
2233
+ # @return [String]
2234
+ #
2235
+ # @!attribute [rw] stream_arn
2236
+ # The Amazon Resource Name (ARN) of the stream for which you want to
2237
+ # update the storage configuration.
2238
+ # @return [String]
2239
+ #
2240
+ # @!attribute [rw] current_version
2241
+ # The version of the stream whose storage configuration you want to
2242
+ # change. To get the version, call either the `DescribeStream` or the
2243
+ # `ListStreams` API.
2244
+ # @return [String]
2245
+ #
2246
+ # @!attribute [rw] stream_storage_configuration
2247
+ # The new storage configuration for the stream. This includes the
2248
+ # default storage tier that determines how stream data is stored and
2249
+ # accessed.
2250
+ #
2251
+ # Different storage tiers offer varying levels of performance and cost
2252
+ # optimization to match your specific use case requirements.
2253
+ # @return [Types::StreamStorageConfiguration]
2254
+ #
2255
+ # @see http://docs.aws.amazon.com/goto/WebAPI/kinesisvideo-2017-09-30/UpdateStreamStorageConfigurationInput AWS API Documentation
2256
+ #
2257
+ class UpdateStreamStorageConfigurationInput < Struct.new(
2258
+ :stream_name,
2259
+ :stream_arn,
2260
+ :current_version,
2261
+ :stream_storage_configuration)
2262
+ SENSITIVE = []
2263
+ include Aws::Structure
2264
+ end
2265
+
2266
+ # @see http://docs.aws.amazon.com/goto/WebAPI/kinesisvideo-2017-09-30/UpdateStreamStorageConfigurationOutput AWS API Documentation
2267
+ #
2268
+ class UpdateStreamStorageConfigurationOutput < Aws::EmptyStructure; end
2269
+
2137
2270
  # The configuration that consists of the `ScheduleExpression` and the
2138
2271
  # `DurationInMinutes` details that specify the scheduling to record from
2139
2272
  # a camera, or local media file, onto the Edge Agent. If the
@@ -54,7 +54,7 @@ module Aws::KinesisVideo
54
54
  autoload :EndpointProvider, 'aws-sdk-kinesisvideo/endpoint_provider'
55
55
  autoload :Endpoints, 'aws-sdk-kinesisvideo/endpoints'
56
56
 
57
- GEM_VERSION = '1.87.0'
57
+ GEM_VERSION = '1.88.0'
58
58
 
59
59
  end
60
60
 
data/sig/client.rbs CHANGED
@@ -109,7 +109,10 @@ module Aws
109
109
  ?media_type: ::String,
110
110
  ?kms_key_id: ::String,
111
111
  ?data_retention_in_hours: ::Integer,
112
- ?tags: Hash[::String, ::String]
112
+ ?tags: Hash[::String, ::String],
113
+ ?stream_storage_configuration: {
114
+ default_storage_tier: ("HOT" | "WARM")
115
+ }
113
116
  ) -> _CreateStreamResponseSuccess
114
117
  | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateStreamResponseSuccess
115
118
 
@@ -230,6 +233,19 @@ module Aws
230
233
  ) -> _DescribeStreamResponseSuccess
231
234
  | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _DescribeStreamResponseSuccess
232
235
 
236
+ interface _DescribeStreamStorageConfigurationResponseSuccess
237
+ include ::Seahorse::Client::_ResponseSuccess[Types::DescribeStreamStorageConfigurationOutput]
238
+ def stream_name: () -> ::String
239
+ def stream_arn: () -> ::String
240
+ def stream_storage_configuration: () -> Types::StreamStorageConfiguration
241
+ end
242
+ # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/KinesisVideo/Client.html#describe_stream_storage_configuration-instance_method
243
+ def describe_stream_storage_configuration: (
244
+ ?stream_name: ::String,
245
+ ?stream_arn: ::String
246
+ ) -> _DescribeStreamStorageConfigurationResponseSuccess
247
+ | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _DescribeStreamStorageConfigurationResponseSuccess
248
+
233
249
  interface _GetDataEndpointResponseSuccess
234
250
  include ::Seahorse::Client::_ResponseSuccess[Types::GetDataEndpointOutput]
235
251
  def data_endpoint: () -> ::String
@@ -507,6 +523,20 @@ module Aws
507
523
  ?media_type: ::String
508
524
  ) -> _UpdateStreamResponseSuccess
509
525
  | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdateStreamResponseSuccess
526
+
527
+ interface _UpdateStreamStorageConfigurationResponseSuccess
528
+ include ::Seahorse::Client::_ResponseSuccess[Types::UpdateStreamStorageConfigurationOutput]
529
+ end
530
+ # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/KinesisVideo/Client.html#update_stream_storage_configuration-instance_method
531
+ def update_stream_storage_configuration: (
532
+ ?stream_name: ::String,
533
+ ?stream_arn: ::String,
534
+ current_version: ::String,
535
+ stream_storage_configuration: {
536
+ default_storage_tier: ("HOT" | "WARM")
537
+ }
538
+ ) -> _UpdateStreamStorageConfigurationResponseSuccess
539
+ | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdateStreamStorageConfigurationResponseSuccess
510
540
  end
511
541
  end
512
542
  end
data/sig/types.rbs CHANGED
@@ -65,6 +65,7 @@ module Aws::KinesisVideo
65
65
  attr_accessor kms_key_id: ::String
66
66
  attr_accessor data_retention_in_hours: ::Integer
67
67
  attr_accessor tags: ::Hash[::String, ::String]
68
+ attr_accessor stream_storage_configuration: Types::StreamStorageConfiguration
68
69
  SENSITIVE: []
69
70
  end
70
71
 
@@ -194,6 +195,19 @@ module Aws::KinesisVideo
194
195
  SENSITIVE: []
195
196
  end
196
197
 
198
+ class DescribeStreamStorageConfigurationInput
199
+ attr_accessor stream_name: ::String
200
+ attr_accessor stream_arn: ::String
201
+ SENSITIVE: []
202
+ end
203
+
204
+ class DescribeStreamStorageConfigurationOutput
205
+ attr_accessor stream_name: ::String
206
+ attr_accessor stream_arn: ::String
207
+ attr_accessor stream_storage_configuration: Types::StreamStorageConfiguration
208
+ SENSITIVE: []
209
+ end
210
+
197
211
  class DeviceStreamLimitExceededException
198
212
  attr_accessor message: ::String
199
213
  SENSITIVE: []
@@ -486,6 +500,11 @@ module Aws::KinesisVideo
486
500
  SENSITIVE: []
487
501
  end
488
502
 
503
+ class StreamStorageConfiguration
504
+ attr_accessor default_storage_tier: ("HOT" | "WARM")
505
+ SENSITIVE: []
506
+ end
507
+
489
508
  class Tag
490
509
  attr_accessor key: ::String
491
510
  attr_accessor value: ::String
@@ -598,6 +617,17 @@ module Aws::KinesisVideo
598
617
  class UpdateStreamOutput < Aws::EmptyStructure
599
618
  end
600
619
 
620
+ class UpdateStreamStorageConfigurationInput
621
+ attr_accessor stream_name: ::String
622
+ attr_accessor stream_arn: ::String
623
+ attr_accessor current_version: ::String
624
+ attr_accessor stream_storage_configuration: Types::StreamStorageConfiguration
625
+ SENSITIVE: []
626
+ end
627
+
628
+ class UpdateStreamStorageConfigurationOutput < Aws::EmptyStructure
629
+ end
630
+
601
631
  class UploaderConfig
602
632
  attr_accessor schedule_config: Types::ScheduleConfig
603
633
  SENSITIVE: []
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-kinesisvideo
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.87.0
4
+ version: 1.88.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
@@ -18,7 +18,7 @@ dependencies:
18
18
  version: '3'
19
19
  - - ">="
20
20
  - !ruby/object:Gem::Version
21
- version: 3.234.0
21
+ version: 3.239.1
22
22
  type: :runtime
23
23
  prerelease: false
24
24
  version_requirements: !ruby/object:Gem::Requirement
@@ -28,7 +28,7 @@ dependencies:
28
28
  version: '3'
29
29
  - - ">="
30
30
  - !ruby/object:Gem::Version
31
- version: 3.234.0
31
+ version: 3.239.1
32
32
  - !ruby/object:Gem::Dependency
33
33
  name: aws-sigv4
34
34
  requirement: !ruby/object:Gem::Requirement