aws-sdk-ivsrealtime 1.33.0 → 1.35.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a4d89542aa59133c405553a1a687136ccd02908d69406b5c27e7d94928caa05e
-  data.tar.gz: 404ab3cd87215d69d4c6a8917988f7ef6f448d36facf9fdf24dbbfd25a910b62
+  metadata.gz: 70b03eee69077847c6294dc13d2b39cb64a2ad4b274a1740155d214dcecd72ee
+  data.tar.gz: 42c6f405237fcfc48c4b0e6484bbb48569db7fd0be6cb235f022bc36713b2486
 SHA512:
-  metadata.gz: fc737bc0200c968cd6d68c2b8fc274e86d617271ac0effe03171118a6ade3802ec108f9468ed0cba262543f6ada806db3b04ce788d7a4d505b69aa4b0f02cf55
-  data.tar.gz: 1598d65560a3824ea51cc08b54a501ac856e191490574d90e066736af8c3c9e246e3682bcd1a6319b2637e2d48f208d9f38604312f877fb3bbe39d1687aecbeb
+  metadata.gz: e15fc67b759890d08e3a3e6124268d92e72d81f7ec023e5ba2cfd245ff9bea15a3a8c5590d1f9554328113d60f80cff9ca70fed8bf32d9db439de5c8a0d3f167
+  data.tar.gz: b6fcb65fc4f712e9d35ac07068d424d04a45ef5191c2b87b69df32a50c7ca4c081881254e7a6f964623884f4443e3cb2e3fded9c9610d8298c814db347a86315

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.35.0 (2024-12-10)
+------------------
+
+* Feature - IVS Real-Time now offers customers the ability to customize thumbnails recording mode and interval for both Individual Participant Recording (IPR) and Server-Side Compositions (SSC).
+
+1.34.0 (2024-10-18)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.33.0 (2024-10-02)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.33.0
+1.35.0

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

@@ -713,7 +713,12 @@ module Aws::IVSRealTime
     #     },
     #     auto_participant_recording_configuration: {
     #       storage_configuration_arn: "AutoParticipantRecordingStorageConfigurationArn", # required
-    #       media_types: ["AUDIO_VIDEO"], # accepts AUDIO_VIDEO, AUDIO_ONLY
+    #       media_types: ["AUDIO_VIDEO"], # accepts AUDIO_VIDEO, AUDIO_ONLY, NONE
+    #       thumbnail_configuration: {
+    #         target_interval_seconds: 1,
+    #         storage: ["SEQUENTIAL"], # accepts SEQUENTIAL, LATEST
+    #         recording_mode: "INTERVAL", # accepts INTERVAL, DISABLED
+    #       },
     #     },
     #   })
     #
@@ -726,7 +731,11 @@ module Aws::IVSRealTime
     #   resp.stage.tags["TagKey"] #=> String
     #   resp.stage.auto_participant_recording_configuration.storage_configuration_arn #=> String
     #   resp.stage.auto_participant_recording_configuration.media_types #=> Array
-    #   resp.stage.auto_participant_recording_configuration.media_types[0] #=> String, one of "AUDIO_VIDEO", "AUDIO_ONLY"
+    #   resp.stage.auto_participant_recording_configuration.media_types[0] #=> String, one of "AUDIO_VIDEO", "AUDIO_ONLY", "NONE"
+    #   resp.stage.auto_participant_recording_configuration.thumbnail_configuration.target_interval_seconds #=> Integer
+    #   resp.stage.auto_participant_recording_configuration.thumbnail_configuration.storage #=> Array
+    #   resp.stage.auto_participant_recording_configuration.thumbnail_configuration.storage[0] #=> String, one of "SEQUENTIAL", "LATEST"
+    #   resp.stage.auto_participant_recording_configuration.thumbnail_configuration.recording_mode #=> String, one of "INTERVAL", "DISABLED"
     #   resp.stage.endpoints.events #=> String
     #   resp.stage.endpoints.whip #=> String
     #   resp.stage.endpoints.rtmp #=> String
@@ -1022,6 +1031,10 @@ module Aws::IVSRealTime
     #   resp.composition.destinations[0].configuration.s3.encoder_configuration_arns #=> Array
     #   resp.composition.destinations[0].configuration.s3.encoder_configuration_arns[0] #=> String
     #   resp.composition.destinations[0].configuration.s3.recording_configuration.format #=> String, one of "HLS"
