aws-sdk-ivs 1.37.0 → 1.38.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e467118b3a3d7f2fb19bed87415cd66ffc7df07970bb78237566b1e57555ee8b
-  data.tar.gz: 5785101b9da6d2c3a6dc53eb774cf54318cb93591404f55d3489d4488b0fe553
+  metadata.gz: 781cedc186bd7ffd229a0c7af006be656abd27fd36a9f0efad48aa2742cd6a5a
+  data.tar.gz: 4f12bbad4a6ef1cea9c0aa2d0704b0728f4950af7678b60bb582346a0cfb6e9c
 SHA512:
-  metadata.gz: 6c85df49e4b4d0ff5e69cce52f2aa5cf98357f7d355964431f1aa898f95fd49d42351d34ec9586da27d843cc5476fbf8c76e1fe098d971082132de85acf8af32
-  data.tar.gz: 594aadd98ef4d095823edf5aaf23bd60ae66aadb87ac1d0a4d8ebd8fc2d10f9929d919a635bb24a0eb05ea593f21ef33ab6c737c5351f6940ac725ebbea8bf6f
+  metadata.gz: ffcb4da849c4c1ef0c9319f3518845c46fbb33c918a03bf6d864844262ae561f4967a9326ed0831286f50d3fe447970fbf591ced72078f6661a308dcc8fff06f
+  data.tar.gz: 70e42d1882ae9dbad97ba36ef632b534db513e94af2bbe0ea4a4a36ad11478a26f74344afdfd2a93e84da1fd7899cf229779d63994079d38a0ff64e95e289361

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.38.0 (2023-07-17)
+------------------
+
+* Feature - This release provides the flexibility to configure what renditions or thumbnail qualities to record when creating recording configuration.
+
 1.37.0 (2023-07-11)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.37.0
+1.38.0

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

@@ -680,6 +680,10 @@ module Aws::IVS
     #   interval, the multiple streams will be considered a single broadcast
     #   and merged together. Default: 0.
     #
+    # @option params [Types::RenditionConfiguration] :rendition_configuration
+    #   Object that describes which renditions should be recorded for a
+    #   stream.
+    #
     # @option params [Hash<String,String>] :tags
     #   Array of 1-50 maps, each of the form `string:string (key:value)`. See
     #   [Tagging Amazon Web Services Resources][1] for more information,
@@ -710,11 +714,17 @@ module Aws::IVS
     #     },
     #     name: "RecordingConfigurationName",
     #     recording_reconnect_window_seconds: 1,
+    #     rendition_configuration: {
+    #       rendition_selection: "ALL", # accepts ALL, NONE, CUSTOM
+    #       renditions: ["FULL_HD"], # accepts FULL_HD, HD, SD, LOWEST_RESOLUTION
+    #     },
     #     tags: {
     #       "TagKey" => "TagValue",
     #     },
     #     thumbnail_configuration: {
     #       recording_mode: "DISABLED", # accepts DISABLED, INTERVAL
+    #       resolution: "FULL_HD", # accepts FULL_HD, HD, SD, LOWEST_RESOLUTION
+    #       storage: ["SEQUENTIAL"], # accepts SEQUENTIAL, LATEST
     #       target_interval_seconds: 1,
     #     },
     #   })
@@ -725,10 +735,16 @@ module Aws::IVS
     #   resp.recording_configuration.destination_configuration.s3.bucket_name #=> String
     #   resp.recording_configuration.name #=> String
     #   resp.recording_configuration.recording_reconnect_window_seconds #=> Integer
+    #   resp.recording_configuration.rendition_configuration.rendition_selection #=> String, one of "ALL", "NONE", "CUSTOM"
+    #   resp.recording_configuration.rendition_configuration.renditions #=> Array
+    #   resp.recording_configuration.rendition_configuration.renditions[0] #=> String, one of "FULL_HD", "HD", "SD", "LOWEST_RESOLUTION"
     #   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.resolution #=> String, one of "FULL_HD", "HD", "SD", "LOWEST_RESOLUTION"
+    #   resp.recording_configuration.thumbnail_configuration.storage #=> Array
+    #   resp.recording_configuration.thumbnail_configuration.storage[0] #=> String, one of "SEQUENTIAL", "LATEST"
     #   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
@@ -1006,10 +1022,16 @@ module Aws::IVS
     #   resp.recording_configuration.destination_configuration.s3.bucket_name #=> String
     #   resp.recording_configuration.name #=> String
     #   resp.recording_configuration.recording_reconnect_window_seconds #=> Integer
