aws-sdk-kinesisvideoarchivedmedia 1.21.0 → 1.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 51296e836336e18d14c687350a8f1af34e0329ee
-  data.tar.gz: 9bb0f67b8dbbc67ff7ba92e59e5c4fd2abe029a7
+SHA256:
+  metadata.gz: 7d6559401da95647ab967bbbdcf32f7e31459e000c3cf20c5eb2f3629ff2cba4
+  data.tar.gz: 31753e75a41fe7fcced2ed28996adc4feedb831eeec1b2706bdc1a91ee2b1971
 SHA512:
-  metadata.gz: fa8f27d4645bff4f529f5c28a9d5e66f35d07df60f34f5fde26436cdb22bf51b14605d4907ca8730c110d5464d54f051d2e49a4b4c5fe6500316383a28973e4c
-  data.tar.gz: fa178a348af5ca9dbbefd766099b75ce43af55de742141df47e3995227ca3b875ecc42719e951fc5b0e6174cfade2fedf6a8b5a32a8acc5b4227d0626d567637
+  metadata.gz: 95cba84665c32b1471e2fb27d1af6bd6cd0cdd1a282649dedb52d1276cc79e5f9d0c72630c0f8b7c625bdb68f932b8d30da1bbe13cf4bf0b4c60b101c5acaa07
+  data.tar.gz: 30cc69c1c6616288830f7fed09e14a143ecb309d4b431e8abb267819dbb4e975647e2c6a14c11ee21b96eff13f122337d551ccb7faa6da5049ebe9e655597a66

data/lib/aws-sdk-kinesisvideoarchivedmedia.rb

@@ -25,7 +25,7 @@ require_relative 'aws-sdk-kinesisvideoarchivedmedia/customizations'
 # structure.
 #
 #     kinesis_video_archived_media = Aws::KinesisVideoArchivedMedia::Client.new
-#     resp = kinesis_video_archived_media.get_dash_streaming_session_url(params)
+#     resp = kinesis_video_archived_media.get_clip(params)
 #
 # See {Client} for more information.
 #
@@ -45,6 +45,6 @@ require_relative 'aws-sdk-kinesisvideoarchivedmedia/customizations'
 # @service
 module Aws::KinesisVideoArchivedMedia
 
-  GEM_VERSION = '1.21.0'
+  GEM_VERSION = '1.22.0'
 
 end

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

@@ -32,11 +32,11 @@ Aws::Plugins::GlobalConfiguration.add_identifier(:kinesisvideoarchivedmedia)
 module Aws::KinesisVideoArchivedMedia
   # An API client for KinesisVideoArchivedMedia.  To construct a client, you need to configure a `:region` and `:credentials`.
   #
-  #   client = Aws::KinesisVideoArchivedMedia::Client.new(
-  #     region: region_name,
-  #     credentials: credentials,
-  #     # ...
-  #   )
+  #     client = Aws::KinesisVideoArchivedMedia::Client.new(
+  #       region: region_name,
+  #       credentials: credentials,
+  #       # ...
+  #     )
   #
   # For details on configuring region and credentials see
   # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
@@ -229,15 +229,19 @@ module Aws::KinesisVideoArchivedMedia
     #
     #   @option options [String] :retry_mode ("legacy")
     #     Specifies which retry algorithm to use. Values are:
-    #       * `legacy` - The pre-existing retry behavior.  This is default value if
-    #         no retry mode is provided.
-    #       * `standard` - A standardized set of retry rules across the AWS SDKs.
-    #         This includes support for retry quotas, which limit the number of
-    #         unsuccessful retries a client can make.
-    #       * `adaptive` - An experimental retry mode that includes all the
-    #         functionality of `standard` mode along with automatic client side
-    #         throttling.  This is a provisional mode that may change behavior
-    #         in the future.
+    #
+    #     * `legacy` - The pre-existing retry behavior.  This is default value if
+    #       no retry mode is provided.
+    #
+    #     * `standard` - A standardized set of retry rules across the AWS SDKs.
+    #       This includes support for retry quotas, which limit the number of
+    #       unsuccessful retries a client can make.
+    #
+    #     * `adaptive` - An experimental retry mode that includes all the
+    #       functionality of `standard` mode along with automatic client side
+    #       throttling.  This is a provisional mode that may change behavior
+    #       in the future.
+    #
     #
     #   @option options [String] :secret_access_key
     #
