aws-sdk-kinesisvideoarchivedmedia 1.51.0 → 1.52.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 24a51a31fbe9db6a0ab029b515536276dfee7be7cdac7e9a1a615b11f8ed14b2
-  data.tar.gz: b59497525aa03a3c289a56cc84cdb80024ef0440b72463d0c5f1cdd9e752e5e7
+  metadata.gz: b53d21917eca8d295756648a6bff660448f5f65aac0c9b2b224e5359e1b70a48
+  data.tar.gz: 7927000d7452d8781e2471b79b8e4de44970994a1156cb03ad0d1437460ff637
 SHA512:
-  metadata.gz: b65573829a8b7faa72865b6d71720d32fc1489b612fdda4c9e6cef3a652b5b1dfe7eba410aed492fa09bd44d8f36c7cdc28f43309e3cbc8d98540ef20e3aa496
-  data.tar.gz: e72f211705f67658fcdf257000b319a2bd293d76a569b95a95007212af34a6b40124c004dc8e4d5f8294c5a9f6ae75a4cef5272d8c49b248a92d328536d2269a
+  metadata.gz: ff6b05e888d8a13fb2e8138f80506a648e4ff0c2367094310bcc5005671b096786c818bc738ac21f29259bb832613c63ca5d8e5fc74765934a2ce69990078de2
+  data.tar.gz: 85b6d38cb7d510e9008dd9fab304243200d60501de1734d94e9cee8d9ad010a3728e4a89525a19a7c8d45fe8c2cc43301eb1e5c563875315d323b8beca33b800

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.52.0 (2023-08-07)
+------------------
+
+* Feature - This release enables minimum of Images SamplingInterval to be as low as 200 milliseconds in Kinesis Video Stream Image feature.
+
 1.51.0 (2023-07-11)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.51.0
+1.52.0

data/lib/aws-sdk-kinesisvideoarchivedmedia/client.rb

@@ -414,8 +414,8 @@ module Aws::KinesisVideoArchivedMedia
     # the GetClip.OutgoingBytes Amazon CloudWatch metric. For information
     # about using CloudWatch to monitor Kinesis Video Streams, see
     # Monitoring Kinesis Video Streams. For pricing information, see Amazon
-    # Kinesis Video Streams Pricing and AWS Pricing. Charges for outgoing
-    # AWS data apply.
+    # Kinesis Video Streams Pricing and  Amazon Web Services Pricing.
+    # Charges for outgoing Amazon Web Services data apply.
     # `
     #
     # @option params [String] :stream_name
@@ -511,7 +511,7 @@ module Aws::KinesisVideoArchivedMedia
     #     <note markdown="1"> Don't share or store this token where an unauthorized entity can
     #     access it. The token provides access to the content of the stream.
     #     Safeguard the token with the same measures that you use with your
-    #     AWS credentials.
+    #     Amazon Web Services credentials.
     #
     #      </note>
     #
@@ -574,9 +574,9 @@ module Aws::KinesisVideoArchivedMedia
     # monitoring the `GetMP4MediaFragment.OutgoingBytes` Amazon CloudWatch
     # metric. For information about using CloudWatch to monitor Kinesis
     # Video Streams, see [Monitoring Kinesis Video Streams][8]. For pricing
-    # information, see [Amazon Kinesis Video Streams Pricing][6] and [AWS
-    # Pricing][9]. Charges for both HLS sessions and outgoing AWS data
-    # apply.
+    # information, see [Amazon Kinesis Video Streams Pricing][6] and [Amazon
+    # Web Services Pricing][9]. Charges for both HLS sessions and outgoing
+    # Amazon Web Services data apply.
     #
     # For more information about HLS, see [HTTP Live Streaming][10] on the
     # [Apple Developer site][11].
@@ -589,8 +589,8 @@ module Aws::KinesisVideoArchivedMedia
     #   in addition to what the HTTP status code provides.
     #
     # * `x-amz-RequestId` HTTP header – if you want to report an issue to
-    #   AWS, the support team can better diagnose the problem if given the
-    #   Request Id.
+    #   Amazon Web Services the support team can better diagnose the problem
+    #   if given the Request Id.
     #
     #  Both the HTTP status code and the ErrorType header can be utilized to
     # make programmatic decisions about whether errors are retry-able and
@@ -806,10 +806,12 @@ module Aws::KinesisVideoArchivedMedia
     # An Amazon Kinesis video stream has the following requirements for
     # providing data through HLS:
     #