+    #   resp.recording_configuration.rendition_configuration.rendition_selection #=> String, one of "ALL", "NONE", "CUSTOM"
+    #   resp.recording_configuration.rendition_configuration.renditions #=> Array
+    #   resp.recording_configuration.rendition_configuration.renditions[0] #=> String, one of "FULL_HD", "HD", "SD", "LOWEST_RESOLUTION"
     #   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.resolution #=> String, one of "FULL_HD", "HD", "SD", "LOWEST_RESOLUTION"
+    #   resp.recording_configuration.thumbnail_configuration.storage #=> Array
+    #   resp.recording_configuration.thumbnail_configuration.storage[0] #=> String, one of "SEQUENTIAL", "LATEST"
     #   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
@@ -1140,10 +1162,16 @@ module Aws::IVS
     #   resp.stream_session.recording_configuration.destination_configuration.s3.bucket_name #=> String
     #   resp.stream_session.recording_configuration.name #=> String
     #   resp.stream_session.recording_configuration.recording_reconnect_window_seconds #=> Integer
+    #   resp.stream_session.recording_configuration.rendition_configuration.rendition_selection #=> String, one of "ALL", "NONE", "CUSTOM"
+    #   resp.stream_session.recording_configuration.rendition_configuration.renditions #=> Array
+    #   resp.stream_session.recording_configuration.rendition_configuration.renditions[0] #=> String, one of "FULL_HD", "HD", "SD", "LOWEST_RESOLUTION"
     #   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.resolution #=> String, one of "FULL_HD", "HD", "SD", "LOWEST_RESOLUTION"
+    #   resp.stream_session.recording_configuration.thumbnail_configuration.storage #=> Array
+    #   resp.stream_session.recording_configuration.thumbnail_configuration.storage[0] #=> String, one of "SEQUENTIAL", "LATEST"
     #   resp.stream_session.recording_configuration.thumbnail_configuration.target_interval_seconds #=> Integer
     #   resp.stream_session.start_time #=> Time
     #   resp.stream_session.stream_id #=> String
@@ -1866,7 +1894,7 @@ module Aws::IVS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-ivs'
-      context[:gem_version] = '1.37.0'
+      context[:gem_version] = '1.38.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -110,6 +110,10 @@ module Aws::IVS
     RecordingConfigurationSummary = Shapes::StructureShape.new(name: 'RecordingConfigurationSummary')
     RecordingMode = Shapes::StringShape.new(name: 'RecordingMode')
     RecordingReconnectWindowSeconds = Shapes::IntegerShape.new(name: 'RecordingReconnectWindowSeconds')
+    RenditionConfiguration = Shapes::StructureShape.new(name: 'RenditionConfiguration')
+    RenditionConfigurationRendition = Shapes::StringShape.new(name: 'RenditionConfigurationRendition')
+    RenditionConfigurationRenditionList = Shapes::ListShape.new(name: 'RenditionConfigurationRenditionList')
+    RenditionConfigurationRenditionSelection = Shapes::StringShape.new(name: 'RenditionConfigurationRenditionSelection')
     ResourceArn = Shapes::StringShape.new(name: 'ResourceArn')
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
     S3DestinationBucketName = Shapes::StringShape.new(name: 'S3DestinationBucketName')
@@ -152,6 +156,9 @@ module Aws::IVS
     TargetIntervalSeconds = Shapes::IntegerShape.new(name: 'TargetIntervalSeconds')
     ThrottlingException = Shapes::StructureShape.new(name: 'ThrottlingException')
     ThumbnailConfiguration = Shapes::StructureShape.new(name: 'ThumbnailConfiguration')
+    ThumbnailConfigurationResolution = Shapes::StringShape.new(name: 'ThumbnailConfigurationResolution')
+    ThumbnailConfigurationStorage = Shapes::StringShape.new(name: 'ThumbnailConfigurationStorage')
+    ThumbnailConfigurationStorageList = Shapes::ListShape.new(name: 'ThumbnailConfigurationStorageList')
     Time = Shapes::TimestampShape.new(name: 'Time', timestampFormat: "iso8601")
     TranscodePreset = Shapes::StringShape.new(name: 'TranscodePreset')
     UntagResourceRequest = Shapes::StructureShape.new(name: 'UntagResourceRequest')
