aws-sdk-ivs 1.37.0 → 1.39.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e467118b3a3d7f2fb19bed87415cd66ffc7df07970bb78237566b1e57555ee8b
-  data.tar.gz: 5785101b9da6d2c3a6dc53eb774cf54318cb93591404f55d3489d4488b0fe553
+  metadata.gz: 9f8e3f0fb3b0b47e3a751a5c99ee05cb86b35bf62bbec4c8aca8fa81aff19bbd
+  data.tar.gz: c25be77af794eba2f5489c9206fbd909fb15cc1cdcc3a719f329a078a6e2afdc
 SHA512:
-  metadata.gz: 6c85df49e4b4d0ff5e69cce52f2aa5cf98357f7d355964431f1aa898f95fd49d42351d34ec9586da27d843cc5476fbf8c76e1fe098d971082132de85acf8af32
-  data.tar.gz: 594aadd98ef4d095823edf5aaf23bd60ae66aadb87ac1d0a4d8ebd8fc2d10f9929d919a635bb24a0eb05ea593f21ef33ab6c737c5351f6940ac725ebbea8bf6f
+  metadata.gz: 141742dfeb37227629c80c4f5c37f60d95b5f3e6cee11c0ddae2ae9a1b4f98990bb4eedb95325fa83632985b581f96fd56bf9c2eee0e222cb024ee5c156532be
+  data.tar.gz: 0cd657c886ce3e33b6bbef24e3b8e9b9139fc44fe7d0eb41898490d8d4080807ee7eec0dcd40ca9d7fa95c765b2438821c11870708aa9af22c9a8a075dad1b6b

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.39.0 (2023-08-31)
+------------------
+
+* Feature - Updated "type" description for CreateChannel, UpdateChannel, Channel, and ChannelSummary.
+
+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.39.0

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

@@ -553,55 +553,12 @@ module Aws::IVS
     # @option params [String] :type
     #   Channel type, which determines the allowable resolution and bitrate.
     #   *If you exceed the allowable input resolution or bitrate, the stream
-    #   probably will disconnect immediately.* Some types generate multiple
-    #   qualities (renditions) from the original input; this automatically
-    #   gives viewers the best experience for their devices and network
-    #   conditions. Some types provide transcoded video; transcoding allows
-    #   higher playback quality across a range of download speeds. Default:
-    #   `STANDARD`. Valid values:
-    #
-    #   * `BASIC`: Video is transmuxed: Amazon IVS delivers the original input
-    #     quality to viewers. The viewer’s video-quality choice is limited to
-    #     the original input. Input resolution can be up to 1080p and bitrate
-    #     can be up to 1.5 Mbps for 480p and up to 3.5 Mbps for resolutions
-    #     between 480p and 1080p. Original audio is passed through.
-    #
-    #   * `STANDARD`: Video is transcoded: multiple qualities are generated
-    #     from the original input, to automatically give viewers the best
-    #     experience for their devices and network conditions. Transcoding
-    #     allows higher playback quality across a range of download speeds.
-    #     Resolution can be up to 1080p and bitrate can be up to 8.5 Mbps.
-    #     Audio is transcoded only for renditions 360p and below; above that,
-    #     audio is passed through. This is the default when you create a
-    #     channel.
-    #
-    #   * `ADVANCED_SD`: Video is transcoded; multiple qualities are generated
-    #     from the original input, to automatically give viewers the best
-    #     experience for their devices and network conditions. Input
-    #     resolution can be up to 1080p and bitrate can be up to 8.5 Mbps;
-    #     output is capped at SD quality (480p). You can select an optional
-    #     transcode preset (see below). Audio for all renditions is
-    #     transcoded, and an audio-only rendition is available.
-    #
-    #   * `ADVANCED_HD`: Video is transcoded; multiple qualities are generated
-    #     from the original input, to automatically give viewers the best
-    #     experience for their devices and network conditions. Input
-    #     resolution can be up to 1080p and bitrate can be up to 8.5 Mbps;
-    #     output is capped at HD quality (720p). You can select an optional
-    #     transcode preset (see below). Audio for all renditions is
-    #     transcoded, and an audio-only rendition is available.
-    #
-    #   Optional *transcode presets* (available for the `ADVANCED` types)
-    #   allow you to trade off available download bandwidth and video quality,
-    #   to optimize the viewing experience. There are two presets:
-    #
-    #   * *Constrained bandwidth delivery* uses a lower bitrate for each
-    #     quality level. Use it if you have low download bandwidth and/or
-    #     simple video content (e.g., talking heads)
-    #
-    #   * *Higher bandwidth delivery* uses a higher bitrate for each quality
-    #     level. Use it if you have high download bandwidth and/or complex
-    #     video content (e.g., flashes and quick scene changes).
+    #   probably will disconnect immediately.* Default: `STANDARD`. For
+    #   details, see [Channel Types][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/ivs/latest/LowLatencyAPIReference/channel-types.html
     #
     # @return [Types::CreateChannelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -680,6 +637,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 +671,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 +692,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 +979,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 +1119,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
