aws-sdk-ivs 1.17.0 → 1.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 50fa4603c35c219f638f305e5df3ac249361189e58de77a990db436027761845
-  data.tar.gz: 7a7174f634f206e7dcd80ca559ceb2f8c50fb3ffdf4c922b19e474525c4c0851
+  metadata.gz: 80e7e30082cf7f21ad71dbf8e661c02d7909e46b10667ba062e1fb4885260488
+  data.tar.gz: 3dbd69d6790c293c4a8cd689dda1d04c7d90961e8abdfb48bf8bd04397d04b9d
 SHA512:
-  metadata.gz: fd57b662afaaefa003f7f0b3b50325868700107a9018dfc95b66a3e1eb6f3028d12845390cbdf1b177e7f9c6a8eb4ba3eaa51f1057276fab14ab97a0d5088815
-  data.tar.gz: 314fbd3acea7a69acec247faf0d1723bf60631110562c0e3513d38213fda0b58a0d44cecc4fa4bfe8486d7745361692b54e245ab3233fdd4c4b52f8e424e018a
+  metadata.gz: 1893d47cde84483ea185ff775692338b869f52bf8e237dc3e40fcfbe1b9155012f94f2c688fb1286d19ef558f9a9d921af0b2d13eae02d8d83d0a27be1911595
+  data.tar.gz: acae82ca9d5e379c6421814617470daff9978859f36695304e7e08742296dfc1db77bd201c91d1fc2becc67d40f1ab3e6858e0474831f01eb1f94218dbb87783

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.18.0 (2022-01-18)
+------------------
+
+* Feature - This release adds support for the new Thumbnail Configuration property for Recording Configurations. For more information see https://docs.aws.amazon.com/ivs/latest/userguide/record-to-s3.html
+
 1.17.0 (2021-12-21)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.17.0
+1.18.0

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

@@ -537,6 +537,11 @@ module Aws::IVS
     # @option params [Hash<String,String>] :tags
     #   Array of 1-50 maps, each of the form `string:string (key:value)`.
     #
+    # @option params [Types::ThumbnailConfiguration] :thumbnail_configuration
+    #   A complex type that allows you to enable/disable the recording of
+    #   thumbnails for a live session and modify the interval at which
+    #   thumbnails are generated for the live session.
+    #
     # @return [Types::CreateRecordingConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateRecordingConfigurationResponse#recording_configuration #recording_configuration} => Types::RecordingConfiguration
@@ -553,6 +558,10 @@ module Aws::IVS
     #     tags: {
     #       "TagKey" => "TagValue",
     #     },
+    #     thumbnail_configuration: {
+    #       recording_mode: "DISABLED", # accepts DISABLED, INTERVAL
+    #       target_interval_seconds: 1,
+    #     },
     #   })
     #
     # @example Response structure
@@ -563,6 +572,8 @@ module Aws::IVS
     #   resp.recording_configuration.state #=> String, one of "CREATING", "CREATE_FAILED", "ACTIVE"
     #   resp.recording_configuration.tags #=> Hash
     #   resp.recording_configuration.tags["TagKey"] #=> String
+    #   resp.recording_configuration.thumbnail_configuration.recording_mode #=> String, one of "DISABLED", "INTERVAL"
+    #   resp.recording_configuration.thumbnail_configuration.target_interval_seconds #=> Integer
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/CreateRecordingConfiguration AWS API Documentation
     #
@@ -831,6 +842,8 @@ module Aws::IVS
     #   resp.recording_configuration.state #=> String, one of "CREATING", "CREATE_FAILED", "ACTIVE"
     #   resp.recording_configuration.tags #=> Hash
     #   resp.recording_configuration.tags["TagKey"] #=> String
+    #   resp.recording_configuration.thumbnail_configuration.recording_mode #=> String, one of "DISABLED", "INTERVAL"
+    #   resp.recording_configuration.thumbnail_configuration.target_interval_seconds #=> Integer
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/GetRecordingConfiguration AWS API Documentation
     #
@@ -960,6 +973,8 @@ module Aws::IVS
     #   resp.stream_session.recording_configuration.state #=> String, one of "CREATING", "CREATE_FAILED", "ACTIVE"
     #   resp.stream_session.recording_configuration.tags #=> Hash
     #   resp.stream_session.recording_configuration.tags["TagKey"] #=> String
+    #   resp.stream_session.recording_configuration.thumbnail_configuration.recording_mode #=> String, one of "DISABLED", "INTERVAL"
+    #   resp.stream_session.recording_configuration.thumbnail_configuration.target_interval_seconds #=> Integer
     #   resp.stream_session.start_time #=> Time
     #   resp.stream_session.stream_id #=> String
     #   resp.stream_session.truncated_events #=> Array