-    # * The media must contain h.264 or h.265 encoded video and, optionally,
-    #   AAC encoded audio. Specifically, the codec ID of track 1 should be
-    #   `V_MPEG/ISO/AVC` (for h.264) or `V_MPEG/ISO/HEVC` (for h.265).
-    #   Optionally, the codec ID of track 2 should be `A_AAC`.
+    # * For streaming video, the media must contain H.264 or H.265 encoded
+    #   video and, optionally, AAC encoded audio. Specifically, the codec ID
+    #   of track 1 should be `V_MPEG/ISO/AVC` (for H.264) or
+    #   `V_MPEG/ISO/HEVC` (for H.265). Optionally, the codec ID of track 2
+    #   should be `A_AAC`. For audio only streaming, the codec ID of track 1
+    #   should be `A_AAC`.
     #
     # * Data retention must be greater than 0.
     #
@@ -845,7 +847,7 @@ module Aws::KinesisVideoArchivedMedia
     #     <note markdown="1"> Don't share or store this token where an unauthorized entity
     #     could access it. The token provides access to the content of the
     #     stream. Safeguard the token with the same measures that you would
-    #     use with your AWS credentials.
+    #     use with your Amazon Web Services credentials.
     #
     #      </note>
     #
@@ -901,18 +903,23 @@ module Aws::KinesisVideoArchivedMedia
     #       their child atoms, containing the encoded fragment's media
     #       frames and their timestamps.
     #
-    #       <note markdown="1"> After the first media fragment is made available in a streaming
-    #       session, any fragments that don't contain the same codec
-    #       private data cause an error to be returned when those different
-    #       media fragments are loaded. Therefore, the codec private data
-    #       should not change between fragments in a session. This also
-    #       means that the session fails if the fragments in a stream change
-    #       from having only video to having both audio and video.
+    #       <note markdown="1"> For the HLS streaming session, in-track codec private data (CPD)
+    #       changes are supported. After the first media fragment is made
+    #       available in a streaming session, fragments can contain CPD
+    #       changes for each track. Therefore, the fragments in a session
+    #       can have a different resolution, bit rate, or other information
+    #       in the CPD without interrupting playback. However, any change
+    #       made in the track number or track codec format can return an
+    #       error when those different media fragments are loaded. For
+    #       example, streaming will fail if the fragments in the stream
+    #       change from having only video to having both audio and video, or
+    #       if an AAC audio track is changed to an ALAW audio track. For
+    #       each streaming session, only 500 CPD changes are allowed.
     #
     #        </note>
     #
-    #       Data retrieved with this action is billable. See [Pricing][6]
-    #       for details.
+    #       Data retrieved with this action is billable. For information,
+    #       see [Pricing][6].
     #
     #     * **GetTSFragment:** Retrieves MPEG TS fragments containing both
     #       initialization and media data for all tracks in the stream.
@@ -934,9 +941,9 @@ module Aws::KinesisVideoArchivedMedia
     # monitoring the `GetMP4MediaFragment.OutgoingBytes` Amazon CloudWatch
     # metric. For information about using CloudWatch to monitor Kinesis
     # Video Streams, see [Monitoring Kinesis Video Streams][8]. For pricing
-    # information, see [Amazon Kinesis Video Streams Pricing][6] and [AWS
-    # Pricing][9]. Charges for both HLS sessions and outgoing AWS data
-    # apply.
+    # information, see [Amazon Kinesis Video Streams Pricing][6] and [Amazon
+    # Web Services Pricing][9]. Charges for both HLS sessions and outgoing
+    # Amazon Web Services data apply.
     #
     # For more information about HLS, see [HTTP Live Streaming][10] on the
     # [Apple Developer site][11].
@@ -949,8 +956,8 @@ module Aws::KinesisVideoArchivedMedia
     #   in addition to what the HTTP status code provides.
     #
     # * `x-amz-RequestId` HTTP header – if you want to report an issue to
-    #   AWS, the support team can better diagnose the problem if given the
-    #   Request Id.
+    #   Amazon Web Services, the support team can better diagnose the
+    #   problem if given the Request Id.
     #
     #  Both the HTTP status code and the ErrorType header can be utilized to
     # make programmatic decisions about whether errors are retry-able and
@@ -1214,16 +1221,19 @@ module Aws::KinesisVideoArchivedMedia
     #   an image to be returned.
     #
     # @option params [required, Time,DateTime,Date,Integer,String] :end_timestamp
-    #   The end timestamp for the range of images to be generated.
+    #   The end timestamp for the range of images to be generated. If the time
+    #   range between `StartTimestamp` and `EndTimestamp` is more than 300
+    #   seconds above `StartTimestamp`, you will receive an
+    #   `IllegalArgumentException`.
     #
-    # @option params [required, Integer] :sampling_interval
+    # @option params [Integer] :sampling_interval
     #   The time interval in milliseconds (ms) at which the images need to be
-    #   generated from the stream. The minimum value that can be provided is
-    #   3000 ms. If the timestamp range is less than the sampling interval,
-    #   the Image from the `startTimestamp` will be returned if available.
+    #   generated from the stream, with a default of 3000 ms. The minimum
+    #   value that can be provided is 200 ms. If the timestamp range is less
+    #   than the sampling interval, the Image from the `startTimestamp` will
+    #   be returned if available.
     #