+    #   resp.composition.destinations[0].configuration.s3.thumbnail_configurations #=> Array
+    #   resp.composition.destinations[0].configuration.s3.thumbnail_configurations[0].target_interval_seconds #=> Integer
+    #   resp.composition.destinations[0].configuration.s3.thumbnail_configurations[0].storage #=> Array
+    #   resp.composition.destinations[0].configuration.s3.thumbnail_configurations[0].storage[0] #=> String, one of "SEQUENTIAL", "LATEST"
     #   resp.composition.destinations[0].detail.s3.recording_prefix #=> String
     #   resp.composition.tags #=> Hash
     #   resp.composition.tags["TagKey"] #=> String
@@ -1221,7 +1234,11 @@ module Aws::IVSRealTime
     #   resp.stage.tags["TagKey"] #=> String
     #   resp.stage.auto_participant_recording_configuration.storage_configuration_arn #=> String
     #   resp.stage.auto_participant_recording_configuration.media_types #=> Array
-    #   resp.stage.auto_participant_recording_configuration.media_types[0] #=> String, one of "AUDIO_VIDEO", "AUDIO_ONLY"
+    #   resp.stage.auto_participant_recording_configuration.media_types[0] #=> String, one of "AUDIO_VIDEO", "AUDIO_ONLY", "NONE"
+    #   resp.stage.auto_participant_recording_configuration.thumbnail_configuration.target_interval_seconds #=> Integer
+    #   resp.stage.auto_participant_recording_configuration.thumbnail_configuration.storage #=> Array
+    #   resp.stage.auto_participant_recording_configuration.thumbnail_configuration.storage[0] #=> String, one of "SEQUENTIAL", "LATEST"
+    #   resp.stage.auto_participant_recording_configuration.thumbnail_configuration.recording_mode #=> String, one of "INTERVAL", "DISABLED"
     #   resp.stage.endpoints.events #=> String
     #   resp.stage.endpoints.whip #=> String
     #   resp.stage.endpoints.rtmp #=> String
@@ -1939,6 +1956,12 @@ module Aws::IVSRealTime
     #           recording_configuration: {
     #             format: "HLS", # accepts HLS
     #           },
+    #           thumbnail_configurations: [
+    #             {
+    #               target_interval_seconds: 1,
+    #               storage: ["SEQUENTIAL"], # accepts SEQUENTIAL, LATEST
+    #             },
+    #           ],
     #         },
     #       },
     #     ],
@@ -1979,6 +2002,10 @@ module Aws::IVSRealTime
     #   resp.composition.destinations[0].configuration.s3.encoder_configuration_arns #=> Array
     #   resp.composition.destinations[0].configuration.s3.encoder_configuration_arns[0] #=> String
     #   resp.composition.destinations[0].configuration.s3.recording_configuration.format #=> String, one of "HLS"
+    #   resp.composition.destinations[0].configuration.s3.thumbnail_configurations #=> Array
+    #   resp.composition.destinations[0].configuration.s3.thumbnail_configurations[0].target_interval_seconds #=> Integer
+    #   resp.composition.destinations[0].configuration.s3.thumbnail_configurations[0].storage #=> Array
+    #   resp.composition.destinations[0].configuration.s3.thumbnail_configurations[0].storage[0] #=> String, one of "SEQUENTIAL", "LATEST"
     #   resp.composition.destinations[0].detail.s3.recording_prefix #=> String
     #   resp.composition.tags #=> Hash
     #   resp.composition.tags["TagKey"] #=> String
@@ -2159,7 +2186,12 @@ module Aws::IVSRealTime
     #     name: "StageName",
     #     auto_participant_recording_configuration: {
     #       storage_configuration_arn: "AutoParticipantRecordingStorageConfigurationArn", # required
-    #       media_types: ["AUDIO_VIDEO"], # accepts AUDIO_VIDEO, AUDIO_ONLY
+    #       media_types: ["AUDIO_VIDEO"], # accepts AUDIO_VIDEO, AUDIO_ONLY, NONE
+    #       thumbnail_configuration: {
+    #         target_interval_seconds: 1,
+    #         storage: ["SEQUENTIAL"], # accepts SEQUENTIAL, LATEST
+    #         recording_mode: "INTERVAL", # accepts INTERVAL, DISABLED
+    #       },
     #     },
     #   })
     #