@@ -1557,7 +1572,7 @@ module Aws::IVS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-ivs'
-      context[:gem_version] = '1.17.0'
+      context[:gem_version] = '1.18.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -101,6 +101,7 @@ module Aws::IVS
     RecordingConfigurationName = Shapes::StringShape.new(name: 'RecordingConfigurationName')
     RecordingConfigurationState = Shapes::StringShape.new(name: 'RecordingConfigurationState')
     RecordingConfigurationSummary = Shapes::StructureShape.new(name: 'RecordingConfigurationSummary')
+    RecordingMode = Shapes::StringShape.new(name: 'RecordingMode')
     ResourceArn = Shapes::StringShape.new(name: 'ResourceArn')
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
     S3DestinationBucketName = Shapes::StringShape.new(name: 'S3DestinationBucketName')
@@ -138,7 +139,9 @@ module Aws::IVS
     TagResourceResponse = Shapes::StructureShape.new(name: 'TagResourceResponse')
     TagValue = Shapes::StringShape.new(name: 'TagValue')
     Tags = Shapes::MapShape.new(name: 'Tags')
+    TargetIntervalSeconds = Shapes::IntegerShape.new(name: 'TargetIntervalSeconds')
     ThrottlingException = Shapes::StructureShape.new(name: 'ThrottlingException')
+    ThumbnailConfiguration = Shapes::StructureShape.new(name: 'ThumbnailConfiguration')
     Time = Shapes::TimestampShape.new(name: 'Time', timestampFormat: "iso8601")
     UntagResourceRequest = Shapes::StructureShape.new(name: 'UntagResourceRequest')
     UntagResourceResponse = Shapes::StructureShape.new(name: 'UntagResourceResponse')
@@ -225,6 +228,7 @@ module Aws::IVS
     CreateRecordingConfigurationRequest.add_member(:destination_configuration, Shapes::ShapeRef.new(shape: DestinationConfiguration, required: true, location_name: "destinationConfiguration"))
     CreateRecordingConfigurationRequest.add_member(:name, Shapes::ShapeRef.new(shape: RecordingConfigurationName, location_name: "name"))
     CreateRecordingConfigurationRequest.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "tags"))
+    CreateRecordingConfigurationRequest.add_member(:thumbnail_configuration, Shapes::ShapeRef.new(shape: ThumbnailConfiguration, location_name: "thumbnailConfiguration"))
     CreateRecordingConfigurationRequest.struct_class = Types::CreateRecordingConfigurationRequest
 
     CreateRecordingConfigurationResponse.add_member(:recording_configuration, Shapes::ShapeRef.new(shape: RecordingConfiguration, location_name: "recordingConfiguration"))
@@ -390,6 +394,7 @@ module Aws::IVS
     RecordingConfiguration.add_member(:name, Shapes::ShapeRef.new(shape: RecordingConfigurationName, location_name: "name"))
     RecordingConfiguration.add_member(:state, Shapes::ShapeRef.new(shape: RecordingConfigurationState, required: true, location_name: "state"))
     RecordingConfiguration.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "tags"))
+    RecordingConfiguration.add_member(:thumbnail_configuration, Shapes::ShapeRef.new(shape: ThumbnailConfiguration, location_name: "thumbnailConfiguration"))
     RecordingConfiguration.struct_class = Types::RecordingConfiguration
 
     RecordingConfigurationList.member = Shapes::ShapeRef.new(shape: RecordingConfigurationSummary)
@@ -495,6 +500,10 @@ module Aws::IVS
     ThrottlingException.add_member(:exception_message, Shapes::ShapeRef.new(shape: errorMessage, location_name: "exceptionMessage"))
     ThrottlingException.struct_class = Types::ThrottlingException
 
+    ThumbnailConfiguration.add_member(:recording_mode, Shapes::ShapeRef.new(shape: RecordingMode, location_name: "recordingMode"))
+    ThumbnailConfiguration.add_member(:target_interval_seconds, Shapes::ShapeRef.new(shape: TargetIntervalSeconds, location_name: "targetIntervalSeconds"))
+    ThumbnailConfiguration.struct_class = Types::ThumbnailConfiguration
+
     UntagResourceRequest.add_member(:resource_arn, Shapes::ShapeRef.new(shape: ResourceArn, required: true, location: "uri", location_name: "resourceArn"))
     UntagResourceRequest.add_member(:tag_keys, Shapes::ShapeRef.new(shape: TagKeyList, required: true, location: "querystring", location_name: "tagKeys"))
     UntagResourceRequest.struct_class = Types::UntagResourceRequest