@@ -269,6 +276,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(:recording_reconnect_window_seconds, Shapes::ShapeRef.new(shape: RecordingReconnectWindowSeconds, location_name: "recordingReconnectWindowSeconds"))
+    CreateRecordingConfigurationRequest.add_member(:rendition_configuration, Shapes::ShapeRef.new(shape: RenditionConfiguration, location_name: "renditionConfiguration"))
     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
@@ -435,6 +443,7 @@ module Aws::IVS
     RecordingConfiguration.add_member(:destination_configuration, Shapes::ShapeRef.new(shape: DestinationConfiguration, required: true, location_name: "destinationConfiguration"))
     RecordingConfiguration.add_member(:name, Shapes::ShapeRef.new(shape: RecordingConfigurationName, location_name: "name"))
     RecordingConfiguration.add_member(:recording_reconnect_window_seconds, Shapes::ShapeRef.new(shape: RecordingReconnectWindowSeconds, location_name: "recordingReconnectWindowSeconds"))
+    RecordingConfiguration.add_member(:rendition_configuration, Shapes::ShapeRef.new(shape: RenditionConfiguration, location_name: "renditionConfiguration"))
     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"))
@@ -449,6 +458,12 @@ module Aws::IVS
     RecordingConfigurationSummary.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "tags"))
     RecordingConfigurationSummary.struct_class = Types::RecordingConfigurationSummary
 
+    RenditionConfiguration.add_member(:rendition_selection, Shapes::ShapeRef.new(shape: RenditionConfigurationRenditionSelection, location_name: "renditionSelection"))
+    RenditionConfiguration.add_member(:renditions, Shapes::ShapeRef.new(shape: RenditionConfigurationRenditionList, location_name: "renditions"))
+    RenditionConfiguration.struct_class = Types::RenditionConfiguration
+
+    RenditionConfigurationRenditionList.member = Shapes::ShapeRef.new(shape: RenditionConfigurationRendition)
+
     ResourceNotFoundException.add_member(:exception_message, Shapes::ShapeRef.new(shape: errorMessage, location_name: "exceptionMessage"))
     ResourceNotFoundException.struct_class = Types::ResourceNotFoundException
 
@@ -551,9 +566,13 @@ module Aws::IVS
     ThrottlingException.struct_class = Types::ThrottlingException
 
     ThumbnailConfiguration.add_member(:recording_mode, Shapes::ShapeRef.new(shape: RecordingMode, location_name: "recordingMode"))
+    ThumbnailConfiguration.add_member(:resolution, Shapes::ShapeRef.new(shape: ThumbnailConfigurationResolution, location_name: "resolution"))
+    ThumbnailConfiguration.add_member(:storage, Shapes::ShapeRef.new(shape: ThumbnailConfigurationStorageList, location_name: "storage"))
     ThumbnailConfiguration.add_member(:target_interval_seconds, Shapes::ShapeRef.new(shape: TargetIntervalSeconds, location_name: "targetIntervalSeconds"))
     ThumbnailConfiguration.struct_class = Types::ThumbnailConfiguration
 
+    ThumbnailConfigurationStorageList.member = Shapes::ShapeRef.new(shape: ThumbnailConfigurationStorage)
+
     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
@@ -627,7 +646,10 @@ module Aws::IVS
         o.http_request_uri = "/BatchStartViewerSessionRevocation"
         o.input = Shapes::ShapeRef.new(shape: BatchStartViewerSessionRevocationRequest)
         o.output = Shapes::ShapeRef.new(shape: BatchStartViewerSessionRevocationResponse)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
         o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: PendingVerification)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
       end)
 
       api.add_operation(:create_channel, Seahorse::Model::Operation.new.tap do |o|
@@ -931,9 +953,11 @@ module Aws::IVS
         o.http_request_uri = "/StartViewerSessionRevocation"
         o.input = Shapes::ShapeRef.new(shape: StartViewerSessionRevocationRequest)
         o.output = Shapes::ShapeRef.new(shape: StartViewerSessionRevocationResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
         o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
         o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: PendingVerification)
         o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
       end)
 

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

@@ -644,6 +644,11 @@ module Aws::IVS
     #   and merged together. Default: 0.
     #   @return [Integer]
     #
