aws-sdk-kinesisvideoarchivedmedia 1.17.0 → 1.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 95afbb9a6043fd08e4dd249c3b62bab68eb27617
-  data.tar.gz: b2999bac55287f27f509a1deac6df995cc980a73
+SHA256:
+  metadata.gz: 7d6559401da95647ab967bbbdcf32f7e31459e000c3cf20c5eb2f3629ff2cba4
+  data.tar.gz: 31753e75a41fe7fcced2ed28996adc4feedb831eeec1b2706bdc1a91ee2b1971
 SHA512:
-  metadata.gz: c43d018a7da30b83dc66d7930bcee345b4e17ff9c36c1a4e5219d35407165bb6ab99b79021ce4d488d93058d5327b235e2426bc8c4cc70787a84ec0d1a941b03
-  data.tar.gz: 6c214bafde60fb22e28bb775eeb9824b16fd890030f50fe9ef24cadaaecd885ea4a14df24063c605a95c015129b259fb3b2513b2ac6c19b9488787992ddc93cc
+  metadata.gz: 95cba84665c32b1471e2fb27d1af6bd6cd0cdd1a282649dedb52d1276cc79e5f9d0c72630c0f8b7c625bdb68f932b8d30da1bbe13cf4bf0b4c60b101c5acaa07
+  data.tar.gz: 30cc69c1c6616288830f7fed09e14a143ecb309d4b431e8abb267819dbb4e975647e2c6a14c11ee21b96eff13f122337d551ccb7faa6da5049ebe9e655597a66

data/lib/aws-sdk-kinesisvideoarchivedmedia.rb

@@ -24,17 +24,20 @@ require_relative 'aws-sdk-kinesisvideoarchivedmedia/customizations'
 # methods each accept a hash of request parameters and return a response
 # structure.
 #
+#     kinesis_video_archived_media = Aws::KinesisVideoArchivedMedia::Client.new
+#     resp = kinesis_video_archived_media.get_clip(params)
+#
 # See {Client} for more information.
 #
 # # Errors
 #
-# Errors returned from Amazon Kinesis Video Streams Archived Media all
-# extend {Errors::ServiceError}.
+# Errors returned from Amazon Kinesis Video Streams Archived Media are defined in the
+# {Errors} module and all extend {Errors::ServiceError}.
 #
 #     begin
 #       # do stuff
 #     rescue Aws::KinesisVideoArchivedMedia::Errors::ServiceError
-#       # rescues all service API errors
+#       # rescues all Amazon Kinesis Video Streams Archived Media API errors
 #     end
 #
 # See {Errors} for more information.
@@ -42,6 +45,6 @@ require_relative 'aws-sdk-kinesisvideoarchivedmedia/customizations'
 # @service
 module Aws::KinesisVideoArchivedMedia
 
-  GEM_VERSION = '1.17.0'
+  GEM_VERSION = '1.22.0'
 
 end

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

@@ -30,6 +30,18 @@ require 'aws-sdk-core/plugins/protocols/rest_json.rb'
 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,
+  #       # ...
+  #     )
+  #
+  # For details on configuring region and credentials see
+  # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
+  #
+  # See {#initialize} for a full list of supported configuration options.
   class Client < Seahorse::Client::Base
 
     include Aws::ClientStubs
@@ -108,6 +120,12 @@ module Aws::KinesisVideoArchivedMedia
     #     When set to `true`, a thread polling for endpoints will be running in
     #     the background every 60 secs (default). Defaults to `false`.
     #
+    #   @option options [Boolean] :adaptive_retry_wait_to_fill (true)
+    #     Used only in `adaptive` retry mode.  When true, the request will sleep
+    #     until there is sufficent client side capacity to retry the request.
+    #     When false, the request will raise a `RetryCapacityNotAvailableError` and will
+    #     not retry instead of sleeping.
+    #
     #   @option options [Boolean] :client_side_monitoring (false)
     #     When `true`, client-side metrics will be collected for all API requests from
     #     this client.
@@ -132,6 +150,10 @@ module Aws::KinesisVideoArchivedMedia
     #     When `true`, an attempt is made to coerce request parameters into
     #     the required types.
     #
