aws-sdk-kinesisvideoarchivedmedia 1.19.0 → 1.24.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 2c63f8222ba081bf804fcf84b7d3ec9c9cda98a9
-  data.tar.gz: b6041842d2005028573c9d1e78609fcd604ba80d
+SHA256:
+  metadata.gz: 5690d22953400fb776cde8fd8e468bbe1f63072c26c166b1c10563500d120ae9
+  data.tar.gz: d69c149d62a2144aeed5fce8e0297fd9c079888cb7414a1135f3342f31cbef2f
 SHA512:
-  metadata.gz: cfffcf4f8beafff1a36a07d6e6ddb428bea95508e6bb7175674d274e9ab3cf9072f44a94b8c99b21a72f3d0f2328c756b111939eb3f7fb7ad8f40dd38e70cab6
-  data.tar.gz: 1beac9db327d3cf993bfba4d66645b69c4e0534b393aed67589cbda55f3a3def6c00830dee2b6342c2e7ba25e3509276c897d84fceb4757d092a5d4c93a9a419
+  metadata.gz: 3119727a1eafedaf87cb2933bc9f6fd7775d3b708016c3b8a182b5a2c99e3a4924d13e0b341e8da49b85109d22107d58e4aee82d786d970a358177cacf41f6b8
+  data.tar.gz: 933a7861a1cd472a392a460740a6a64c8377943d88467e2da0d5ebab0c26224f029cbd3efb33cf7fe9b3566684eb9034254aab1732ea5686ae2fb14bc4a36b76

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.19.0'
+  GEM_VERSION = '1.24.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
@@ -93,7 +105,7 @@ module Aws::KinesisVideoArchivedMedia
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
     #     used to determine the service `:endpoint`. When not passed,
-    #     a default `:region` is search for in the following locations:
+    #     a default `:region` is searched for in the following locations:
     #
     #     * `Aws.config[:region]`
     #     * `ENV['AWS_REGION']`
@@ -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.
@@ -139,7 +161,7 @@ module Aws::KinesisVideoArchivedMedia
     #   @option options [String] :endpoint
     #     The client endpoint is normally constructed from the `:region`
     #     option. You should only configure an `:endpoint` when connecting
-    #     to test endpoints. This should be avalid HTTP(S) URI.
+    #     to test endpoints. This should be a valid HTTP(S) URI.
     #
     #   @option options [Integer] :endpoint_cache_max_entries (1000)
     #     Used for the maximum size limit of the LRU cache storing endpoints data
@@ -154,7 +176,7 @@ module Aws::KinesisVideoArchivedMedia
     #     requests fetching endpoints information. Defaults to 60 sec.
     #
     #   @option options [Boolean] :endpoint_discovery (false)
-    #     When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
+    #     When set to `true`, endpoint discovery will be enabled for operations when available.
     #
     #   @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
     #     The log formatter.
@@ -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.
@@ -1157,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
@@ -1204,7 +1337,7 @@ module Aws::KinesisVideoArchivedMedia
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-kinesisvideoarchivedmedia'
-      context[:gem_version] = '1.19.0'
+      context[:gem_version] = '1.24.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:
     #
@@ -881,13 +1028,26 @@ module Aws::KinesisVideoArchivedMedia
       include Aws::Structure
     end
 
+    # One or more frames in the requested clip could not be parsed based on
+    # the specified codec.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-video-archived-media-2017-09-30/InvalidMediaFrameException AWS API Documentation
+    #
+    class InvalidMediaFrameException < Struct.new(
+      :message)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass ListFragmentsInput
     #   data as a hash:
     #
     #       {
     #         stream_name: "StreamName", # required
     #         max_results: 1,
-    #         next_token: "String",
+    #         next_token: "NextToken",
     #         fragment_selector: {
     #           fragment_selector_type: "PRODUCER_TIMESTAMP", # required, accepts PRODUCER_TIMESTAMP, SERVER_TIMESTAMP
     #           timestamp_range: { # required

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-kinesisvideoarchivedmedia
 version: !ruby/object:Gem::Version
-  version: 1.19.0
+  version: 1.24.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-10-15 00:00:00.000000000 Z
+date: 2020-05-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.61.1
+        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.61.1
+        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