@@ -1762,55 +1747,12 @@ module Aws::IVS
     # @option params [String] :type
     #   Channel type, which determines the allowable resolution and bitrate.
     #   *If you exceed the allowable input resolution or bitrate, the stream
-    #   probably will disconnect immediately.* Some types generate multiple
-    #   qualities (renditions) from the original input; this automatically
-    #   gives viewers the best experience for their devices and network
-    #   conditions. Some types provide transcoded video; transcoding allows
-    #   higher playback quality across a range of download speeds. Default:
-    #   `STANDARD`. Valid values:
-    #
-    #   * `BASIC`: Video is transmuxed: Amazon IVS delivers the original input
-    #     quality to viewers. The viewer’s video-quality choice is limited to
-    #     the original input. Input resolution can be up to 1080p and bitrate
-    #     can be up to 1.5 Mbps for 480p and up to 3.5 Mbps for resolutions
-    #     between 480p and 1080p. Original audio is passed through.
-    #
-    #   * `STANDARD`: Video is transcoded: multiple qualities are generated
-    #     from the original input, to automatically give viewers the best
-    #     experience for their devices and network conditions. Transcoding
-    #     allows higher playback quality across a range of download speeds.
-    #     Resolution can be up to 1080p and bitrate can be up to 8.5 Mbps.
-    #     Audio is transcoded only for renditions 360p and below; above that,
-    #     audio is passed through. This is the default when you create a
-    #     channel.
-    #
-    #   * `ADVANCED_SD`: Video is transcoded; multiple qualities are generated
-    #     from the original input, to automatically give viewers the best
-    #     experience for their devices and network conditions. Input
-    #     resolution can be up to 1080p and bitrate can be up to 8.5 Mbps;
-    #     output is capped at SD quality (480p). You can select an optional
-    #     transcode preset (see below). Audio for all renditions is
-    #     transcoded, and an audio-only rendition is available.
-    #
-    #   * `ADVANCED_HD`: Video is transcoded; multiple qualities are generated
-    #     from the original input, to automatically give viewers the best
-    #     experience for their devices and network conditions. Input
-    #     resolution can be up to 1080p and bitrate can be up to 8.5 Mbps;
-    #     output is capped at HD quality (720p). You can select an optional
-    #     transcode preset (see below). Audio for all renditions is
-    #     transcoded, and an audio-only rendition is available.
-    #
-    #   Optional *transcode presets* (available for the `ADVANCED` types)
-    #   allow you to trade off available download bandwidth and video quality,
-    #   to optimize the viewing experience. There are two presets:
-    #
-    #   * *Constrained bandwidth delivery* uses a lower bitrate for each
-    #     quality level. Use it if you have low download bandwidth and/or
-    #     simple video content (e.g., talking heads)
-    #
-    #   * *Higher bandwidth delivery* uses a higher bitrate for each quality
-    #     level. Use it if you have high download bandwidth and/or complex
-    #     video content (e.g., flashes and quick scene changes).
+    #   probably will disconnect immediately.* Default: `STANDARD`. For
+    #   details, see [Channel Types][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/ivs/latest/LowLatencyAPIReference/channel-types.html
     #
     # @return [Types::UpdateChannelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1866,7 +1808,7 @@ module Aws::IVS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-ivs'
-      context[:gem_version] = '1.37.0'
+      context[:gem_version] = '1.39.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

@@ -282,56 +282,12 @@ module Aws::IVS
     # @!attribute [rw] type
     #   Channel type, which determines the allowable resolution and bitrate.
     #   *If you exceed the allowable input resolution or bitrate, the stream
-    #   probably will disconnect immediately.* Some types generate multiple
-    #   qualities (renditions) from the original input; this automatically
-    #   gives viewers the best experience for their devices and network
-    #   conditions. Some types provide transcoded video; transcoding allows
-    #   higher playback quality across a range of download speeds. Default:
-    #   `STANDARD`. Valid values:
-    #
-    #   * `BASIC`: Video is transmuxed: Amazon IVS delivers the original
-    #     input quality to viewers. The viewer’s video-quality choice is
-    #     limited to the original input. Input resolution can be up to 1080p
-    #     and bitrate can be up to 1.5 Mbps for 480p and up to 3.5 Mbps for
-    #     resolutions between 480p and 1080p. Original audio is passed
-    #     through.
-    #
-    #   * `STANDARD`: Video is transcoded: multiple qualities are generated
-    #     from the original input, to automatically give viewers the best
-    #     experience for their devices and network conditions. Transcoding
-    #     allows higher playback quality across a range of download speeds.
-    #     Resolution can be up to 1080p and bitrate can be up to 8.5 Mbps.
-    #     Audio is transcoded only for renditions 360p and below; above
-    #     that, audio is passed through. This is the default when you create
-    #     a channel.
-    #
-    #   * `ADVANCED_SD`: Video is transcoded; multiple qualities are
-    #     generated from the original input, to automatically give viewers
-    #     the best experience for their devices and network conditions.
-    #     Input resolution can be up to 1080p and bitrate can be up to 8.5
-    #     Mbps; output is capped at SD quality (480p). You can select an
-    #     optional transcode preset (see below). Audio for all renditions is
-    #     transcoded, and an audio-only rendition is available.
-    #
-    #   * `ADVANCED_HD`: Video is transcoded; multiple qualities are
-    #     generated from the original input, to automatically give viewers
-    #     the best experience for their devices and network conditions.
-    #     Input resolution can be up to 1080p and bitrate can be up to 8.5
-    #     Mbps; output is capped at HD quality (720p). You can select an
-    #     optional transcode preset (see below). Audio for all renditions is
-    #     transcoded, and an audio-only rendition is available.
-    #
-    #   Optional *transcode presets* (available for the `ADVANCED` types)
-    #   allow you to trade off available download bandwidth and video
-    #   quality, to optimize the viewing experience. There are two presets:
-    #
-    #   * *Constrained bandwidth delivery* uses a lower bitrate for each
-    #     quality level. Use it if you have low download bandwidth and/or
-    #     simple video content (e.g., talking heads)
-    #
-    #   * *Higher bandwidth delivery* uses a higher bitrate for each quality
-    #     level. Use it if you have high download bandwidth and/or complex
-    #     video content (e.g., flashes and quick scene changes).
+    #   probably will disconnect immediately.* Default: `STANDARD`. For
+    #   details, see [Channel Types][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/ivs/latest/LowLatencyAPIReference/channel-types.html
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/Channel AWS API Documentation
@@ -419,56 +375,12 @@ module Aws::IVS
     # @!attribute [rw] type
     #   Channel type, which determines the allowable resolution and bitrate.
     #   *If you exceed the allowable input resolution or bitrate, the stream