+    #   @option options [Boolean] :correct_clock_skew (true)
+    #     Used only in `standard` and adaptive retry modes. Specifies whether to apply
+    #     a clock skew correction and retry requests with skewed client clocks.
+    #
     #   @option options [Boolean] :disable_host_prefix_injection (false)
     #     Set to true to disable SDK automatically adding host prefix
     #     to default service endpoint when available.
@@ -166,15 +188,29 @@ module Aws::KinesisVideoArchivedMedia
     #     The Logger instance to send log messages to.  If this option
     #     is not set, logging will be disabled.
     #
+    #   @option options [Integer] :max_attempts (3)
+    #     An integer representing the maximum number attempts that will be made for
+    #     a single request, including the initial attempt.  For example,
+    #     setting this value to 5 will result in a request being retried up to
+    #     4 times. Used in `standard` and `adaptive` retry modes.
+    #
     #   @option options [String] :profile ("default")
     #     Used when loading credentials from the shared credentials file
     #     at HOME/.aws/credentials.  When not specified, 'default' is used.
     #
+    #   @option options [Proc] :retry_backoff
+    #     A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
+    #     This option is only used in the `legacy` retry mode.
+    #
     #   @option options [Float] :retry_base_delay (0.3)
-    #     The base delay in seconds used by the default backoff function.
+    #     The base delay in seconds used by the default backoff function. This option
+    #     is only used in the `legacy` retry mode.
     #
     #   @option options [Symbol] :retry_jitter (:none)
-    #     A delay randomiser function used by the default backoff function. Some predefined functions can be referenced by name - :none, :equal, :full, otherwise a Proc that takes and returns a number.
+    #     A delay randomiser function used by the default backoff function.
+    #     Some predefined functions can be referenced by name - :none, :equal, :full,
+    #     otherwise a Proc that takes and returns a number. This option is only used
+    #     in the `legacy` retry mode.
     #
     #     @see https://www.awsarchitectureblog.com/2015/03/backoff.html
     #
@@ -182,11 +218,30 @@ module Aws::KinesisVideoArchivedMedia
     #     The maximum number of times to retry failed requests.  Only
     #     ~ 500 level server errors and certain ~ 400 level client errors
     #     are retried.  Generally, these are throttling errors, data
-    #     checksum errors, networking errors, timeout errors and auth
-    #     errors from expired credentials.
+    #     checksum errors, networking errors, timeout errors, auth errors,
+    #     endpoint discovery, and errors from expired credentials.
+    #     This option is only used in the `legacy` retry mode.
     #
     #   @option options [Integer] :retry_max_delay (0)
-    #     The maximum number of seconds to delay between retries (0 for no limit) used by the default backoff function.
+    #     The maximum number of seconds to delay between retries (0 for no limit)
+    #     used by the default backoff function. This option is only used in the
+    #     `legacy` retry mode.
+    #
+    #   @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.
+    #
     #
     #   @option options [String] :secret_access_key
     #
@@ -209,16 +264,15 @@ module Aws::KinesisVideoArchivedMedia
     #     requests through.  Formatted like 'http://proxy.com:123'.
     #
     #   @option options [Float] :http_open_timeout (15) The number of
-    #     seconds to wait when opening a HTTP session before rasing a
+    #     seconds to wait when opening a HTTP session before raising a
     #     `Timeout::Error`.
     #
     #   @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 yeidled 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 idble before it is
+    #     seconds a connection is allowed to sit idle before it is
     #     considered stale.  Stale connections are closed and removed
     #     from the pool before making a request.
     #
@@ -227,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 yeidled 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`.
@@ -254,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.
@@ -266,9 +397,9 @@ module Aws::KinesisVideoArchivedMedia
     # providing data through MPEG-DASH:
     #
     # * 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
+    #   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
+    #   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.
@@ -311,7 +442,7 @@ module Aws::KinesisVideoArchivedMedia
     #
     # 3.  Provide the URL (containing the encrypted session token) for the
     #     MPEG-DASH manifest to a media player that supports the MPEG-DASH
-    #     protocol. Kinesis Video Streams makes the initialization fragment,
+    #     protocol. Kinesis Video Streams makes the initialization fragment
     #     and media fragments available through the manifest URL. The
     #     initialization fragment contains the codec private data for the
     #     stream, and other data needed to set up the video or audio decoder
@@ -522,7 +653,7 @@ module Aws::KinesisVideoArchivedMedia
     #   The default value is `NEVER`.
     #
     # @option params [Types::DASHFragmentSelector] :dash_fragment_selector
-    #   The time range of the requested fragment, and the source of the
+    #   The time range of the requested fragment and the source of the
     #   timestamps.
     #
     #   This parameter is required if `PlaybackMode` is `ON_DEMAND` or
@@ -613,9 +744,9 @@ module Aws::KinesisVideoArchivedMedia
     # 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
+    #   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`.
+    #   Optionally, the codec ID of track 2 should be `A_AAC`.
     #
     # * Data retention must be greater than 0.
     #