@@ -2172,7 +2204,11 @@ module Aws::IVSRealTime
     #   resp.stage.tags["TagKey"] #=> String
     #   resp.stage.auto_participant_recording_configuration.storage_configuration_arn #=> String
     #   resp.stage.auto_participant_recording_configuration.media_types #=> Array
-    #   resp.stage.auto_participant_recording_configuration.media_types[0] #=> String, one of "AUDIO_VIDEO", "AUDIO_ONLY"
+    #   resp.stage.auto_participant_recording_configuration.media_types[0] #=> String, one of "AUDIO_VIDEO", "AUDIO_ONLY", "NONE"
+    #   resp.stage.auto_participant_recording_configuration.thumbnail_configuration.target_interval_seconds #=> Integer
+    #   resp.stage.auto_participant_recording_configuration.thumbnail_configuration.storage #=> Array
+    #   resp.stage.auto_participant_recording_configuration.thumbnail_configuration.storage[0] #=> String, one of "SEQUENTIAL", "LATEST"
+    #   resp.stage.auto_participant_recording_configuration.thumbnail_configuration.recording_mode #=> String, one of "INTERVAL", "DISABLED"
     #   resp.stage.endpoints.events #=> String
     #   resp.stage.endpoints.whip #=> String
     #   resp.stage.endpoints.rtmp #=> String
@@ -2205,7 +2241,7 @@ module Aws::IVSRealTime
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-ivsrealtime'
-      context[:gem_version] = '1.33.0'
+      context[:gem_version] = '1.35.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -28,6 +28,8 @@ module Aws::IVSRealTime
     CompositionState = Shapes::StringShape.new(name: 'CompositionState')
     CompositionSummary = Shapes::StructureShape.new(name: 'CompositionSummary')
     CompositionSummaryList = Shapes::ListShape.new(name: 'CompositionSummaryList')
+    CompositionThumbnailConfiguration = Shapes::StructureShape.new(name: 'CompositionThumbnailConfiguration')
+    CompositionThumbnailConfigurationList = Shapes::ListShape.new(name: 'CompositionThumbnailConfigurationList')
     ConflictException = Shapes::StructureShape.new(name: 'ConflictException')
     CreateEncoderConfigurationRequest = Shapes::StructureShape.new(name: 'CreateEncoderConfigurationRequest')
     CreateEncoderConfigurationResponse = Shapes::StructureShape.new(name: 'CreateEncoderConfigurationResponse')
@@ -149,6 +151,7 @@ module Aws::IVSRealTime
     ParticipantRecordingState = Shapes::StringShape.new(name: 'ParticipantRecordingState')
     ParticipantState = Shapes::StringShape.new(name: 'ParticipantState')
     ParticipantSummary = Shapes::StructureShape.new(name: 'ParticipantSummary')
+    ParticipantThumbnailConfiguration = Shapes::StructureShape.new(name: 'ParticipantThumbnailConfiguration')
     ParticipantToken = Shapes::StructureShape.new(name: 'ParticipantToken')
     ParticipantTokenAttributes = Shapes::MapShape.new(name: 'ParticipantTokenAttributes')
     ParticipantTokenCapabilities = Shapes::ListShape.new(name: 'ParticipantTokenCapabilities')
@@ -213,6 +216,10 @@ module Aws::IVSRealTime
     TagResourceResponse = Shapes::StructureShape.new(name: 'TagResourceResponse')
     TagValue = Shapes::StringShape.new(name: 'TagValue')
     Tags = Shapes::MapShape.new(name: 'Tags')
+    ThumbnailIntervalSeconds = Shapes::IntegerShape.new(name: 'ThumbnailIntervalSeconds')
+    ThumbnailRecordingMode = Shapes::StringShape.new(name: 'ThumbnailRecordingMode')
+    ThumbnailStorageType = Shapes::StringShape.new(name: 'ThumbnailStorageType')
+    ThumbnailStorageTypeList = Shapes::ListShape.new(name: 'ThumbnailStorageTypeList')
     Time = Shapes::TimestampShape.new(name: 'Time', timestampFormat: "iso8601")
     UntagResourceRequest = Shapes::StructureShape.new(name: 'UntagResourceRequest')
     UntagResourceResponse = Shapes::StructureShape.new(name: 'UntagResourceResponse')