-    #   <note markdown="1"> The minimum value of 3000 ms is a soft limit. If needed, a lower
-    #   sampling frequency can be requested.
+    #   <note markdown="1"> The minimum value of 200 ms is a hard limit.
     #
     #    </note>
     #
@@ -1262,8 +1272,9 @@ module Aws::KinesisVideoArchivedMedia
     # @option params [Integer] :max_results
     #   The maximum number of images to be returned by the API.
     #
-    #   <note markdown="1"> The default limit is 100 images per API response. The additional
-    #   results will be paginated.
+    #   <note markdown="1"> The default limit is 25 images per API response. Providing a
+    #   `MaxResults` greater than this value will result in a page size of 25.
+    #   Any additional results will be paginated.
     #
     #    </note>
     #
@@ -1287,7 +1298,7 @@ module Aws::KinesisVideoArchivedMedia
     #     image_selector_type: "PRODUCER_TIMESTAMP", # required, accepts PRODUCER_TIMESTAMP, SERVER_TIMESTAMP
     #     start_timestamp: Time.now, # required
     #     end_timestamp: Time.now, # required
-    #     sampling_interval: 1, # required
+    #     sampling_interval: 1,
     #     format: "JPEG", # required, accepts JPEG, PNG
     #     format_config: {
     #       "JPEGQuality" => "FormatConfigValue",
@@ -1334,8 +1345,8 @@ module Aws::KinesisVideoArchivedMedia
     #   in addition to what the HTTP status code provides.
     #
     # * `x-amz-RequestId` HTTP header – if you want to report an issue to
-    #   AWS, the support team can better diagnose the problem if given the
-    #   Request Id.
+    #   Amazon Web Services, the support team can better diagnose the
+    #   problem if given the Request Id.
     #
     #  Both the HTTP status code and the ErrorType header can be utilized to
     # make programmatic decisions about whether errors are retry-able and
@@ -1416,8 +1427,8 @@ module Aws::KinesisVideoArchivedMedia
     #   in addition to what the HTTP status code provides.
     #
     # * `x-amz-RequestId` HTTP header – if you want to report an issue to
-    #   AWS, the support team can better diagnose the problem if given the
-    #   Request Id.
+    #   Amazon Web Services, the support team can better diagnose the
+    #   problem if given the Request Id.
     #
     #  Both the HTTP status code and the ErrorType header can be utilized to
     # make programmatic decisions about whether errors are retry-able and
@@ -1512,7 +1523,7 @@ module Aws::KinesisVideoArchivedMedia
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-kinesisvideoarchivedmedia'
-      context[:gem_version] = '1.51.0'
+      context[:gem_version] = '1.52.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-kinesisvideoarchivedmedia/client_api.rb

@@ -165,7 +165,7 @@ module Aws::KinesisVideoArchivedMedia
     GetImagesInput.add_member(:image_selector_type, Shapes::ShapeRef.new(shape: ImageSelectorType, required: true, location_name: "ImageSelectorType"))
     GetImagesInput.add_member(:start_timestamp, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "StartTimestamp"))
     GetImagesInput.add_member(:end_timestamp, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "EndTimestamp"))
-    GetImagesInput.add_member(:sampling_interval, Shapes::ShapeRef.new(shape: SamplingInterval, required: true, location_name: "SamplingInterval"))
+    GetImagesInput.add_member(:sampling_interval, Shapes::ShapeRef.new(shape: SamplingInterval, location_name: "SamplingInterval"))
     GetImagesInput.add_member(:format, Shapes::ShapeRef.new(shape: Format, required: true, location_name: "Format"))
     GetImagesInput.add_member(:format_config, Shapes::ShapeRef.new(shape: FormatConfig, location_name: "FormatConfig"))
     GetImagesInput.add_member(:width_pixels, Shapes::ShapeRef.new(shape: WidthPixels, location_name: "WidthPixels"))

data/lib/aws-sdk-kinesisvideoarchivedmedia/endpoint_provider.rb

@@ -14,36 +14,39 @@ module Aws::KinesisVideoArchivedMedia
       use_dual_stack = parameters.use_dual_stack
       use_fips = parameters.use_fips
       endpoint = parameters.endpoint