-    #   probably will disconnect immediately.* Some types generate multiple
-    #   qualities (renditions) from the original input; this automatically
-    #   gives viewers the best experience for their devices and network
-    #   conditions. Some types provide transcoded video; transcoding allows
-    #   higher playback quality across a range of download speeds. Default:
-    #   `STANDARD`. Valid values:
-    #
-    #   * `BASIC`: Video is transmuxed: Amazon IVS delivers the original
-    #     input quality to viewers. The viewer’s video-quality choice is
-    #     limited to the original input. Input resolution can be up to 1080p
-    #     and bitrate can be up to 1.5 Mbps for 480p and up to 3.5 Mbps for
-    #     resolutions between 480p and 1080p. Original audio is passed
-    #     through.
-    #
-    #   * `STANDARD`: Video is transcoded: multiple qualities are generated
-    #     from the original input, to automatically give viewers the best
-    #     experience for their devices and network conditions. Transcoding
-    #     allows higher playback quality across a range of download speeds.
-    #     Resolution can be up to 1080p and bitrate can be up to 8.5 Mbps.
-    #     Audio is transcoded only for renditions 360p and below; above
-    #     that, audio is passed through. This is the default when you create
-    #     a channel.
-    #
-    #   * `ADVANCED_SD`: Video is transcoded; multiple qualities are
-    #     generated from the original input, to automatically give viewers
-    #     the best experience for their devices and network conditions.
-    #     Input resolution can be up to 1080p and bitrate can be up to 8.5
-    #     Mbps; output is capped at SD quality (480p). You can select an
-    #     optional transcode preset (see below). Audio for all renditions is
-    #     transcoded, and an audio-only rendition is available.
-    #
-    #   * `ADVANCED_HD`: Video is transcoded; multiple qualities are
-    #     generated from the original input, to automatically give viewers
-    #     the best experience for their devices and network conditions.
-    #     Input resolution can be up to 1080p and bitrate can be up to 8.5
-    #     Mbps; output is capped at HD quality (720p). You can select an
-    #     optional transcode preset (see below). Audio for all renditions is
-    #     transcoded, and an audio-only rendition is available.
-    #
-    #   Optional *transcode presets* (available for the `ADVANCED` types)
-    #   allow you to trade off available download bandwidth and video
-    #   quality, to optimize the viewing experience. There are two presets:
-    #
-    #   * *Constrained bandwidth delivery* uses a lower bitrate for each
-    #     quality level. Use it if you have low download bandwidth and/or
-    #     simple video content (e.g., talking heads)
-    #
-    #   * *Higher bandwidth delivery* uses a higher bitrate for each quality
-    #     level. Use it if you have high download bandwidth and/or complex
-    #     video content (e.g., flashes and quick scene changes).
+    #   probably will disconnect immediately.* Default: `STANDARD`. For
+    #   details, see [Channel Types][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/ivs/latest/LowLatencyAPIReference/channel-types.html
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/ChannelSummary AWS API Documentation
@@ -547,56 +459,12 @@ module Aws::IVS
     # @!attribute [rw] type
     #   Channel type, which determines the allowable resolution and bitrate.
     #   *If you exceed the allowable input resolution or bitrate, the stream
-    #   probably will disconnect immediately.* Some types generate multiple
-    #   qualities (renditions) from the original input; this automatically
-    #   gives viewers the best experience for their devices and network
-    #   conditions. Some types provide transcoded video; transcoding allows
-    #   higher playback quality across a range of download speeds. Default:
-    #   `STANDARD`. Valid values:
-    #
-    #   * `BASIC`: Video is transmuxed: Amazon IVS delivers the original
-    #     input quality to viewers. The viewer’s video-quality choice is
-    #     limited to the original input. Input resolution can be up to 1080p
-    #     and bitrate can be up to 1.5 Mbps for 480p and up to 3.5 Mbps for
-    #     resolutions between 480p and 1080p. Original audio is passed
-    #     through.
-    #
-    #   * `STANDARD`: Video is transcoded: multiple qualities are generated
-    #     from the original input, to automatically give viewers the best
-    #     experience for their devices and network conditions. Transcoding
-    #     allows higher playback quality across a range of download speeds.
-    #     Resolution can be up to 1080p and bitrate can be up to 8.5 Mbps.
-    #     Audio is transcoded only for renditions 360p and below; above
-    #     that, audio is passed through. This is the default when you create
-    #     a channel.
-    #
-    #   * `ADVANCED_SD`: Video is transcoded; multiple qualities are
-    #     generated from the original input, to automatically give viewers
-    #     the best experience for their devices and network conditions.
-    #     Input resolution can be up to 1080p and bitrate can be up to 8.5
-    #     Mbps; output is capped at SD quality (480p). You can select an
-    #     optional transcode preset (see below). Audio for all renditions is
-    #     transcoded, and an audio-only rendition is available.
-    #
-    #   * `ADVANCED_HD`: Video is transcoded; multiple qualities are
-    #     generated from the original input, to automatically give viewers
-    #     the best experience for their devices and network conditions.
-    #     Input resolution can be up to 1080p and bitrate can be up to 8.5
-    #     Mbps; output is capped at HD quality (720p). You can select an
-    #     optional transcode preset (see below). Audio for all renditions is
-    #     transcoded, and an audio-only rendition is available.
-    #
-    #   Optional *transcode presets* (available for the `ADVANCED` types)
-    #   allow you to trade off available download bandwidth and video
-    #   quality, to optimize the viewing experience. There are two presets:
-    #
-    #   * *Constrained bandwidth delivery* uses a lower bitrate for each
-    #     quality level. Use it if you have low download bandwidth and/or
-    #     simple video content (e.g., talking heads)
-    #
-    #   * *Higher bandwidth delivery* uses a higher bitrate for each quality
-    #     level. Use it if you have high download bandwidth and/or complex
-    #     video content (e.g., flashes and quick scene changes).
+    #   probably will disconnect immediately.* Default: `STANDARD`. For
+    #   details, see [Channel Types][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/ivs/latest/LowLatencyAPIReference/channel-types.html
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/CreateChannelRequest AWS API Documentation
@@ -644,6 +512,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 +541,7 @@ module Aws::IVS
       :destination_configuration,
       :name,
       :recording_reconnect_window_seconds,