@@ -233,6 +240,7 @@ module Aws::IVSRealTime
 
     AutoParticipantRecordingConfiguration.add_member(:storage_configuration_arn, Shapes::ShapeRef.new(shape: AutoParticipantRecordingStorageConfigurationArn, required: true, location_name: "storageConfigurationArn"))
     AutoParticipantRecordingConfiguration.add_member(:media_types, Shapes::ShapeRef.new(shape: ParticipantRecordingMediaTypeList, location_name: "mediaTypes"))
+    AutoParticipantRecordingConfiguration.add_member(:thumbnail_configuration, Shapes::ShapeRef.new(shape: ParticipantThumbnailConfiguration, location_name: "thumbnailConfiguration"))
     AutoParticipantRecordingConfiguration.struct_class = Types::AutoParticipantRecordingConfiguration
 
     ChannelDestinationConfiguration.add_member(:channel_arn, Shapes::ShapeRef.new(shape: ChannelArn, required: true, location_name: "channelArn"))
@@ -260,6 +268,12 @@ module Aws::IVSRealTime
 
     CompositionSummaryList.member = Shapes::ShapeRef.new(shape: CompositionSummary)
 
+    CompositionThumbnailConfiguration.add_member(:target_interval_seconds, Shapes::ShapeRef.new(shape: ThumbnailIntervalSeconds, location_name: "targetIntervalSeconds"))
+    CompositionThumbnailConfiguration.add_member(:storage, Shapes::ShapeRef.new(shape: ThumbnailStorageTypeList, location_name: "storage"))
+    CompositionThumbnailConfiguration.struct_class = Types::CompositionThumbnailConfiguration
+
+    CompositionThumbnailConfigurationList.member = Shapes::ShapeRef.new(shape: CompositionThumbnailConfiguration)
+
     ConflictException.add_member(:exception_message, Shapes::ShapeRef.new(shape: errorMessage, location_name: "exceptionMessage"))
     ConflictException.struct_class = Types::ConflictException
 
@@ -617,6 +631,11 @@ module Aws::IVSRealTime
     ParticipantSummary.add_member(:recording_state, Shapes::ShapeRef.new(shape: ParticipantRecordingState, location_name: "recordingState"))
     ParticipantSummary.struct_class = Types::ParticipantSummary
 
+    ParticipantThumbnailConfiguration.add_member(:target_interval_seconds, Shapes::ShapeRef.new(shape: ThumbnailIntervalSeconds, location_name: "targetIntervalSeconds"))
+    ParticipantThumbnailConfiguration.add_member(:storage, Shapes::ShapeRef.new(shape: ThumbnailStorageTypeList, location_name: "storage"))
+    ParticipantThumbnailConfiguration.add_member(:recording_mode, Shapes::ShapeRef.new(shape: ThumbnailRecordingMode, location_name: "recordingMode"))
+    ParticipantThumbnailConfiguration.struct_class = Types::ParticipantThumbnailConfiguration
+
     ParticipantToken.add_member(:participant_id, Shapes::ShapeRef.new(shape: ParticipantTokenId, location_name: "participantId"))
     ParticipantToken.add_member(:token, Shapes::ShapeRef.new(shape: ParticipantTokenString, location_name: "token"))
     ParticipantToken.add_member(:user_id, Shapes::ShapeRef.new(shape: ParticipantTokenUserId, location_name: "userId"))
@@ -679,6 +698,7 @@ module Aws::IVSRealTime
     S3DestinationConfiguration.add_member(:storage_configuration_arn, Shapes::ShapeRef.new(shape: StorageConfigurationArn, required: true, location_name: "storageConfigurationArn"))
     S3DestinationConfiguration.add_member(:encoder_configuration_arns, Shapes::ShapeRef.new(shape: EncoderConfigurationArnList, required: true, location_name: "encoderConfigurationArns"))
     S3DestinationConfiguration.add_member(:recording_configuration, Shapes::ShapeRef.new(shape: RecordingConfiguration, location_name: "recordingConfiguration"))
+    S3DestinationConfiguration.add_member(:thumbnail_configurations, Shapes::ShapeRef.new(shape: CompositionThumbnailConfigurationList, location_name: "thumbnailConfigurations"))
     S3DestinationConfiguration.struct_class = Types::S3DestinationConfiguration
 
     S3Detail.add_member(:recording_prefix, Shapes::ShapeRef.new(shape: String, required: true, location_name: "recordingPrefix"))