@@ -871,7 +1002,7 @@ module Aws::KinesisVideoArchivedMedia
     #   The default is `LIVE`.
     #
     # @option params [Types::HLSFragmentSelector] :hls_fragment_selector
-    #   The time range of the requested fragment, and the source of the
+    #   The time range of the requested fragment and the source of the
     #   timestamps.
     #
     #   This parameter is required if `PlaybackMode` is `ON_DEMAND` or
@@ -896,23 +1027,40 @@ module Aws::KinesisVideoArchivedMedia
     #   The default is `FRAGMENTED_MP4`.
     #
     # @option params [String] :discontinuity_mode
-    #   Specifies when flags marking discontinuities between fragments will be
-    #   added to the media playlists. The default is `ALWAYS` when
-    #   HLSFragmentSelector is `SERVER_TIMESTAMP`, and `NEVER` when it is
-    #   `PRODUCER_TIMESTAMP`.
+    #   Specifies when flags marking discontinuities between fragments are
+    #   added to the media playlists.
     #
     #   Media players typically build a timeline of media content to play,
     #   based on the timestamps of each fragment. This means that if there is
-    #   any overlap between fragments (as is typical if HLSFragmentSelector is
-    #   `SERVER_TIMESTAMP`), the media player timeline has small gaps between
-    #   fragments in some places, and overwrites frames in other places. When
-    #   there are discontinuity flags between fragments, the media player is
-    #   expected to reset the timeline, resulting in the fragment being played
-    #   immediately after the previous fragment. We recommend that you always
-    #   have discontinuity flags between fragments if the fragment timestamps
-    #   are not accurate or if fragments might be missing. You should not
-    #   place discontinuity flags between fragments for the player timeline to
-    #   accurately map to the producer timestamps.
+    #   any overlap or gap between fragments (as is typical if
+    #   HLSFragmentSelector is set to `SERVER_TIMESTAMP`), the media player
+    #   timeline will also have small gaps between fragments in some places,
+    #   and will overwrite frames in other places. Gaps in the media player
+    #   timeline can cause playback to stall and overlaps can cause playback
+    #   to be jittery. When there are discontinuity flags between fragments,
+    #   the media player is expected to reset the timeline, resulting in the
+    #   next fragment being played immediately after the previous fragment.
+    #
+    #   The following modes are supported:
+    #
+    #   * `ALWAYS`\: a discontinuity marker is placed between every fragment
+    #     in the HLS media playlist. It is recommended to use a value of
+    #     `ALWAYS` if the fragment timestamps are not accurate.
+    #
+    #   * `NEVER`\: no discontinuity markers are placed anywhere. It is
+    #     recommended to use a value of `NEVER` to ensure the media player
+    #     timeline most accurately maps to the producer timestamps.
+    #
+    #   * `ON_DISCONTIUNITY`\: a discontinuity marker is placed between
+    #     fragments that have a gap or overlap of more than 50 milliseconds.
+    #     For most playback scenarios, it is recommended to use a value of
+    #     `ON_DISCONTINUITY` so that the media player timeline is only reset
+    #     when there is a significant issue with the media timeline (e.g. a
+    #     missing fragment).
+    #
+    #   The default is `ALWAYS` when HLSFragmentSelector is set to
+    #   `SERVER_TIMESTAMP`, and `NEVER` when it is set to
+    #   `PRODUCER_TIMESTAMP`.
     #
     # @option params [String] :display_fragment_timestamp
     #   Specifies when the fragment start timestamps should be included in the
@@ -980,7 +1128,7 @@ module Aws::KinesisVideoArchivedMedia
     #       },
     #     },
     #     container_format: "FRAGMENTED_MP4", # accepts FRAGMENTED_MP4, MPEG_TS
-    #     discontinuity_mode: "ALWAYS", # accepts ALWAYS, NEVER
+    #     discontinuity_mode: "ALWAYS", # accepts ALWAYS, NEVER, ON_DISCONTINUITY
     #     display_fragment_timestamp: "ALWAYS", # accepts ALWAYS, NEVER
     #     expires: 1,
     #     max_media_playlist_fragment_results: 1,
@@ -1140,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
@@ -1187,7 +1337,7 @@ module Aws::KinesisVideoArchivedMedia
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-kinesisvideoarchivedmedia'
-      context[:gem_version] = '1.17.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

@@ -6,6 +6,37 @@
 # WARNING ABOUT GENERATED CODE
 
 module Aws::KinesisVideoArchivedMedia
+
+  # When KinesisVideoArchivedMedia returns an error response, the Ruby SDK constructs and raises an error.
+  # These errors all extend Aws::KinesisVideoArchivedMedia::Errors::ServiceError < {Aws::Errors::ServiceError}
+  #
+  # You can rescue all KinesisVideoArchivedMedia errors using ServiceError:
+  #
+  #     begin
+  #       # do stuff
+  #     rescue Aws::KinesisVideoArchivedMedia::Errors::ServiceError
+  #       # rescues all KinesisVideoArchivedMedia API errors
+  #     end
+  #
+  #
+  # ## Request Context
+  # ServiceError objects have a {Aws::Errors::ServiceError#context #context} method that returns
+  # information about the request that generated the error.
+  # See {Seahorse::Client::RequestContext} for more information.
+  #
+  # ## Error Classes
+  # * {ClientLimitExceededException}
+  # * {InvalidArgumentException}
+  # * {InvalidCodecPrivateDataException}
+  # * {InvalidMediaFrameException}
+  # * {MissingCodecPrivateDataException}
+  # * {NoDataRetentionException}
+  # * {NotAuthorizedException}
+  # * {ResourceNotFoundException}
+  # * {UnsupportedStreamMediaTypeException}
+  #
+  # Additionally, error classes are dynamically generated for service errors based on the error code
+  # if they are not defined above.
   module Errors
 
     extend Aws::Errors::DynamicErrors
@@ -23,7 +54,6 @@ module Aws::KinesisVideoArchivedMedia
       def message
         @message || @data[:message]
       end
-
     end
 
     class InvalidArgumentException < ServiceError
@@ -39,7 +69,6 @@ module Aws::KinesisVideoArchivedMedia
       def message
         @message || @data[:message]
       end
-
     end
 
     class InvalidCodecPrivateDataException < ServiceError
@@ -55,7 +84,21 @@ module Aws::KinesisVideoArchivedMedia
       def message
         @message || @data[:message]
       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
@@ -71,7 +114,6 @@ module Aws::KinesisVideoArchivedMedia
       def message
         @message || @data[:message]
       end
-
     end
 
     class NoDataRetentionException < ServiceError
@@ -87,7 +129,6 @@ module Aws::KinesisVideoArchivedMedia
       def message
         @message || @data[:message]
       end
-
     end
 
     class NotAuthorizedException < ServiceError
@@ -103,7 +144,6 @@ module Aws::KinesisVideoArchivedMedia
       def message
         @message || @data[:message]
       end
-
     end
 
     class ResourceNotFoundException < ServiceError
@@ -119,7 +159,6 @@ module Aws::KinesisVideoArchivedMedia
       def message
         @message || @data[:message]
       end
-
     end
 
     class UnsupportedStreamMediaTypeException < ServiceError
@@ -135,7 +174,6 @@ module Aws::KinesisVideoArchivedMedia
       def message
         @message || @data[:message]
       end
-
     end
 
   end

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

@@ -6,6 +6,7 @@
 # WARNING ABOUT GENERATED CODE
 
 module Aws::KinesisVideoArchivedMedia
+
   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:
     #
@@ -355,7 +502,7 @@ module Aws::KinesisVideoArchivedMedia
     #   @return [String]
     #
     # @!attribute [rw] dash_fragment_selector
-    #   The time range of the requested fragment, and the source of the
+    #   The time range of the requested fragment and the source of the
     #   timestamps.
     #
     #   This parameter is required if `PlaybackMode` is `ON_DEMAND` or
@@ -442,7 +589,7 @@ module Aws::KinesisVideoArchivedMedia
     #           },
     #         },
     #         container_format: "FRAGMENTED_MP4", # accepts FRAGMENTED_MP4, MPEG_TS
-    #         discontinuity_mode: "ALWAYS", # accepts ALWAYS, NEVER
+    #         discontinuity_mode: "ALWAYS", # accepts ALWAYS, NEVER, ON_DISCONTINUITY
     #         display_fragment_timestamp: "ALWAYS", # accepts ALWAYS, NEVER
     #         expires: 1,
     #         max_media_playlist_fragment_results: 1,
@@ -523,7 +670,7 @@ module Aws::KinesisVideoArchivedMedia
     #   @return [String]
     #
     # @!attribute [rw] hls_fragment_selector
-    #   The time range of the requested fragment, and the source of the
+    #   The time range of the requested fragment and the source of the
     #   timestamps.
     #
     #   This parameter is required if `PlaybackMode` is `ON_DEMAND` or
@@ -550,24 +697,40 @@ module Aws::KinesisVideoArchivedMedia
     #   @return [String]
     #
     # @!attribute [rw] discontinuity_mode
-    #   Specifies when flags marking discontinuities between fragments will
-    #   be added to the media playlists. The default is `ALWAYS` when
-    #   HLSFragmentSelector is `SERVER_TIMESTAMP`, and `NEVER` when it is
-    #   `PRODUCER_TIMESTAMP`.
+    #   Specifies when flags marking discontinuities between fragments are
+    #   added to the media playlists.
     #
     #   Media players typically build a timeline of media content to play,
     #   based on the timestamps of each fragment. This means that if there
-    #   is any overlap between fragments (as is typical if
-    #   HLSFragmentSelector is `SERVER_TIMESTAMP`), the media player
-    #   timeline has small gaps between fragments in some places, and
-    #   overwrites frames in other places. When there are discontinuity
-    #   flags between fragments, the media player is expected to reset the
-    #   timeline, resulting in the fragment being played immediately after
-    #   the previous fragment. We recommend that you always have
-    #   discontinuity flags between fragments if the fragment timestamps are
-    #   not accurate or if fragments might be missing. You should not place
-    #   discontinuity flags between fragments for the player timeline to
-    #   accurately map to the producer timestamps.
+    #   is any overlap or gap between fragments (as is typical if
+    #   HLSFragmentSelector is set to `SERVER_TIMESTAMP`), the media player
+    #   timeline will also have small gaps between fragments in some places,
+    #   and will overwrite frames in other places. Gaps in the media player
+    #   timeline can cause playback to stall and overlaps can cause playback
+    #   to be jittery. When there are discontinuity flags between fragments,
+    #   the media player is expected to reset the timeline, resulting in the
+    #   next fragment being played immediately after the previous fragment.
+    #
+    #   The following modes are supported:
+    #
+    #   * `ALWAYS`\: a discontinuity marker is placed between every fragment
+    #     in the HLS media playlist. It is recommended to use a value of
+    #     `ALWAYS` if the fragment timestamps are not accurate.
+    #
+    #   * `NEVER`\: no discontinuity markers are placed anywhere. It is
+    #     recommended to use a value of `NEVER` to ensure the media player
+    #     timeline most accurately maps to the producer timestamps.
+    #
+    #   * `ON_DISCONTIUNITY`\: a discontinuity marker is placed between
+    #     fragments that have a gap or overlap of more than 50 milliseconds.
+    #     For most playback scenarios, it is recommended to use a value of
+    #     `ON_DISCONTINUITY` so that the media player timeline is only reset
+    #     when there is a significant issue with the media timeline (e.g. a
+    #     missing fragment).
+    #
+    #   The default is `ALWAYS` when HLSFragmentSelector is set to
+    #   `SERVER_TIMESTAMP`, and `NEVER` when it is set to
+    #   `PRODUCER_TIMESTAMP`.
     #   @return [String]
     #
     # @!attribute [rw] display_fragment_timestamp
@@ -865,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.17.0
+  version: 1.22.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-07-09 00:00:00.000000000 Z
+date: 2020-04-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.58.0
+        version: 3.71.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.58.0
+        version: 3.71.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement
@@ -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