@@ -265,8 +269,7 @@ module Aws::KinesisVideoArchivedMedia
     #
     #   @option options [Integer] :http_read_timeout (60) The default
     #     number of seconds to wait for response data.  This value can
-    #     safely be set
-    #     per-request on the session yielded by {#session_for}.
+    #     safely be set per-request on the session.
     #
     #   @option options [Float] :http_idle_timeout (5) The number of
     #     seconds a connection is allowed to sit idle before it is
@@ -278,7 +281,7 @@ module Aws::KinesisVideoArchivedMedia
     #     request body.  This option has no effect unless the request has
     #     "Expect" header set to "100-continue".  Defaults to `nil` which
     #     disables this behaviour.  This value can safely be set per
-    #     request on the session yielded by {#session_for}.
+    #     request on the session.
     #
     #   @option options [Boolean] :http_wire_trace (false) When `true`,
     #     HTTP debug output will be sent to the `:logger`.
@@ -305,6 +308,83 @@ module Aws::KinesisVideoArchivedMedia
 
     # @!group API Operations
 
+    # Downloads an MP4 file (clip) containing the archived, on-demand media
+    # from the specified video stream over the specified time range.
+    #
+    # Both the StreamName and the StreamARN parameters are optional, but you
+    # must specify either the StreamName or the StreamARN when invoking this
+    # API operation.
+    #
+    # As a prerequsite to using GetCLip API, you must obtain an endpoint
+    # using `GetDataEndpoint`, specifying GET\_CLIP for` the APIName
+    # parameter. </p> An Amazon Kinesis video stream has the following
+    # requirements for providing data through MP4:   The media must contain
+    # h.264 or h.265 encoded video and, optionally, AAC or G.711 encoded
+    # audio. Specifically, the codec ID of track 1 should be V_MPEG/ISO/AVC
+    # (for h.264) or V_MPEGH/ISO/HEVC (for H.265). Optionally, the codec ID
+    # of track 2 should be A_AAC (for AAC) or A_MS/ACM (for G.711).   Data
+    # retention must be greater than 0.   The video track of each fragment
+    # must contain codec private data in the Advanced Video Coding (AVC) for
+    # H.264 format and HEVC for H.265 format. For more information, see
+    # MPEG-4 specification ISO/IEC 14496-15. For information about adapting
+    # stream data to a given format, see NAL Adaptation Flags.   The audio
+    # track (if present) of each fragment must contain codec private data in
+    # the AAC format (AAC specification ISO/IEC 13818-7) or the MS Wave
+    # format.   You can monitor the amount of outgoing data by monitoring
+    # 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.
+    # `
+    #
+    # @option params [String] :stream_name
+    #   The name of the stream for which to retrieve the media clip.
+    #
+    #   You must specify either the StreamName or the StreamARN.
+    #
+    # @option params [String] :stream_arn
+    #   The Amazon Resource Name (ARN) of the stream for which to retrieve the
+    #   media clip.
+    #
+    #   You must specify either the StreamName or the StreamARN.
+    #
+    # @option params [required, Types::ClipFragmentSelector] :clip_fragment_selector
+    #   The time range of the requested clip and the source of the timestamps.
+    #
+    # @return [Types::GetClipOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetClipOutput#content_type #content_type} => String
+    #   * {Types::GetClipOutput#payload #payload} => IO
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_clip({
+    #     stream_name: "StreamName",
+    #     stream_arn: "ResourceARN",
+    #     clip_fragment_selector: { # required
+    #       fragment_selector_type: "PRODUCER_TIMESTAMP", # required, accepts PRODUCER_TIMESTAMP, SERVER_TIMESTAMP
+    #       timestamp_range: { # required
+    #         start_timestamp: Time.now, # required
+    #         end_timestamp: Time.now, # required
+    #       },
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.content_type #=> String
+    #   resp.payload #=> IO
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-video-archived-media-2017-09-30/GetClip AWS API Documentation
+    #
+    # @overload get_clip(params = {})
+    # @param [Hash] params ({})
+    def get_clip(params = {}, options = {}, &block)
+      req = build_request(:get_clip, params)
+      req.send_request(options, &block)
+    end
+
     # Retrieves an MPEG Dynamic Adaptive Streaming over HTTP (DASH) URL for
     # the stream. You can then open the URL in a media player to view the
     # stream contents.
@@ -1208,12 +1288,14 @@ module Aws::KinesisVideoArchivedMedia
     #   * {Types::ListFragmentsOutput#fragments #fragments} => Array&lt;Types::Fragment&gt;
     #   * {Types::ListFragmentsOutput#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_fragments({
     #     stream_name: "StreamName", # required
     #     max_results: 1,
-    #     next_token: "String",
+    #     next_token: "NextToken",
     #     fragment_selector: {
     #       fragment_selector_type: "PRODUCER_TIMESTAMP", # required, accepts PRODUCER_TIMESTAMP, SERVER_TIMESTAMP
     #       timestamp_range: { # required
@@ -1255,7 +1337,7 @@ module Aws::KinesisVideoArchivedMedia
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-kinesisvideoarchivedmedia'
-      context[:gem_version] = '1.21.0'
+      context[:gem_version] = '1.22.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -12,6 +12,9 @@ module Aws::KinesisVideoArchivedMedia
     include Seahorse::Model
 
     ClientLimitExceededException = Shapes::StructureShape.new(name: 'ClientLimitExceededException')
+    ClipFragmentSelector = Shapes::StructureShape.new(name: 'ClipFragmentSelector')
+    ClipFragmentSelectorType = Shapes::StringShape.new(name: 'ClipFragmentSelectorType')
+    ClipTimestampRange = Shapes::StructureShape.new(name: 'ClipTimestampRange')
     ContainerFormat = Shapes::StringShape.new(name: 'ContainerFormat')
     ContentType = Shapes::StringShape.new(name: 'ContentType')
     DASHDisplayFragmentNumber = Shapes::StringShape.new(name: 'DASHDisplayFragmentNumber')
@@ -29,6 +32,8 @@ module Aws::KinesisVideoArchivedMedia
     FragmentNumberString = Shapes::StringShape.new(name: 'FragmentNumberString')
     FragmentSelector = Shapes::StructureShape.new(name: 'FragmentSelector')
     FragmentSelectorType = Shapes::StringShape.new(name: 'FragmentSelectorType')
+    GetClipInput = Shapes::StructureShape.new(name: 'GetClipInput')
+    GetClipOutput = Shapes::StructureShape.new(name: 'GetClipOutput')
     GetDASHStreamingSessionURLInput = Shapes::StructureShape.new(name: 'GetDASHStreamingSessionURLInput')
     GetDASHStreamingSessionURLOutput = Shapes::StructureShape.new(name: 'GetDASHStreamingSessionURLOutput')
     GetHLSStreamingSessionURLInput = Shapes::StructureShape.new(name: 'GetHLSStreamingSessionURLInput')
@@ -44,10 +49,12 @@ module Aws::KinesisVideoArchivedMedia
     HLSTimestampRange = Shapes::StructureShape.new(name: 'HLSTimestampRange')
     InvalidArgumentException = Shapes::StructureShape.new(name: 'InvalidArgumentException')
     InvalidCodecPrivateDataException = Shapes::StructureShape.new(name: 'InvalidCodecPrivateDataException')
+    InvalidMediaFrameException = Shapes::StructureShape.new(name: 'InvalidMediaFrameException')
     ListFragmentsInput = Shapes::StructureShape.new(name: 'ListFragmentsInput')
     ListFragmentsOutput = Shapes::StructureShape.new(name: 'ListFragmentsOutput')
     Long = Shapes::IntegerShape.new(name: 'Long')
     MissingCodecPrivateDataException = Shapes::StructureShape.new(name: 'MissingCodecPrivateDataException')
+    NextToken = Shapes::StringShape.new(name: 'NextToken')
     NoDataRetentionException = Shapes::StructureShape.new(name: 'NoDataRetentionException')
     NotAuthorizedException = Shapes::StructureShape.new(name: 'NotAuthorizedException')
     PageLimit = Shapes::IntegerShape.new(name: 'PageLimit')
@@ -55,7 +62,6 @@ module Aws::KinesisVideoArchivedMedia
     ResourceARN = Shapes::StringShape.new(name: 'ResourceARN')
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
     StreamName = Shapes::StringShape.new(name: 'StreamName')
-    String = Shapes::StringShape.new(name: 'String')
     Timestamp = Shapes::TimestampShape.new(name: 'Timestamp')
     TimestampRange = Shapes::StructureShape.new(name: 'TimestampRange')
     UnsupportedStreamMediaTypeException = Shapes::StructureShape.new(name: 'UnsupportedStreamMediaTypeException')
@@ -63,6 +69,14 @@ module Aws::KinesisVideoArchivedMedia
     ClientLimitExceededException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message"))
     ClientLimitExceededException.struct_class = Types::ClientLimitExceededException
 
+    ClipFragmentSelector.add_member(:fragment_selector_type, Shapes::ShapeRef.new(shape: ClipFragmentSelectorType, required: true, location_name: "FragmentSelectorType"))
+    ClipFragmentSelector.add_member(:timestamp_range, Shapes::ShapeRef.new(shape: ClipTimestampRange, required: true, location_name: "TimestampRange"))
+    ClipFragmentSelector.struct_class = Types::ClipFragmentSelector
+
+    ClipTimestampRange.add_member(:start_timestamp, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "StartTimestamp"))
+    ClipTimestampRange.add_member(:end_timestamp, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "EndTimestamp"))
+    ClipTimestampRange.struct_class = Types::ClipTimestampRange
+
     DASHFragmentSelector.add_member(:fragment_selector_type, Shapes::ShapeRef.new(shape: DASHFragmentSelectorType, location_name: "FragmentSelectorType"))
     DASHFragmentSelector.add_member(:timestamp_range, Shapes::ShapeRef.new(shape: DASHTimestampRange, location_name: "TimestampRange"))
     DASHFragmentSelector.struct_class = Types::DASHFragmentSelector
@@ -71,7 +85,7 @@ module Aws::KinesisVideoArchivedMedia
     DASHTimestampRange.add_member(:end_timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "EndTimestamp"))
     DASHTimestampRange.struct_class = Types::DASHTimestampRange
 
-    Fragment.add_member(:fragment_number, Shapes::ShapeRef.new(shape: String, location_name: "FragmentNumber"))
+    Fragment.add_member(:fragment_number, Shapes::ShapeRef.new(shape: FragmentNumberString, location_name: "FragmentNumber"))
     Fragment.add_member(:fragment_size_in_bytes, Shapes::ShapeRef.new(shape: Long, location_name: "FragmentSizeInBytes"))
     Fragment.add_member(:producer_timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "ProducerTimestamp"))
     Fragment.add_member(:server_timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "ServerTimestamp"))
@@ -86,6 +100,17 @@ module Aws::KinesisVideoArchivedMedia
     FragmentSelector.add_member(:timestamp_range, Shapes::ShapeRef.new(shape: TimestampRange, required: true, location_name: "TimestampRange"))
     FragmentSelector.struct_class = Types::FragmentSelector
 
+    GetClipInput.add_member(:stream_name, Shapes::ShapeRef.new(shape: StreamName, location_name: "StreamName"))
+    GetClipInput.add_member(:stream_arn, Shapes::ShapeRef.new(shape: ResourceARN, location_name: "StreamARN"))
+    GetClipInput.add_member(:clip_fragment_selector, Shapes::ShapeRef.new(shape: ClipFragmentSelector, required: true, location_name: "ClipFragmentSelector"))
+    GetClipInput.struct_class = Types::GetClipInput
+
+    GetClipOutput.add_member(:content_type, Shapes::ShapeRef.new(shape: ContentType, location: "header", location_name: "Content-Type"))
+    GetClipOutput.add_member(:payload, Shapes::ShapeRef.new(shape: Payload, location_name: "Payload"))
+    GetClipOutput.struct_class = Types::GetClipOutput
+    GetClipOutput[:payload] = :payload
+    GetClipOutput[:payload_member] = GetClipOutput.member(:payload)
+
     GetDASHStreamingSessionURLInput.add_member(:stream_name, Shapes::ShapeRef.new(shape: StreamName, location_name: "StreamName"))
     GetDASHStreamingSessionURLInput.add_member(:stream_arn, Shapes::ShapeRef.new(shape: ResourceARN, location_name: "StreamARN"))
     GetDASHStreamingSessionURLInput.add_member(:playback_mode, Shapes::ShapeRef.new(shape: DASHPlaybackMode, location_name: "PlaybackMode"))