@@ -764,6 +784,8 @@ module Aws::IVSRealTime
     Tags.key = Shapes::ShapeRef.new(shape: TagKey)
     Tags.value = Shapes::ShapeRef.new(shape: TagValue)
 
+    ThumbnailStorageTypeList.member = Shapes::ShapeRef.new(shape: ThumbnailStorageType)
+
     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
@@ -802,9 +824,10 @@ module Aws::IVSRealTime
 
       api.metadata = {
         "apiVersion" => "2020-07-14",
+        "auth" => ["aws.auth#sigv4"],
         "endpointPrefix" => "ivsrealtime",
-        "jsonVersion" => "1.1",
         "protocol" => "rest-json",
+        "protocols" => ["rest-json"],
         "serviceAbbreviation" => "ivsrealtime",
         "serviceFullName" => "Amazon Interactive Video Service RealTime",
         "serviceId" => "IVS RealTime",

data/lib/aws-sdk-ivsrealtime/endpoint_parameters.rb

@@ -52,15 +52,18 @@ module Aws::IVSRealTime
       self[:region] = options[:region]
       self[:use_dual_stack] = options[:use_dual_stack]
       self[:use_dual_stack] = false if self[:use_dual_stack].nil?
-      if self[:use_dual_stack].nil?
-        raise ArgumentError, "Missing required EndpointParameter: :use_dual_stack"
-      end
       self[:use_fips] = options[:use_fips]
       self[:use_fips] = false if self[:use_fips].nil?
-      if self[:use_fips].nil?
-        raise ArgumentError, "Missing required EndpointParameter: :use_fips"
-      end
       self[:endpoint] = options[:endpoint]
     end
+
+    def self.create(config, options={})
+      new({
+        region: config.region,
+        use_dual_stack: config.use_dualstack_endpoint,
+        use_fips: config.use_fips_endpoint,
+        endpoint: (config.endpoint.to_s unless config.regional_endpoint),
+      }.merge(options))
+    end
   end
 end

data/lib/aws-sdk-ivsrealtime/endpoints.rb

@@ -12,401 +12,9 @@ module Aws::IVSRealTime
   # @api private
   module Endpoints
 
-    class CreateEncoderConfiguration
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class CreateIngestConfiguration
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class CreateParticipantToken
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class CreateStage
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class CreateStorageConfiguration
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class DeleteEncoderConfiguration
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class DeleteIngestConfiguration
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class DeletePublicKey
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class DeleteStage
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class DeleteStorageConfiguration
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class DisconnectParticipant
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class GetComposition
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class GetEncoderConfiguration
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class GetIngestConfiguration
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class GetParticipant
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class GetPublicKey
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class GetStage
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class GetStageSession
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
 
-    class GetStorageConfiguration
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
+    def self.parameters_for_operation(context)
+      Aws::IVSRealTime::EndpointParameters.create(context.config)
     end
-
-    class ImportPublicKey
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class ListCompositions
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class ListEncoderConfigurations
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class ListIngestConfigurations
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class ListParticipantEvents
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class ListParticipants
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class ListPublicKeys
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class ListStageSessions
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class ListStages
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class ListStorageConfigurations
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class ListTagsForResource
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class StartComposition
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class StopComposition
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class TagResource
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class UntagResource
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class UpdateIngestConfiguration
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
-    class UpdateStage
-      def self.build(context)
-        Aws::IVSRealTime::EndpointParameters.new(
-          region: context.config.region,
-          use_dual_stack: context.config.use_dualstack_endpoint,
-          use_fips: context.config.use_fips_endpoint,
-          endpoint: context.config.regional_endpoint ? nil : context.config.endpoint.to_s,
-        )
-      end
-    end
-
   end
 end

data/lib/aws-sdk-ivsrealtime/plugins/endpoints.rb

@@ -27,7 +27,7 @@ The endpoint provider used to resolve endpoints. Any object that responds to
       class Handler < Seahorse::Client::Handler
         def call(context)
           unless context[:discovered_endpoint]
-            params = parameters_for_operation(context)
+            params = Aws::IVSRealTime::Endpoints.parameters_for_operation(context)
             endpoint = context.config.endpoint_provider.resolve_endpoint(params)
 
             context.http_request.endpoint = endpoint.url
@@ -67,83 +67,6 @@ The endpoint provider used to resolve endpoints. Any object that responds to
             context.http_request.headers[key] = value
           end
         end
-
-        def parameters_for_operation(context)
-          case context.operation_name
-          when :create_encoder_configuration
-            Aws::IVSRealTime::Endpoints::CreateEncoderConfiguration.build(context)
-          when :create_ingest_configuration
-            Aws::IVSRealTime::Endpoints::CreateIngestConfiguration.build(context)
-          when :create_participant_token
-            Aws::IVSRealTime::Endpoints::CreateParticipantToken.build(context)
-          when :create_stage
-            Aws::IVSRealTime::Endpoints::CreateStage.build(context)
-          when :create_storage_configuration
-            Aws::IVSRealTime::Endpoints::CreateStorageConfiguration.build(context)
-          when :delete_encoder_configuration
-            Aws::IVSRealTime::Endpoints::DeleteEncoderConfiguration.build(context)
-          when :delete_ingest_configuration
-            Aws::IVSRealTime::Endpoints::DeleteIngestConfiguration.build(context)
-          when :delete_public_key
-            Aws::IVSRealTime::Endpoints::DeletePublicKey.build(context)
-          when :delete_stage
-            Aws::IVSRealTime::Endpoints::DeleteStage.build(context)
-          when :delete_storage_configuration
-            Aws::IVSRealTime::Endpoints::DeleteStorageConfiguration.build(context)
-          when :disconnect_participant
-            Aws::IVSRealTime::Endpoints::DisconnectParticipant.build(context)
-          when :get_composition
-            Aws::IVSRealTime::Endpoints::GetComposition.build(context)
-          when :get_encoder_configuration
-            Aws::IVSRealTime::Endpoints::GetEncoderConfiguration.build(context)
-          when :get_ingest_configuration
-            Aws::IVSRealTime::Endpoints::GetIngestConfiguration.build(context)
-          when :get_participant
-            Aws::IVSRealTime::Endpoints::GetParticipant.build(context)
-          when :get_public_key
-            Aws::IVSRealTime::Endpoints::GetPublicKey.build(context)
-          when :get_stage
-            Aws::IVSRealTime::Endpoints::GetStage.build(context)
-          when :get_stage_session
-            Aws::IVSRealTime::Endpoints::GetStageSession.build(context)
-          when :get_storage_configuration
-            Aws::IVSRealTime::Endpoints::GetStorageConfiguration.build(context)
-          when :import_public_key
-            Aws::IVSRealTime::Endpoints::ImportPublicKey.build(context)
-          when :list_compositions
-            Aws::IVSRealTime::Endpoints::ListCompositions.build(context)
-          when :list_encoder_configurations
-            Aws::IVSRealTime::Endpoints::ListEncoderConfigurations.build(context)
-          when :list_ingest_configurations
-            Aws::IVSRealTime::Endpoints::ListIngestConfigurations.build(context)
-          when :list_participant_events
-            Aws::IVSRealTime::Endpoints::ListParticipantEvents.build(context)
-          when :list_participants
-            Aws::IVSRealTime::Endpoints::ListParticipants.build(context)
-          when :list_public_keys
-            Aws::IVSRealTime::Endpoints::ListPublicKeys.build(context)
-          when :list_stage_sessions
-            Aws::IVSRealTime::Endpoints::ListStageSessions.build(context)
-          when :list_stages
-            Aws::IVSRealTime::Endpoints::ListStages.build(context)
-          when :list_storage_configurations
-            Aws::IVSRealTime::Endpoints::ListStorageConfigurations.build(context)
-          when :list_tags_for_resource
-            Aws::IVSRealTime::Endpoints::ListTagsForResource.build(context)
-          when :start_composition
-            Aws::IVSRealTime::Endpoints::StartComposition.build(context)
-          when :stop_composition
-            Aws::IVSRealTime::Endpoints::StopComposition.build(context)
-          when :tag_resource
-            Aws::IVSRealTime::Endpoints::TagResource.build(context)
-          when :untag_resource
-            Aws::IVSRealTime::Endpoints::UntagResource.build(context)
-          when :update_ingest_configuration
-            Aws::IVSRealTime::Endpoints::UpdateIngestConfiguration.build(context)
-          when :update_stage
-            Aws::IVSRealTime::Endpoints::UpdateStage.build(context)
-          end
-        end
       end
 
       def add_handlers(handlers, _config)

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

@@ -37,11 +37,18 @@ module Aws::IVSRealTime
     #   Types of media to be recorded. Default: `AUDIO_VIDEO`.
     #   @return [Array<String>]
     #
+    # @!attribute [rw] thumbnail_configuration
+    #   A complex type that allows you to enable/disable the recording of
+    #   thumbnails for individual participant recording and modify the
+    #   interval at which thumbnails are generated for the live session.
+    #   @return [Types::ParticipantThumbnailConfiguration]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/AutoParticipantRecordingConfiguration AWS API Documentation
     #
     class AutoParticipantRecordingConfiguration < Struct.new(
       :storage_configuration_arn,
-      :media_types)
+      :media_types,
+      :thumbnail_configuration)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -184,6 +191,33 @@ module Aws::IVSRealTime
       include Aws::Structure
     end
 