@@ -822,6 +831,7 @@ module Aws::IVS
         o.input = Shapes::ShapeRef.new(shape: ListStreamsRequest)
         o.output = Shapes::ShapeRef.new(shape: ListStreamsResponse)
         o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
         o[:pager] = Aws::Pager.new(
           limit_key: "max_results",
           tokens: {

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

@@ -385,6 +385,10 @@ module Aws::IVS
     #         tags: {
     #           "TagKey" => "TagValue",
     #         },
+    #         thumbnail_configuration: {
+    #           recording_mode: "DISABLED", # accepts DISABLED, INTERVAL
+    #           target_interval_seconds: 1,
+    #         },
     #       }
     #
     # @!attribute [rw] destination_configuration
@@ -400,12 +404,19 @@ module Aws::IVS
     #   Array of 1-50 maps, each of the form `string:string (key:value)`.
     #   @return [Hash<String,String>]
     #
+    # @!attribute [rw] thumbnail_configuration
+    #   A complex type that allows you to enable/disable the recording of
+    #   thumbnails for a live session and modify the interval at which
+    #   thumbnails are generated for the live session.
+    #   @return [Types::ThumbnailConfiguration]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/CreateRecordingConfigurationRequest AWS API Documentation
     #
     class CreateRecordingConfigurationRequest < Struct.new(
       :destination_configuration,
       :name,
-      :tags)
+      :tags,
+      :thumbnail_configuration)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1078,6 +1089,7 @@ module Aws::IVS
     #   @return [String]
     #
     # @!attribute [rw] stream_sessions
+    #   List of stream sessions.
     #   @return [Array<Types::StreamSessionSummary>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/ListStreamSessionsResponse AWS API Documentation
@@ -1287,6 +1299,12 @@ module Aws::IVS
     #   Array of 1-50 maps, each of the form `string:string (key:value)`.
     #   @return [Hash<String,String>]
     #
+    # @!attribute [rw] thumbnail_configuration
+    #   A complex type that allows you to enable/disable the recording of
+    #   thumbnails for a live session and modify the interval at which
+    #   thumbnails are generated for the live session.
+    #   @return [Types::ThumbnailConfiguration]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/RecordingConfiguration AWS API Documentation
     #
     class RecordingConfiguration < Struct.new(
@@ -1294,7 +1312,8 @@ module Aws::IVS
       :destination_configuration,
       :name,
       :state,
-      :tags)
+      :tags,
+      :thumbnail_configuration)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1745,6 +1764,48 @@ module Aws::IVS
       include Aws::Structure
     end
 
+    # An object representing a configuration of thumbnails for recorded
+    # video.
+    #
+    # @note When making an API call, you may pass ThumbnailConfiguration
+    #   data as a hash:
+    #
+    #       {
+    #         recording_mode: "DISABLED", # accepts DISABLED, INTERVAL
+    #         target_interval_seconds: 1,
+    #       }
+    #
+    # @!attribute [rw] recording_mode
+    #   Thumbnail recording mode. Default: `INTERVAL`.
+    #   @return [String]
+    #
+    # @!attribute [rw] target_interval_seconds
+    #   The targeted thumbnail-generation interval in seconds. This is
+    #   configurable (and required) only if `recordingMode` is `INTERVAL`.
+    #   Default: 60.
+    #
+    #   **Important:** Setting a value for `targetIntervalSeconds` does not
+    #   guarantee that thumbnails are generated at the specified interval.
+    #   For thumbnails to be generated at the `targetIntervalSeconds`
+    #   interval, the `IDR/Keyframe` value for the input video must be less
+    #   than the `targetIntervalSeconds` value. See [ Amazon IVS Streaming
+    #   Configuration][1] for information on setting `IDR/Keyframe` to the
+    #   recommended value in video-encoder settings.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/ivs/latest/userguide/streaming-config.html
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/ThumbnailConfiguration AWS API Documentation
+    #
+    class ThumbnailConfiguration < Struct.new(
+      :recording_mode,
+      :target_interval_seconds)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass UntagResourceRequest
     #   data as a hash:
     #

data/lib/aws-sdk-ivs.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-ivs/customizations'
 # @!group service
 module Aws::IVS
 
-  GEM_VERSION = '1.17.0'
+  GEM_VERSION = '1.18.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ivs
 version: !ruby/object:Gem::Version
-  version: 1.17.0
+  version: 1.18.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-12-21 00:00:00.000000000 Z
+date: 2022-01-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core