@@ -137,14 +162,17 @@ module Aws::KinesisVideoArchivedMedia
     InvalidCodecPrivateDataException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message"))
     InvalidCodecPrivateDataException.struct_class = Types::InvalidCodecPrivateDataException
 
+    InvalidMediaFrameException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message"))
+    InvalidMediaFrameException.struct_class = Types::InvalidMediaFrameException
+
     ListFragmentsInput.add_member(:stream_name, Shapes::ShapeRef.new(shape: StreamName, required: true, location_name: "StreamName"))
     ListFragmentsInput.add_member(:max_results, Shapes::ShapeRef.new(shape: PageLimit, location_name: "MaxResults"))
-    ListFragmentsInput.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
+    ListFragmentsInput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
     ListFragmentsInput.add_member(:fragment_selector, Shapes::ShapeRef.new(shape: FragmentSelector, location_name: "FragmentSelector"))
     ListFragmentsInput.struct_class = Types::ListFragmentsInput
 
     ListFragmentsOutput.add_member(:fragments, Shapes::ShapeRef.new(shape: FragmentList, location_name: "Fragments"))
-    ListFragmentsOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
+    ListFragmentsOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
     ListFragmentsOutput.struct_class = Types::ListFragmentsOutput
 
     MissingCodecPrivateDataException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message"))
