aws-sdk-kinesisvideoarchivedmedia 1.16.0 → 1.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7f983615a3b757d4ca06b404645a2ec26bdf62ba
-  data.tar.gz: 177654450b09e52ca906c5e49a036878e602a0cc
+  metadata.gz: 51296e836336e18d14c687350a8f1af34e0329ee
+  data.tar.gz: 9bb0f67b8dbbc67ff7ba92e59e5c4fd2abe029a7
 SHA512:
-  metadata.gz: bdd217b290c50f315a36ab0d169aeab8b244d75c6b3be5ccab99f78db8783ace9a44cd33396ec767915056ca176aaa65701e6570f9112e68782f1c416ae942ce
-  data.tar.gz: 95226f28f0a504c521a48c75870a46b2eb1df898ed6a4c53133305d6592609d3dfdf9b8f6150ade079283bd85085d6ef321857569cd382fba908c5e2ef48b382
+  metadata.gz: fa8f27d4645bff4f529f5c28a9d5e66f35d07df60f34f5fde26436cdb22bf51b14605d4907ca8730c110d5464d54f051d2e49a4b4c5fe6500316383a28973e4c
+  data.tar.gz: fa178a348af5ca9dbbefd766099b75ce43af55de742141df47e3995227ca3b875ecc42719e951fc5b0e6174cfade2fedf6a8b5a32a8acc5b4227d0626d567637

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_dash_streaming_session_url(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.16.0'
+  GEM_VERSION = '1.21.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,26 @@ 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 +260,16 @@ 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}.
+    #     per-request on the session yielded by {#session_for}.
     #
     #   @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 +278,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 yielded by {#session_for}.
     #
     #   @option options [Boolean] :http_wire_trace (false) When `true`,
     #     HTTP debug output will be sent to the `:logger`.
@@ -254,36 +305,385 @@ module Aws::KinesisVideoArchivedMedia
 
     # @!group API Operations
 
+    # 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.
+    #
+    # Both the `StreamName` and the `StreamARN` parameters are optional, but
+    # you must specify either the `StreamName` or the `StreamARN` when
+    # invoking this API operation.
+    #
+    # An Amazon Kinesis video stream has the following requirements for
+    # 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
+    #   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][1]. For information about adapting stream data to a given
+    #   format, see [NAL Adaptation Flags][2].
+    #
+    # * The audio track (if present) of each fragment must contain codec
+    #   private data in the AAC format ([AAC specification ISO/IEC
+    #   13818-7][3]) or the [MS Wave format][4].
+    #
+    # The following procedure shows how to use MPEG-DASH with Kinesis Video
+    # Streams:
+    #
+    # 1.  Get an endpoint using [GetDataEndpoint][5], specifying
+    #     `GET_DASH_STREAMING_SESSION_URL` for the `APIName` parameter.
+    #
+    # 2.  Retrieve the MPEG-DASH URL using `GetDASHStreamingSessionURL`.
+    #     Kinesis Video Streams creates an MPEG-DASH streaming session to be
+    #     used for accessing content in a stream using the MPEG-DASH
+    #     protocol. `GetDASHStreamingSessionURL` returns an authenticated
+    #     URL (that includes an encrypted session token) for the session's
+    #     MPEG-DASH *manifest* (the root resource needed for streaming with
+    #     MPEG-DASH).
+    #
+    #     <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.
+    #
+    #      </note>
+    #
+    #     The media that is made available through the manifest consists
+    #     only of the requested stream, time range, and format. No other
+    #     media data (such as frames outside the requested window or
+    #     alternate bitrates) is made available.
+    #
+    # 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
+    #     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
+    #     and renderer. The media fragments contain encoded video frames or
+    #     encoded audio samples.
+    #
+    # 4.  The media player receives the authenticated URL and requests
+    #     stream metadata and media data normally. When the media player
+    #     requests data, it calls the following actions:
+    #
+    #     * **GetDASHManifest:** Retrieves an MPEG DASH manifest, which
+    #       contains the metadata for the media that you want to playback.
+    #
+    #     * **GetMP4InitFragment:** Retrieves the MP4 initialization
+    #       fragment. The media player typically loads the initialization
+    #       fragment before loading any media fragments. This fragment
+    #       contains the "`fytp`" and "`moov`" MP4 atoms, and the child
+    #       atoms that are needed to initialize the media player decoder.
+    #
+    #       The initialization fragment does not correspond to a fragment in
+    #       a Kinesis video stream. It contains only the codec private data
+    #       for the stream and respective track, which the media player
+    #       needs to decode the media frames.
+    #
+    #     * **GetMP4MediaFragment:** Retrieves MP4 media fragments. These
+    #       fragments contain the "`moof`" and "`mdat`" MP4 atoms and
+    #       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>
+    #
+    #       Data retrieved with this action is billable. See [Pricing][6]
+    #       for details.
+    #
+    # <note markdown="1"> The following restrictions apply to MPEG-DASH sessions:
+    #
+    #  * A streaming session URL should not be shared between players. The
+    #   service might throttle a session if multiple media players are
+    #   sharing it. For connection limits, see [Kinesis Video Streams
+    #   Limits][7].
+    #
+    # * A Kinesis video stream can have a maximum of ten active MPEG-DASH
+    #   streaming sessions. If a new session is created when the maximum
+    #   number of sessions is already active, the oldest (earliest created)
+    #   session is closed. The number of active `GetMedia` connections on a
+    #   Kinesis video stream does not count against this limit, and the
+    #   number of active MPEG-DASH sessions does not count against the
+    #   active `GetMedia` connection limit.
+    #
+    #   <note markdown="1"> The maximum limits for active HLS and MPEG-DASH streaming sessions
+    #   are independent of each other.
+    #
+    #    </note>
+    #
+    #  </note>
+    #
+    # You can monitor the amount of data that the media player consumes by
+    # 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.
+    #
+    # For more information about HLS, see [HTTP Live Streaming][10] on the
+    # [Apple Developer site][11].
+    #
+    # If an error is thrown after invoking a Kinesis Video Streams archived
+    # media API, in addition to the HTTP status code and the response body,
+    # it includes the following pieces of information:
+    #
+    #  * `x-amz-ErrorType` HTTP header – contains a more specific error type
+    #   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.
+    #
+    #  Both the HTTP status code and the ErrorType header can be utilized to
+    # make programmatic decisions about whether errors are retry-able and
+    # under what conditions, as well as provide information on what actions
+    # the client programmer might need to take in order to successfully try
+    # again.
+    #
+    #  For more information, see the **Errors** section at the bottom of
+    # this
+    # topic, as well as [Common Errors][12].
+    #
+    #
+    #
+    # [1]: https://www.iso.org/standard/55980.html
+    # [2]: http://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-reference-nal.html
+    # [3]: https://www.iso.org/standard/43345.html
+    # [4]: http://www-mmsp.ece.mcgill.ca/Documents/AudioFormats/WAVE/WAVE.html
+    # [5]: http://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_GetDataEndpoint.html
+    # [6]: https://aws.amazon.com/kinesis/video-streams/pricing/
+    # [7]: http://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html
+    # [8]: http://docs.aws.amazon.com/kinesisvideostreams/latest/dg/monitoring.html
+    # [9]: https://aws.amazon.com/pricing/
+    # [10]: https://developer.apple.com/streaming/
+    # [11]: https://developer.apple.com
+    # [12]: https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/CommonErrors.html
+    #
+    # @option params [String] :stream_name
+    #   The name of the stream for which to retrieve the MPEG-DASH manifest
+    #   URL.
+    #
+    #   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
+    #   MPEG-DASH manifest URL.
+    #
+    #   You must specify either the `StreamName` or the `StreamARN`.
+    #
+    # @option params [String] :playback_mode
+    #   Whether to retrieve live, live replay, or archived, on-demand data.
+    #
+    #   Features of the three types of sessions include the following:
+    #
+    #   * <b> <code>LIVE</code> </b>\: For sessions of this type, the
+    #     MPEG-DASH manifest is continually updated with the latest fragments
+    #     as they become available. We recommend that the media player
+    #     retrieve a new manifest on a one-second interval. When this type of
+    #     session is played in a media player, the user interface typically
+    #     displays a "live" notification, with no scrubber control for
+    #     choosing the position in the playback window to display.
+    #
+    #     <note markdown="1"> In `LIVE` mode, the newest available fragments are included in an
+    #     MPEG-DASH manifest, even if there is a gap between fragments (that
+    #     is, if a fragment is missing). A gap like this might cause a media
+    #     player to halt or cause a jump in playback. In this mode, fragments
+    #     are not added to the MPEG-DASH manifest if they are older than the
+    #     newest fragment in the playlist. If the missing fragment becomes
+    #     available after a subsequent fragment is added to the manifest, the
+    #     older fragment is not added, and the gap is not filled.
+    #
+    #      </note>
+    #
+    #   * <b> <code>LIVE_REPLAY</code> </b>\: For sessions of this type, the
+    #     MPEG-DASH manifest is updated similarly to how it is updated for
+    #     `LIVE` mode except that it starts by including fragments from a
+    #     given start time. Instead of fragments being added as they are
+    #     ingested, fragments are added as the duration of the next fragment
+    #     elapses. For example, if the fragments in the session are two
+    #     seconds long, then a new fragment is added to the manifest every two
+    #     seconds. This mode is useful to be able to start playback from when
+    #     an event is detected and continue live streaming media that has not
+    #     yet been ingested as of the time of the session creation. This mode
+    #     is also useful to stream previously archived media without being
+    #     limited by the 1,000 fragment limit in the `ON_DEMAND` mode.
+    #
+    #   * <b> <code>ON_DEMAND</code> </b>\: For sessions of this type, the
+    #     MPEG-DASH manifest contains all the fragments for the session, up to
+    #     the number that is specified in `MaxMediaPlaylistFragmentResults`.
+    #     The manifest must be retrieved only once for each session. When this
+    #     type of session is played in a media player, the user interface
+    #     typically displays a scrubber control for choosing the position in
+    #     the playback window to display.
+    #
+    #   In all playback modes, if `FragmentSelectorType` is
+    #   `PRODUCER_TIMESTAMP`, and if there are multiple fragments with the
+    #   same start timestamp, the fragment that has the larger fragment number
+    #   (that is, the newer fragment) is included in the MPEG-DASH manifest.
+    #   The other fragments are not included. Fragments that have different
+    #   timestamps but have overlapping durations are still included in the
+    #   MPEG-DASH manifest. This can lead to unexpected behavior in the media
+    #   player.
+    #
+    #   The default is `LIVE`.
+    #
+    # @option params [String] :display_fragment_timestamp
+    #   Per the MPEG-DASH specification, the wall-clock time of fragments in
+    #   the manifest file can be derived using attributes in the manifest
+    #   itself. However, typically, MPEG-DASH compatible media players do not
+    #   properly handle gaps in the media timeline. Kinesis Video Streams
+    #   adjusts the media timeline in the manifest file to enable playback of
+    #   media with discontinuities. Therefore, the wall-clock time derived
+    #   from the manifest file may be inaccurate. If DisplayFragmentTimestamp
+    #   is set to `ALWAYS`, the accurate fragment timestamp is added to each S
+    #   element in the manifest file with the attribute name “kvs:ts”. A
+    #   custom MPEG-DASH media player is necessary to leverage this custom
+    #   attribute.
+    #
+    #   The default value is `NEVER`. When DASHFragmentSelector is
+    #   `SERVER_TIMESTAMP`, the timestamps will be the server start
+    #   timestamps. Similarly, when DASHFragmentSelector is
+    #   `PRODUCER_TIMESTAMP`, the timestamps will be the producer start
+    #   timestamps.
+    #
+    # @option params [String] :display_fragment_number
+    #   Fragments are identified in the manifest file based on their sequence
+    #   number in the session. If DisplayFragmentNumber is set to `ALWAYS`,
+    #   the Kinesis Video Streams fragment number is added to each S element
+    #   in the manifest file with the attribute name “kvs:fn”. These fragment
+    #   numbers can be used for logging or for use with other APIs (e.g.
+    #   `GetMedia` and `GetMediaForFragmentList`). A custom MPEG-DASH media
+    #   player is necessary to leverage these this custom attribute.
+    #
+    #   The default value is `NEVER`.
+    #
+    # @option params [Types::DASHFragmentSelector] :dash_fragment_selector
+    #   The time range of the requested fragment and the source of the
+    #   timestamps.
+    #
+    #   This parameter is required if `PlaybackMode` is `ON_DEMAND` or
+    #   `LIVE_REPLAY`. This parameter is optional if PlaybackMode is` LIVE. If
+    #   PlaybackMode is LIVE, the FragmentSelectorType can be set, but the
+    #   TimestampRange should not be set. If PlaybackMode is ON_DEMAND or
+    #   LIVE_REPLAY, both FragmentSelectorType and TimestampRange must be
+    #   set.</p>
+    #   `
+    #
+    # @option params [Integer] :expires
+    #   The time in seconds until the requested session expires. This value
+    #   can be between 300 (5 minutes) and 43200 (12 hours).
+    #
+    #   When a session expires, no new calls to `GetDashManifest`,
+    #   `GetMP4InitFragment`, or `GetMP4MediaFragment` can be made for that
+    #   session.
+    #
+    #   The default is 300 (5 minutes).
+    #
+    # @option params [Integer] :max_manifest_fragment_results
+    #   The maximum number of fragments that are returned in the MPEG-DASH
+    #   manifest.
+    #
+    #   When the `PlaybackMode` is `LIVE`, the most recent fragments are
+    #   returned up to this value. When the `PlaybackMode` is `ON_DEMAND`, the
+    #   oldest fragments are returned, up to this maximum number.
+    #
+    #   When there are a higher number of fragments available in a live
+    #   MPEG-DASH manifest, video players often buffer content before starting
+    #   playback. Increasing the buffer size increases the playback latency,
+    #   but it decreases the likelihood that rebuffering will occur during
+    #   playback. We recommend that a live MPEG-DASH manifest have a minimum
+    #   of 3 fragments and a maximum of 10 fragments.
+    #
+    #   The default is 5 fragments if `PlaybackMode` is `LIVE` or
+    #   `LIVE_REPLAY`, and 1,000 if `PlaybackMode` is `ON_DEMAND`.
+    #
+    #   The maximum value of 1,000 fragments corresponds to more than 16
+    #   minutes of video on streams with 1-second fragments, and more than 2
+    #   1/2 hours of video on streams with 10-second fragments.
+    #
+    # @return [Types::GetDASHStreamingSessionURLOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetDASHStreamingSessionURLOutput#dash_streaming_session_url #dash_streaming_session_url} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_dash_streaming_session_url({
+    #     stream_name: "StreamName",
+    #     stream_arn: "ResourceARN",
+    #     playback_mode: "LIVE", # accepts LIVE, LIVE_REPLAY, ON_DEMAND
+    #     display_fragment_timestamp: "ALWAYS", # accepts ALWAYS, NEVER
+    #     display_fragment_number: "ALWAYS", # accepts ALWAYS, NEVER
+    #     dash_fragment_selector: {
+    #       fragment_selector_type: "PRODUCER_TIMESTAMP", # accepts PRODUCER_TIMESTAMP, SERVER_TIMESTAMP
+    #       timestamp_range: {
+    #         start_timestamp: Time.now,
+    #         end_timestamp: Time.now,
+    #       },
+    #     },
+    #     expires: 1,
+    #     max_manifest_fragment_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.dash_streaming_session_url #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-video-archived-media-2017-09-30/GetDASHStreamingSessionURL AWS API Documentation
+    #
+    # @overload get_dash_streaming_session_url(params = {})
+    # @param [Hash] params ({})
+    def get_dash_streaming_session_url(params = {}, options = {})
+      req = build_request(:get_dash_streaming_session_url, params)
+      req.send_request(options)
+    end
+
     # Retrieves an HTTP Live Streaming (HLS) URL for the stream. You can
     # then open the URL in a browser or media player to view the stream
     # contents.
     #
-    # You must specify either the `StreamName` or the `StreamARN`.
+    # Both the `StreamName` and the `StreamARN` parameters are optional, but
+    # you must specify either the `StreamName` or the `StreamARN` when
+    # invoking this API operation.
     #
     # An Amazon Kinesis video stream has the following requirements for
     # providing data through HLS:
     #
-    # * The media must contain h.264 encoded video and, optionally, AAC
-    #   encoded audio. Specifically, the codec id of track 1 should be
-    #   `V_MPEG/ISO/AVC`. Optionally, the codec id of track 2 should be
-    #   `A_AAC`.
+    # * 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`.
     #
     # * 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 ([MPEG-4
-    #   specification ISO/IEC 14496-15][1]). For information about adapting
-    #   stream data to a given format, see [NAL Adaptation Flags][2].
+    #   the Advanced Video Coding (AVC) for H.264 format or HEVC for H.265
+    #   format ([MPEG-4 specification ISO/IEC 14496-15][1]). For information
+    #   about adapting stream data to a given format, see [NAL Adaptation
+    #   Flags][2].
     #
     # * The audio track (if present) of each fragment must contain codec
     #   private data in the AAC format ([AAC specification ISO/IEC
     #   13818-7][3]).
     #
     # Kinesis Video Streams HLS sessions contain fragments in the fragmented
-    # MPEG-4 form (also called fMP4 or CMAF), rather than the MPEG-2 form
-    # (also called TS chunks, which the HLS specification also supports).
-    # For more information about HLS fragment types, see the [HLS
-    # specification][4].
+    # MPEG-4 form (also called fMP4 or CMAF) or the MPEG-2 form (also called
+    # TS chunks, which the HLS specification also supports). For more
+    # information about HLS fragment types, see the [HLS specification][4].
     #
     # The following procedure shows how to use HLS with Kinesis Video
     # Streams:
@@ -390,7 +790,7 @@ module Aws::KinesisVideoArchivedMedia
     #   sharing it. For connection limits, see [Kinesis Video Streams
     #   Limits][7].
     #
-    # * A Kinesis video stream can have a maximum of five active HLS
+    # * A Kinesis video stream can have a maximum of ten active HLS
     #   streaming sessions. If a new session is created when the maximum
     #   number of sessions is already active, the oldest (earliest created)
     #   session is closed. The number of active `GetMedia` connections on a
@@ -398,6 +798,11 @@ module Aws::KinesisVideoArchivedMedia
     #   number of active HLS sessions does not count against the active
     #   `GetMedia` connection limit.
     #
+    #   <note markdown="1"> The maximum limits for active HLS and MPEG-DASH streaming sessions
+    #   are independent of each other.
+    #
+    #    </note>
+    #
     #  </note>
     #
     # You can monitor the amount of data that the media player consumes by
@@ -411,6 +816,27 @@ module Aws::KinesisVideoArchivedMedia
     # For more information about HLS, see [HTTP Live Streaming][10] on the
     # [Apple Developer site][11].
     #
+    # If an error is thrown after invoking a Kinesis Video Streams archived
+    # media API, in addition to the HTTP status code and the response body,
+    # it includes the following pieces of information:
+    #
+    #  * `x-amz-ErrorType` HTTP header – contains a more specific error type
+    #   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.
+    #
+    #  Both the HTTP status code and the ErrorType header can be utilized to
+    # make programmatic decisions about whether errors are retry-able and
+    # under what conditions, as well as provide information on what actions
+    # the client programmer might need to take in order to successfully try
+    # again.
+    #
+    #  For more information, see the **Errors** section at the bottom of
+    # this
+    # topic, as well as [Common Errors][12].
+    #
     #
     #
     # [1]: https://www.iso.org/standard/55980.html
@@ -424,6 +850,7 @@ module Aws::KinesisVideoArchivedMedia
     # [9]: https://aws.amazon.com/pricing/
     # [10]: https://developer.apple.com/streaming/
     # [11]: https://developer.apple.com
+    # [12]: https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/CommonErrors.html
     #
     # @option params [String] :stream_name
     #   The name of the stream for which to retrieve the HLS master playlist
@@ -438,9 +865,9 @@ module Aws::KinesisVideoArchivedMedia
     #   You must specify either the `StreamName` or the `StreamARN`.
     #
     # @option params [String] :playback_mode
-    #   Whether to retrieve live or archived, on-demand data.
+    #   Whether to retrieve live, live replay, or archived, on-demand data.
     #
-    #   Features of the two types of session include the following:
+    #   Features of the three types of sessions include the following:
     #
     #   * <b> <code>LIVE</code> </b>\: For sessions of this type, the HLS
     #     media playlist is continually updated with the latest fragments as
@@ -461,6 +888,20 @@ module Aws::KinesisVideoArchivedMedia
     #
     #      </note>
     #
+    #   * <b> <code>LIVE_REPLAY</code> </b>\: For sessions of this type, the
+    #     HLS media playlist is updated similarly to how it is updated for
+    #     `LIVE` mode except that it starts by including fragments from a
+    #     given start time. Instead of fragments being added as they are
+    #     ingested, fragments are added as the duration of the next fragment
+    #     elapses. For example, if the fragments in the session are two
+    #     seconds long, then a new fragment is added to the media playlist
+    #     every two seconds. This mode is useful to be able to start playback
+    #     from when an event is detected and continue live streaming media
+    #     that has not yet been ingested as of the time of the session
+    #     creation. This mode is also useful to stream previously archived
+    #     media without being limited by the 1,000 fragment limit in the
+    #     `ON_DEMAND` mode.
+    #
     #   * <b> <code>ON_DEMAND</code> </b>\: For sessions of this type, the HLS
     #     media playlist contains all the fragments for the session, up to the
     #     number that is specified in `MaxMediaPlaylistFragmentResults`. The
@@ -469,7 +910,7 @@ module Aws::KinesisVideoArchivedMedia
     #     typically displays a scrubber control for choosing the position in
     #     the playback window to display.
     #
-    #   In both playback modes, if `FragmentSelectorType` is
+    #   In all playback modes, if `FragmentSelectorType` is
     #   `PRODUCER_TIMESTAMP`, and if there are multiple fragments with the
     #   same start timestamp, the fragment that has the larger fragment number
     #   (that is, the newer fragment) is included in the HLS media playlist.
@@ -481,14 +922,16 @@ 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`. This
-    #   parameter is optional if `PlaybackMode` is `LIVE`. If `PlaybackMode`
-    #   is `LIVE`, the `FragmentSelectorType` can be set, but the
-    #   `TimestampRange` should not be set. If `PlaybackMode` is `ON_DEMAND`,
-    #   both `FragmentSelectorType` and `TimestampRange` must be set.
+    #   This parameter is required if `PlaybackMode` is `ON_DEMAND` or
+    #   `LIVE_REPLAY`. This parameter is optional if PlaybackMode is` LIVE. If
+    #   PlaybackMode is LIVE, the FragmentSelectorType can be set, but the
+    #   TimestampRange should not be set. If PlaybackMode is ON_DEMAND or
+    #   LIVE_REPLAY, both FragmentSelectorType and TimestampRange must be
+    #   set.</p>
+    #   `
     #
     # @option params [String] :container_format
     #   Specifies which format should be used for packaging the media.
@@ -504,23 +947,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
@@ -543,8 +1003,8 @@ module Aws::KinesisVideoArchivedMedia
     #   can be between 300 (5 minutes) and 43200 (12 hours).
     #
     #   When a session expires, no new calls to `GetHLSMasterPlaylist`,
-    #   `GetHLSMediaPlaylist`, `GetMP4InitFragment`, or `GetMP4MediaFragment`
-    #   can be made for that session.
+    #   `GetHLSMediaPlaylist`, `GetMP4InitFragment`, `GetMP4MediaFragment`, or
+    #   `GetTSFragment` can be made for that session.
     #
     #   The default is 300 (5 minutes).
     #
@@ -563,8 +1023,8 @@ module Aws::KinesisVideoArchivedMedia
     #   playback. We recommend that a live HLS media playlist have a minimum
     #   of 3 fragments and a maximum of 10 fragments.
     #
-    #   The default is 5 fragments if `PlaybackMode` is `LIVE`, and 1,000 if
-    #   `PlaybackMode` is `ON_DEMAND`.
+    #   The default is 5 fragments if `PlaybackMode` is `LIVE` or
+    #   `LIVE_REPLAY`, and 1,000 if `PlaybackMode` is `ON_DEMAND`.
     #
     #   The maximum value of 1,000 fragments corresponds to more than 16
     #   minutes of video on streams with 1-second fragments, and more than 2
@@ -579,7 +1039,7 @@ module Aws::KinesisVideoArchivedMedia
     #   resp = client.get_hls_streaming_session_url({
     #     stream_name: "StreamName",
     #     stream_arn: "ResourceARN",
-    #     playback_mode: "LIVE", # accepts LIVE, ON_DEMAND
+    #     playback_mode: "LIVE", # accepts LIVE, LIVE_REPLAY, ON_DEMAND
     #     hls_fragment_selector: {
     #       fragment_selector_type: "PRODUCER_TIMESTAMP", # accepts PRODUCER_TIMESTAMP, SERVER_TIMESTAMP
     #       timestamp_range: {
@@ -588,7 +1048,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,
@@ -626,9 +1086,31 @@ module Aws::KinesisVideoArchivedMedia
     #   megabytes per second (or 200 megabits per second) during a
     #   `GetMediaForFragmentList` session.
     #
+    # If an error is thrown after invoking a Kinesis Video Streams archived
+    # media API, in addition to the HTTP status code and the response body,
+    # it includes the following pieces of information:
+    #
+    #  * `x-amz-ErrorType` HTTP header – contains a more specific error type
+    #   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.
+    #
+    #  Both the HTTP status code and the ErrorType header can be utilized to
+    # make programmatic decisions about whether errors are retry-able and
+    # under what conditions, as well as provide information on what actions
+    # the client programmer might need to take in order to successfully try
+    # again.
+    #
+    #  For more information, see the **Errors** section at the bottom of
+    # this
+    # topic, as well as [Common Errors][2].
+    #
     #
     #
     # [1]: https://docs.aws.amazon.com/cli/latest/reference/
+    # [2]: https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/CommonErrors.html
     #
     # @option params [required, String] :stream_name
     #   The name of the stream from which to retrieve fragment media.
@@ -678,9 +1160,31 @@ module Aws::KinesisVideoArchivedMedia
     #
     #  </note>
     #
+    # If an error is thrown after invoking a Kinesis Video Streams archived
+    # media API, in addition to the HTTP status code and the response body,
+    # it includes the following pieces of information:
+    #
+    #  * `x-amz-ErrorType` HTTP header – contains a more specific error type
+    #   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.
+    #
+    #  Both the HTTP status code and the ErrorType header can be utilized to
+    # make programmatic decisions about whether errors are retry-able and
+    # under what conditions, as well as provide information on what actions
+    # the client programmer might need to take in order to successfully try
+    # again.
+    #
+    #  For more information, see the **Errors** section at the bottom of
+    # this
+    # topic, as well as [Common Errors][2].
+    #
     #
     #
     # [1]: https://docs.aws.amazon.com/cli/latest/reference/
+    # [2]: https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/CommonErrors.html
     #
     # @option params [required, String] :stream_name
     #   The name of the stream from which to retrieve a fragment list.
@@ -751,7 +1255,7 @@ module Aws::KinesisVideoArchivedMedia
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-kinesisvideoarchivedmedia'
-      context[:gem_version] = '1.16.0'
+      context[:gem_version] = '1.21.0'
       Seahorse::Client::Request.new(handlers, context)
     end