+    # @!attribute [rw] rendition_configuration
+    #   Object that describes which renditions should be recorded for a
+    #   stream.
+    #   @return [Types::RenditionConfiguration]
+    #
     # @!attribute [rw] tags
     #   Array of 1-50 maps, each of the form `string:string (key:value)`.
     #   See [Tagging Amazon Web Services Resources][1] for more information,
@@ -668,6 +673,7 @@ module Aws::IVS
       :destination_configuration,
       :name,
       :recording_reconnect_window_seconds,
+      :rendition_configuration,
       :tags,
       :thumbnail_configuration)
       SENSITIVE = []
@@ -1413,6 +1419,11 @@ module Aws::IVS
     #   and merged together. Default: 0.
     #   @return [Integer]
     #
+    # @!attribute [rw] rendition_configuration
+    #   Object that describes which renditions should be recorded for a
+    #   stream.
+    #   @return [Types::RenditionConfiguration]
+    #
     # @!attribute [rw] state
     #   Indicates the current state of the recording configuration. When the
     #   state is `ACTIVE`, the configuration is ready for recording a
@@ -1444,6 +1455,7 @@ module Aws::IVS
       :destination_configuration,
       :name,
       :recording_reconnect_window_seconds,
+      :rendition_configuration,
       :state,
       :tags,
       :thumbnail_configuration)
@@ -1496,6 +1508,39 @@ module Aws::IVS
       include Aws::Structure
     end
 
+    # Object that describes which renditions should be recorded for a
+    # stream.
+    #
+    # @!attribute [rw] rendition_selection
+    #   Indicates which set of renditions are recorded for a stream. For
+    #   `BASIC` channels, the `CUSTOM` value has no effect. If `CUSTOM` is
+    #   specified, a set of renditions must be specified in the `renditions`
+    #   field. Default: `ALL`.
+    #   @return [String]
+    #
+    # @!attribute [rw] renditions
+    #   Indicates which renditions are recorded for a stream, if
+    #   `renditionSelection` is `CUSTOM`; otherwise, this field is
+    #   irrelevant. The selected renditions are recorded if they are
+    #   available during the stream. If a selected rendition is unavailable,
+    #   the best available rendition is recorded. For details on the
+    #   resolution dimensions of each rendition, see [Auto-Record to Amazon
+    #   S3][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/ivs/latest/userguide/record-to-s3.html
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/RenditionConfiguration AWS API Documentation
+    #
+    class RenditionConfiguration < Struct.new(
+      :rendition_selection,
+      :renditions)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] exception_message
     #   Request references a resource which does not exist.
     #   @return [String]
@@ -1945,18 +1990,42 @@ module Aws::IVS
     #   Thumbnail recording mode. Default: `INTERVAL`.
     #   @return [String]
     #
+    # @!attribute [rw] resolution
+    #   Indicates the desired resolution of recorded thumbnails. Thumbnails
+    #   are recorded at the selected resolution if the corresponding
+    #   rendition is available during the stream; otherwise, they are
+    #   recorded at source resolution. For more information about resolution
+    #   values and their corresponding height and width dimensions, see
+    #   [Auto-Record to Amazon S3][1]. Default: Null (source resolution is
+    #   returned).
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/ivs/latest/userguide/record-to-s3.html
+    #   @return [String]
+    #
+    # @!attribute [rw] storage
+    #   Indicates the format in which thumbnails are recorded. `SEQUENTIAL`
+    #   records all generated thumbnails in a serial manner, to the
+    #   media/thumbnails directory. `LATEST` saves the latest thumbnail in
+    #   media/latest\_thumbnail/thumb.jpg and overwrites it at the interval
+    #   specified by `targetIntervalSeconds`. You can enable both
+    #   `SEQUENTIAL` and `LATEST`. Default: `SEQUENTIAL`.
+    #   @return [Array<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.
+    #   **Important:** For the `BASIC` channel type, 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.
     #
     #
     #
@@ -1967,6 +2036,8 @@ module Aws::IVS
     #
     class ThumbnailConfiguration < Struct.new(
       :recording_mode,
+      :resolution,
+      :storage,
       :target_interval_seconds)
       SENSITIVE = []
       include Aws::Structure

data/lib/aws-sdk-ivs.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-ivs/customizations'
 # @!group service
 module Aws::IVS
 
-  GEM_VERSION = '1.37.0'
+  GEM_VERSION = '1.38.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ivs
 version: !ruby/object:Gem::Version
-  version: 1.37.0
+  version: 1.38.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-07-11 00:00:00.000000000 Z
+date: 2023-07-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core