@@ -183,6 +211,23 @@ module Aws::KinesisVideoArchivedMedia
         "uid" => "kinesis-video-archived-media-2017-09-30",
       }
 
+      api.add_operation(:get_clip, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetClip"
+        o.http_method = "POST"
+        o.http_request_uri = "/getClip"
+        o.input = Shapes::ShapeRef.new(shape: GetClipInput)
+        o.output = Shapes::ShapeRef.new(shape: GetClipOutput)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidArgumentException)
+        o.errors << Shapes::ShapeRef.new(shape: ClientLimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: NotAuthorizedException)
+        o.errors << Shapes::ShapeRef.new(shape: UnsupportedStreamMediaTypeException)
+        o.errors << Shapes::ShapeRef.new(shape: MissingCodecPrivateDataException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidCodecPrivateDataException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidMediaFrameException)
+        o.errors << Shapes::ShapeRef.new(shape: NoDataRetentionException)
+      end)
+
       api.add_operation(:get_dash_streaming_session_url, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetDASHStreamingSessionURL"
         o.http_method = "POST"

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

@@ -28,6 +28,7 @@ module Aws::KinesisVideoArchivedMedia
   # * {ClientLimitExceededException}
   # * {InvalidArgumentException}
   # * {InvalidCodecPrivateDataException}
+  # * {InvalidMediaFrameException}
   # * {MissingCodecPrivateDataException}
   # * {NoDataRetentionException}
   # * {NotAuthorizedException}
@@ -85,6 +86,21 @@ module Aws::KinesisVideoArchivedMedia
       end
     end
 
+    class InvalidMediaFrameException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::KinesisVideoArchivedMedia::Types::InvalidMediaFrameException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+    end
+
     class MissingCodecPrivateDataException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

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

@@ -6,13 +6,7 @@
 # WARNING ABOUT GENERATED CODE
 
 module Aws::KinesisVideoArchivedMedia
-  # This class provides a resource oriented interface for KinesisVideoArchivedMedia.
-  # To create a resource object:
-  #     resource = Aws::KinesisVideoArchivedMedia::Resource.new(region: 'us-west-2')
-  # You can supply a client object with custom configuration that will be used for all resource operations.
-  # If you do not pass +:client+, a default client will be constructed.
-  #     client = Aws::KinesisVideoArchivedMedia::Client.new(region: 'us-west-2')
-  #     resource = Aws::KinesisVideoArchivedMedia::Resource.new(client: client)
+
   class Resource
 
     # @param options ({})

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

@@ -21,6 +21,91 @@ module Aws::KinesisVideoArchivedMedia
       include Aws::Structure
     end
 
+    # Describes the timestamp range and timestamp origin of a range of
+    # fragments.
+    #
+    # Fragments that have duplicate producer timestamps are deduplicated.
+    # This means that if producers are producing a stream of fragments with
+    # producer timestamps that are approximately equal to the true clock
+    # time, the clip will contain all of the fragments within the requested
+    # timestamp range. If some fragments are ingested within the same time
+    # range and very different points in time, only the oldest ingested
+    # collection of fragments are returned.
+    #
+    # @note When making an API call, you may pass ClipFragmentSelector
+    #   data as a hash:
+    #
+    #       {
+    #         fragment_selector_type: "PRODUCER_TIMESTAMP", # required, accepts PRODUCER_TIMESTAMP, SERVER_TIMESTAMP
+    #         timestamp_range: { # required
+    #           start_timestamp: Time.now, # required
+    #           end_timestamp: Time.now, # required
+    #         },
+    #       }
+    #
+    # @!attribute [rw] fragment_selector_type
+    #   The origin of the timestamps to use (Server or Producer).
+    #   @return [String]
+    #
+    # @!attribute [rw] timestamp_range
+    #   The range of timestamps to return.
+    #   @return [Types::ClipTimestampRange]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-video-archived-media-2017-09-30/ClipFragmentSelector AWS API Documentation
+    #
+    class ClipFragmentSelector < Struct.new(
+      :fragment_selector_type,
+      :timestamp_range)
+      include Aws::Structure
+    end
+
+    # The range of timestamps for which to return fragments.
+    #
+    # The values in the ClipTimestampRange are `inclusive`. Fragments that
+    # begin before the start time but continue past it, or fragments that
+    # begin before the end time but continue past it, are included in the
+    # session.
+    #
+    # @note When making an API call, you may pass ClipTimestampRange
+    #   data as a hash:
+    #
+    #       {
+    #         start_timestamp: Time.now, # required
+    #         end_timestamp: Time.now, # required
+    #       }
+    #
+    # @!attribute [rw] start_timestamp
+    #   The starting timestamp in the range of timestamps for which to
+    #   return fragments.
+    #
+    #   This value is inclusive. Fragments that start before the
+    #   `StartTimestamp` and continue past it are included in the session.
+    #   If `FragmentSelectorType` is `SERVER_TIMESTAMP`, the
+    #   `StartTimestamp` must be later than the stream head.
+    #   @return [Time]
+    #
+    # @!attribute [rw] end_timestamp
+    #   The end of the timestamp range for the requested media.
+    #
+    #   This value must be within 3 hours of the specified `StartTimestamp`,
+    #   and it must be later than the `StartTimestamp` value. If
+    #   `FragmentSelectorType` for the request is `SERVER_TIMESTAMP`, this
+    #   value must be in the past.
+    #
+    #   This value is inclusive. The `EndTimestamp` is compared to the
+    #   (starting) timestamp of the fragment. Fragments that start before
+    #   the `EndTimestamp` value and continue past it are included in the
+    #   session.
+    #   @return [Time]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-video-archived-media-2017-09-30/ClipTimestampRange AWS API Documentation
+    #
+    class ClipTimestampRange < Struct.new(
+      :start_timestamp,
+      :end_timestamp)
+      include Aws::Structure
+    end
+
     # Contains the range of timestamps for the requested media, and the
     # source of the timestamps.
     #
@@ -226,6 +311,68 @@ module Aws::KinesisVideoArchivedMedia
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass GetClipInput
+    #   data as a hash:
+    #
+    #       {
+    #         stream_name: "StreamName",
+    #         stream_arn: "ResourceARN",
+    #         clip_fragment_selector: { # required
+    #           fragment_selector_type: "PRODUCER_TIMESTAMP", # required, accepts PRODUCER_TIMESTAMP, SERVER_TIMESTAMP
+    #           timestamp_range: { # required
+    #             start_timestamp: Time.now, # required
+    #             end_timestamp: Time.now, # required
+    #           },
+    #         },
+    #       }
+    #
+    # @!attribute [rw] stream_name
+    #   The name of the stream for which to retrieve the media clip.
+    #
+    #   You must specify either the StreamName or the StreamARN.
+    #   @return [String]
+    #
+    # @!attribute [rw] stream_arn
+    #   The Amazon Resource Name (ARN) of the stream for which to retrieve
+    #   the media clip.
+    #
+    #   You must specify either the StreamName or the StreamARN.
+    #   @return [String]
+    #
+    # @!attribute [rw] clip_fragment_selector
+    #   The time range of the requested clip and the source of the
+    #   timestamps.
+    #   @return [Types::ClipFragmentSelector]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-video-archived-media-2017-09-30/GetClipInput AWS API Documentation
+    #
+    class GetClipInput < Struct.new(
+      :stream_name,
+      :stream_arn,
+      :clip_fragment_selector)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] content_type
+    #   The content type of the media in the requested clip.
+    #   @return [String]
+    #
+    # @!attribute [rw] payload
+    #   Traditional MP4 file that contains the media clip from the specified
+    #   video stream. The output will contain the first 100 MB or the first
+    #   200 fragments from the specified start timestamp. For more
+    #   information, see [Kinesis Video Streams Limits](Kinesis Video
+    #   Streams Limits).
+    #   @return [IO]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-video-archived-media-2017-09-30/GetClipOutput AWS API Documentation
+    #
+    class GetClipOutput < Struct.new(
+      :content_type,
+      :payload)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass GetDASHStreamingSessionURLInput
     #   data as a hash:
     #
@@ -881,13 +1028,26 @@ module Aws::KinesisVideoArchivedMedia
       include Aws::Structure
     end
 
+    # One or more frames in the requested clip could not be parsed based on
+    # the specified codec.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-video-archived-media-2017-09-30/InvalidMediaFrameException AWS API Documentation
+    #
+    class InvalidMediaFrameException < Struct.new(
+      :message)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass ListFragmentsInput
     #   data as a hash:
     #
     #       {
     #         stream_name: "StreamName", # required
     #         max_results: 1,
-    #         next_token: "String",
+    #         next_token: "NextToken",
     #         fragment_selector: {
     #           fragment_selector_type: "PRODUCER_TIMESTAMP", # required, accepts PRODUCER_TIMESTAMP, SERVER_TIMESTAMP
     #           timestamp_range: { # required

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-kinesisvideoarchivedmedia
 version: !ruby/object:Gem::Version
-  version: 1.21.0
+  version: 1.22.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-03-09 00:00:00.000000000 Z
+date: 2020-04-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -81,7 +81,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.2.3
+rubygems_version: 2.7.6.2
 signing_key: 
 specification_version: 4
 summary: AWS SDK for Ruby - Kinesis Video Archived Media