+      :rendition_configuration,
       :tags,
       :thumbnail_configuration)
       SENSITIVE = []
@@ -1413,6 +1287,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 +1323,7 @@ module Aws::IVS
       :destination_configuration,
       :name,
       :recording_reconnect_window_seconds,
+      :rendition_configuration,
       :state,
       :tags,
       :thumbnail_configuration)
@@ -1496,6 +1376,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 +1858,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 +1904,8 @@ module Aws::IVS
     #
     class ThumbnailConfiguration < Struct.new(
       :recording_mode,
+      :resolution,
+      :storage,
       :target_interval_seconds)
       SENSITIVE = []
       include Aws::Structure
@@ -2042,56 +1981,12 @@ module Aws::IVS
     # @!attribute [rw] type
     #   Channel type, which determines the allowable resolution and bitrate.
     #   *If you exceed the allowable input resolution or bitrate, the stream
-    #   probably will disconnect immediately.* Some types generate multiple
-    #   qualities (renditions) from the original input; this automatically
-    #   gives viewers the best experience for their devices and network
-    #   conditions. Some types provide transcoded video; transcoding allows
-    #   higher playback quality across a range of download speeds. Default:
-    #   `STANDARD`. Valid values:
-    #
-    #   * `BASIC`: Video is transmuxed: Amazon IVS delivers the original
-    #     input quality to viewers. The viewer’s video-quality choice is
-    #     limited to the original input. Input resolution can be up to 1080p
-    #     and bitrate can be up to 1.5 Mbps for 480p and up to 3.5 Mbps for
-    #     resolutions between 480p and 1080p. Original audio is passed
-    #     through.
-    #
-    #   * `STANDARD`: Video is transcoded: multiple qualities are generated
-    #     from the original input, to automatically give viewers the best
-    #     experience for their devices and network conditions. Transcoding
-    #     allows higher playback quality across a range of download speeds.
-    #     Resolution can be up to 1080p and bitrate can be up to 8.5 Mbps.
-    #     Audio is transcoded only for renditions 360p and below; above
-    #     that, audio is passed through. This is the default when you create
-    #     a channel.
-    #
-    #   * `ADVANCED_SD`: Video is transcoded; multiple qualities are
-    #     generated from the original input, to automatically give viewers
-    #     the best experience for their devices and network conditions.
-    #     Input resolution can be up to 1080p and bitrate can be up to 8.5
-    #     Mbps; output is capped at SD quality (480p). You can select an
-    #     optional transcode preset (see below). Audio for all renditions is
-    #     transcoded, and an audio-only rendition is available.
-    #
-    #   * `ADVANCED_HD`: Video is transcoded; multiple qualities are
-    #     generated from the original input, to automatically give viewers
-    #     the best experience for their devices and network conditions.
-    #     Input resolution can be up to 1080p and bitrate can be up to 8.5
-    #     Mbps; output is capped at HD quality (720p). You can select an
-    #     optional transcode preset (see below). Audio for all renditions is
-    #     transcoded, and an audio-only rendition is available.
-    #
-    #   Optional *transcode presets* (available for the `ADVANCED` types)
-    #   allow you to trade off available download bandwidth and video
-    #   quality, to optimize the viewing experience. There are two presets:
-    #
-    #   * *Constrained bandwidth delivery* uses a lower bitrate for each
-    #     quality level. Use it if you have low download bandwidth and/or
-    #     simple video content (e.g., talking heads)
-    #
-    #   * *Higher bandwidth delivery* uses a higher bitrate for each quality
-    #     level. Use it if you have high download bandwidth and/or complex
-    #     video content (e.g., flashes and quick scene changes).
+    #   probably will disconnect immediately.* Default: `STANDARD`. For
+    #   details, see [Channel Types][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/ivs/latest/LowLatencyAPIReference/channel-types.html
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-2020-07-14/UpdateChannelRequest AWS API Documentation

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.39.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.39.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-07-11 00:00:00.000000000 Z
+date: 2023-08-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core