-      if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
-        if Aws::Endpoints::Matchers.set?(endpoint) && (url = Aws::Endpoints::Matchers.parse_url(endpoint))
-          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-            raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
-          end
-          if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-            raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
-          end
-          return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
-        end
-        if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-            return Aws::Endpoints::Endpoint.new(url: "https://kinesisvideo-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
-          end
-          raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
-        end
+      if Aws::Endpoints::Matchers.set?(endpoint)
         if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
-            return Aws::Endpoints::Endpoint.new(url: "https://kinesisvideo-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
-          end
-          raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
+          raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
         end
         if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-            return Aws::Endpoints::Endpoint.new(url: "https://kinesisvideo.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+          raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
+        end
+        return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
+      end
+      if Aws::Endpoints::Matchers.set?(region)
+        if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
+          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
+              return Aws::Endpoints::Endpoint.new(url: "https://kinesisvideo-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
+          end
+          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
+              return Aws::Endpoints::Endpoint.new(url: "https://kinesisvideo-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
+          end
+          if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
+              return Aws::Endpoints::Endpoint.new(url: "https://kinesisvideo.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
           end
-          raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
+          return Aws::Endpoints::Endpoint.new(url: "https://kinesisvideo.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
         end
-        return Aws::Endpoints::Endpoint.new(url: "https://kinesisvideo.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
       end
+      raise ArgumentError, "Invalid Configuration: Missing Region"
       raise ArgumentError, 'No endpoint could be resolved'
 
     end

data/lib/aws-sdk-kinesisvideoarchivedmedia/types.rb

@@ -212,7 +212,8 @@ module Aws::KinesisVideoArchivedMedia
     #   @return [Time]
     #
     # @!attribute [rw] server_timestamp
-    #   The timestamp from the AWS server corresponding to the fragment.
+    #   The timestamp from the Amazon Web Services server corresponding to
+    #   the fragment.
     #   @return [Time]
     #
     # @!attribute [rw] fragment_length_in_milliseconds
@@ -744,18 +745,20 @@ module Aws::KinesisVideoArchivedMedia
     #   @return [Time]
     #
     # @!attribute [rw] end_timestamp
-    #   The end timestamp for the range of images to be generated.
+    #   The end timestamp for the range of images to be generated. If the
+    #   time range between `StartTimestamp` and `EndTimestamp` is more than
+    #   300 seconds above `StartTimestamp`, you will receive an
+    #   `IllegalArgumentException`.
     #   @return [Time]
     #
     # @!attribute [rw] sampling_interval
     #   The time interval in milliseconds (ms) at which the images need to
-    #   be generated from the stream. The minimum value that can be provided
-    #   is 3000 ms. If the timestamp range is less than the sampling
-    #   interval, the Image from the `startTimestamp` will be returned if
-    #   available.
+    #   be generated from the stream, with a default of 3000 ms. The minimum
+    #   value that can be provided is 200 ms. If the timestamp range is less
+    #   than the sampling interval, the Image from the `startTimestamp` will
+    #   be returned if available.
     #
-    #   <note markdown="1"> The minimum value of 3000 ms is a soft limit. If needed, a lower
-    #   sampling frequency can be requested.
+    #   <note markdown="1"> The minimum value of 200 ms is a hard limit.
     #
     #    </note>
     #   @return [Integer]
@@ -799,8 +802,9 @@ module Aws::KinesisVideoArchivedMedia
     # @!attribute [rw] max_results
     #   The maximum number of images to be returned by the API.
     #
-    #   <note markdown="1"> The default limit is 100 images per API response. The additional
-    #   results will be paginated.
+    #   <note markdown="1"> The default limit is 25 images per API response. Providing a
+    #   `MaxResults` greater than this value will result in a page size of
+    #   25. Any additional results will be paginated.
     #
     #    </note>
     #   @return [Integer]
@@ -903,7 +907,7 @@ module Aws::KinesisVideoArchivedMedia
     #     that threw the exception
     #
     #   * AWS\_KINESISVIDEO\_EXCEPTION\_ERROR\_CODE - The integer code of
-    #     the exception
+    #     the
     #
     #   * AWS\_KINESISVIDEO\_EXCEPTION\_MESSAGE - A text description of the
     #     exception
@@ -1204,8 +1208,8 @@ module Aws::KinesisVideoArchivedMedia
       include Aws::Structure
     end
 
-    # `GetMedia` throws this error when Kinesis Video Streams can't find
-    # the stream that you specified.
+    # `GetImages` will throw this error when Kinesis Video Streams can't
+    # find the stream that you specified.
     #
     # `GetHLSStreamingSessionURL` and `GetDASHStreamingSessionURL` throw
     # this error if a session with a `PlaybackMode` of `ON_DEMAND` or

data/lib/aws-sdk-kinesisvideoarchivedmedia.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-kinesisvideoarchivedmedia/customizations'
 # @!group service
 module Aws::KinesisVideoArchivedMedia
 
-  GEM_VERSION = '1.51.0'
+  GEM_VERSION = '1.52.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-kinesisvideoarchivedmedia
 version: !ruby/object:Gem::Version
-  version: 1.51.0
+  version: 1.52.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-07-11 00:00:00.000000000 Z
+date: 2023-08-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core