+    # An object representing a configuration of thumbnails for recorded
+    # video for a Composition.
+    #
+    # @!attribute [rw] target_interval_seconds
+    #   The targeted thumbnail-generation interval in seconds. Default: 60.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] storage
+    #   Indicates the format in which thumbnails are recorded. `SEQUENTIAL`
+    #   records all generated thumbnails in a serial manner, to the
+    #   media/thumbnails/(width)x(height) directory, where (width) and
+    #   (height) are the width and height of the thumbnail. `LATEST` saves
+    #   the latest thumbnail in
+    #   media/latest\_thumbnail/(width)x(height)/thumb.jpg and overwrites it
+    #   at the interval specified by `targetIntervalSeconds`. You can enable
+    #   both `SEQUENTIAL` and `LATEST`. Default: `SEQUENTIAL`.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/CompositionThumbnailConfiguration AWS API Documentation
+    #
+    class CompositionThumbnailConfiguration < Struct.new(
+      :target_interval_seconds,
+      :storage)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] exception_message
     #   Updating or deleting a resource can cause an inconsistent state.
     #   @return [String]
@@ -1913,6 +1947,37 @@ module Aws::IVSRealTime
       include Aws::Structure
     end
 
+    # An object representing a configuration of thumbnails for recorded
+    # video from an individual participant.
+    #
+    # @!attribute [rw] target_interval_seconds
+    #   The targeted thumbnail-generation interval in seconds. This is
+    #   configurable only if `recordingMode` is `INTERVAL`. Default: 60.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] storage
+    #   Indicates the format in which thumbnails are recorded. `SEQUENTIAL`
+    #   records all generated thumbnails in a serial manner, to the
+    #   media/thumbnails/high directory. `LATEST` saves the latest thumbnail
+    #   in media/latest\_thumbnail/high/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] recording_mode
+    #   Thumbnail recording mode. Default: `DISABLED`.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/ParticipantThumbnailConfiguration AWS API Documentation
+    #
+    class ParticipantThumbnailConfiguration < Struct.new(
+      :target_interval_seconds,
+      :storage,
+      :recording_mode)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Object specifying a participant token in a stage.
     #
     # **Important**: Treat tokens as opaque; i.e., do not build
@@ -2227,12 +2292,19 @@ module Aws::IVSRealTime
     #   the recording format for storing a recording in Amazon S3.
     #   @return [Types::RecordingConfiguration]
     #
+    # @!attribute [rw] thumbnail_configurations
+    #   A complex type that allows you to enable/disable the recording of
+    #   thumbnails for a Composition and modify the interval at which
+    #   thumbnails are generated for the live session.
+    #   @return [Array<Types::CompositionThumbnailConfiguration>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/S3DestinationConfiguration AWS API Documentation
     #
     class S3DestinationConfiguration < Struct.new(
       :storage_configuration_arn,
       :encoder_configuration_arns,
-      :recording_configuration)
+      :recording_configuration,
+      :thumbnail_configurations)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-ivsrealtime.rb

@@ -55,7 +55,7 @@ module Aws::IVSRealTime
   autoload :EndpointProvider, 'aws-sdk-ivsrealtime/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-ivsrealtime/endpoints'
 
-  GEM_VERSION = '1.33.0'
+  GEM_VERSION = '1.35.0'
 
 end
 

data/sig/client.rbs

@@ -141,7 +141,12 @@ module Aws
                           ?tags: Hash[::String, ::String],
                           ?auto_participant_recording_configuration: {
                             storage_configuration_arn: ::String,
-                            media_types: Array[("AUDIO_VIDEO" | "AUDIO_ONLY")]?
+                            media_types: Array[("AUDIO_VIDEO" | "AUDIO_ONLY" | "NONE")]?,
+                            thumbnail_configuration: {
+                              target_interval_seconds: ::Integer?,
+                              storage: Array[("SEQUENTIAL" | "LATEST")]?,
+                              recording_mode: ("INTERVAL" | "DISABLED")?
+                            }?
                           }
                         ) -> _CreateStageResponseSuccess
                       | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateStageResponseSuccess
@@ -485,7 +490,13 @@ module Aws
                                      encoder_configuration_arns: Array[::String],
                                      recording_configuration: {
                                        format: ("HLS")?
-                                     }?
+                                     }?,
+                                     thumbnail_configurations: Array[
+                                       {
+                                         target_interval_seconds: ::Integer?,
+                                         storage: Array[("SEQUENTIAL" | "LATEST")]?
+                                       },
+                                     ]?
                                    }?
                                  },
                                ],
@@ -543,7 +554,12 @@ module Aws
                           ?name: ::String,
                           ?auto_participant_recording_configuration: {
                             storage_configuration_arn: ::String,
-                            media_types: Array[("AUDIO_VIDEO" | "AUDIO_ONLY")]?
+                            media_types: Array[("AUDIO_VIDEO" | "AUDIO_ONLY" | "NONE")]?,
+                            thumbnail_configuration: {
+                              target_interval_seconds: ::Integer?,
+                              storage: Array[("SEQUENTIAL" | "LATEST")]?,
+                              recording_mode: ("INTERVAL" | "DISABLED")?
+                            }?
                           }
                         ) -> _UpdateStageResponseSuccess
                       | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdateStageResponseSuccess

data/sig/types.rbs

@@ -15,7 +15,8 @@ module Aws::IVSRealTime
 
     class AutoParticipantRecordingConfiguration
       attr_accessor storage_configuration_arn: ::String
-      attr_accessor media_types: ::Array[("AUDIO_VIDEO" | "AUDIO_ONLY")]
+      attr_accessor media_types: ::Array[("AUDIO_VIDEO" | "AUDIO_ONLY" | "NONE")]
+      attr_accessor thumbnail_configuration: Types::ParticipantThumbnailConfiguration
       SENSITIVE: []
     end
 
@@ -48,6 +49,12 @@ module Aws::IVSRealTime
       SENSITIVE: []
     end
 
+    class CompositionThumbnailConfiguration
+      attr_accessor target_interval_seconds: ::Integer
+      attr_accessor storage: ::Array[("SEQUENTIAL" | "LATEST")]
+      SENSITIVE: []
+    end
+
     class ConflictException
       attr_accessor exception_message: ::String
       SENSITIVE: []
@@ -528,6 +535,13 @@ module Aws::IVSRealTime
       SENSITIVE: []
     end
 
+    class ParticipantThumbnailConfiguration
+      attr_accessor target_interval_seconds: ::Integer
+      attr_accessor storage: ::Array[("SEQUENTIAL" | "LATEST")]
+      attr_accessor recording_mode: ("INTERVAL" | "DISABLED")
+      SENSITIVE: []
+    end
+
     class ParticipantToken
       attr_accessor participant_id: ::String
       attr_accessor token: ::String
@@ -596,6 +610,7 @@ module Aws::IVSRealTime
       attr_accessor storage_configuration_arn: ::String
       attr_accessor encoder_configuration_arns: ::Array[::String]
       attr_accessor recording_configuration: Types::RecordingConfiguration
+      attr_accessor thumbnail_configurations: ::Array[Types::CompositionThumbnailConfiguration]
       SENSITIVE: []
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ivsrealtime
 version: !ruby/object:Gem::Version
-  version: 1.33.0
+  version: 1.35.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-10-02 00:00:00.000000000 Z
+date: 2024-12-10 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.207.0
+        version: 3.210.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,21 +29,21 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.207.0
+        version: 3.210.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '1.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '1.5'
 description: Official AWS Ruby gem for Amazon Interactive Video Service RealTime (ivsrealtime).
   This gem is part of the AWS SDK for Ruby.
 email: