aws-sdk-connect 1.180.0 → 1.182.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 35565199a59553371b2dd1e9455ae782c3d50bb69f1829c37eae4b878964bfb7
-  data.tar.gz: 4d875aea519d0a4a639c45acb194359a8dc5d1cf3c3e94705b67cabb6407fc99
+  metadata.gz: fb6141053141ca363f7f83b820bc2b22777efc75c29cbd0a90b2b6ac97c03200
+  data.tar.gz: bcdb219e1a50e9e965dd02ca24656678ad27280eefcadcf83e4e5d06bee4b65a
 SHA512:
-  metadata.gz: 1b54c4fba0599a52bdef97ab3b31759b83b61e1ca852edd6469724a917ad155a4d06eac846a7bbf5d0afa020644d65b307bbb0937880de9cd8686ce8c9cea679
-  data.tar.gz: 2dbb5b16ce0ac888eeca7fea3efb193d5c324879021b307efaf546006df8b4ff3695633889f50fdfe3bc8c9f224fd56ba979472a12ea84e6254ebc765a2c978c
+  metadata.gz: 603cf8150003484e38156522e8c63c34530479455d0ccf0eeaabf50122d56817fe43f0a66474fa1ed45ca70d19f9d27b5320c53ba396952ea00b876f47bc96a1
+  data.tar.gz: 54f58aa3caa47147f1883b21be1651642b23e876a69a77df7bc6dd64b00e2b8be125956991f866958bf720589a7495ad7b4cf8958f94dd1ec5e41d72ad5da75b

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.182.0 (2024-10-23)
+------------------
+
+* Feature - Amazon Connect Service Feature: Add support to start screen sharing for a web calling contact.
+
+1.181.0 (2024-10-18)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.180.0 (2024-10-03)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.180.0
+1.182.0

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

@@ -1050,13 +1050,13 @@ module Aws::Connect
       req.send_request(options)
     end
 
-    # Associates an agent with a traffic distribution group.
+    # Associates an agent with a traffic distribution group. This API can be
+    # called only in the Region where the traffic distribution group is
+    # created.
     #
     # @option params [required, String] :traffic_distribution_group_id
     #   The identifier of the traffic distribution group. This can be the ID
-    #   or the ARN if the API is being called in the Region where the traffic
-    #   distribution group was created. The ARN must be provided if the call
-    #   is from the replicated Region.
+    #   or the ARN of the traffic distribution group.
     #
     # @option params [required, String] :user_id
     #   The identifier of the user account. This can be the ID or the ARN of
@@ -4270,9 +4270,7 @@ module Aws::Connect
     #
     # @option params [required, String] :traffic_distribution_group_id
     #   The identifier of the traffic distribution group. This can be the ID
-    #   or the ARN if the API is being called in the Region where the traffic
-    #   distribution group was created. The ARN must be provided if the call
-    #   is from the replicated Region.
+    #   or the ARN of the traffic distribution group.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -4671,6 +4669,7 @@ module Aws::Connect
     #   resp.contact.agent_info.device_info.platform_version #=> String
     #   resp.contact.agent_info.device_info.operating_system #=> String
     #   resp.contact.agent_info.capabilities.video #=> String, one of "SEND"
+    #   resp.contact.agent_info.capabilities.screen_share #=> String, one of "SEND"
     #   resp.contact.initiation_timestamp #=> Time
     #   resp.contact.disconnect_timestamp #=> Time
     #   resp.contact.last_update_timestamp #=> Time
@@ -4706,6 +4705,7 @@ module Aws::Connect
     #   resp.contact.customer.device_info.platform_version #=> String
     #   resp.contact.customer.device_info.operating_system #=> String
     #   resp.contact.customer.capabilities.video #=> String, one of "SEND"
+    #   resp.contact.customer.capabilities.screen_share #=> String, one of "SEND"
     #   resp.contact.campaign.campaign_id #=> String
     #   resp.contact.answering_machine_detection_status #=> String, one of "ANSWERED", "UNDETECTED", "ERROR", "HUMAN_ANSWERED", "SIT_TONE_DETECTED", "SIT_TONE_BUSY", "SIT_TONE_INVALID_NUMBER", "FAX_MACHINE_DETECTED", "VOICEMAIL_BEEP", "VOICEMAIL_NO_BEEP", "AMD_UNRESOLVED", "AMD_UNANSWERED", "AMD_ERROR", "AMD_NOT_APPLICABLE"
     #   resp.contact.customer_voice_activity.greeting_start_timestamp #=> Time
@@ -6441,13 +6441,13 @@ module Aws::Connect
       req.send_request(options)
     end
 
-    # Disassociates an agent from a traffic distribution group.
+    # Disassociates an agent from a traffic distribution group. This API can
+    # be called only in the Region where the traffic distribution group is
+    # created.
     #
     # @option params [required, String] :traffic_distribution_group_id
     #   The identifier of the traffic distribution group. This can be the ID
-    #   or the ARN if the API is being called in the Region where the traffic
-    #   distribution group was created. The ARN must be provided if the call
-    #   is from the replicated Region.
+    #   or the ARN of the traffic distribution group.
     #
     # @option params [required, String] :user_id
     #   The identifier for the user. This can be the ID or the ARN of the
@@ -7470,7 +7470,7 @@ module Aws::Connect
     # a metric level, and offers the ability to filter and group data by
     # channels, queues, routing profiles, agents, and agent hierarchy
     # levels. It can retrieve historical data for the last 3 months, at
-    # varying intervals.
+    # varying intervals. It does not support agent queues.
     #
     # For a description of the historical metrics that are supported by
     # `GetMetricDataV2` and `GetMetricData`, see [Historical metrics
@@ -7784,7 +7784,7 @@ module Aws::Connect
     #
     #     UI name: [Average agent API connecting time][15]
     #
-    #     <note markdown="1"> The `Negate` key in Metric Level Filters is not applicable for this
+    #     <note markdown="1"> The `Negate` key in metric-level filters is not applicable for this
     #     metric.
     #
     #      </note>
@@ -8242,7 +8242,7 @@ module Aws::Connect
     #     Valid groupings and filters: Queue, Channel, Routing Profile,
     #     contact/segmentAttributes/connect:Subtype, Q in Connect
     #
-    #     Threshold: For `ThresholdValue` enter any whole number from 1 to
+    #     Threshold: For `ThresholdValue`, enter any whole number from 1 to
     #     604800 (inclusive), in seconds. For `Comparison`, you can use `LT`
     #     (for "Less than") or `LTE` (for "Less than equal").
     #
@@ -8561,7 +8561,7 @@ module Aws::Connect
     #
     #     UI name: [Agent API connecting time][74]
     #
-    #     <note markdown="1"> The `Negate` key in Metric Level Filters is not applicable for this
+    #     <note markdown="1"> The `Negate` key in metric-level filters is not applicable for this
     #     metric.
     #
     #      </note>
@@ -14951,6 +14951,57 @@ module Aws::Connect
       req.send_request(options)
     end
 
+    # Starts screen sharing for a contact. For more information about screen
+    # sharing, see [Set up in-app, web, video calling, and screen sharing
+    # capabilities][1] in the *Amazon Connect Administrator Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/inapp-calling.html
+    #
+    # @option params [String] :client_token
+    #   A unique, case-sensitive identifier that you provide to ensure the
+    #   idempotency of the request. If not provided, the Amazon Web Services
+    #   SDK populates this field. For more information about idempotency, see
+    #   [Making retries safe with idempotent APIs][1].
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.**
+    #
+    #
+    #
+    #   [1]: https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/
+    #
+    # @option params [required, String] :instance_id
+    #   The identifier of the Amazon Connect instance. You can [find the
+    #   instance ID][1] in the Amazon Resource Name (ARN) of the instance.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html
+    #
+    # @option params [required, String] :contact_id
+    #   The identifier of the contact in this instance of Amazon Connect.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.start_screen_sharing({
+    #     client_token: "ClientToken",
+    #     instance_id: "InstanceId", # required
+    #     contact_id: "ContactId", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/StartScreenSharing AWS API Documentation
+    #
+    # @overload start_screen_sharing(params = {})
+    # @param [Hash] params ({})
+    def start_screen_sharing(params = {}, options = {})
+      req = build_request(:start_screen_sharing, params)
+      req.send_request(options)
+    end
+
     # Initiates a flow to start a new task contact. For more information
     # about task contacts, see [Concepts: Tasks in Amazon Connect][1] in the
     # *Amazon Connect Administrator Guide*.
@@ -15223,9 +15274,11 @@ module Aws::Connect
     #     allowed_capabilities: {
     #       customer: {
     #         video: "SEND", # accepts SEND
+    #         screen_share: "SEND", # accepts SEND
     #       },
     #       agent: {
     #         video: "SEND", # accepts SEND
+    #         screen_share: "SEND", # accepts SEND
     #       },
     #     },
     #     participant_details: { # required
@@ -18472,7 +18525,7 @@ module Aws::Connect
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-connect'
-      context[:gem_version] = '1.180.0'
+      context[:gem_version] = '1.182.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -1018,6 +1018,7 @@ module Aws::Connect
     RuleTriggerEventSource = Shapes::StructureShape.new(name: 'RuleTriggerEventSource')
     S3Config = Shapes::StructureShape.new(name: 'S3Config')
     S3Uri = Shapes::StringShape.new(name: 'S3Uri')
+    ScreenShareCapability = Shapes::StringShape.new(name: 'ScreenShareCapability')
     SearchAgentStatusesRequest = Shapes::StructureShape.new(name: 'SearchAgentStatusesRequest')
     SearchAgentStatusesResponse = Shapes::StructureShape.new(name: 'SearchAgentStatusesResponse')
     SearchAvailablePhoneNumbersRequest = Shapes::StructureShape.new(name: 'SearchAvailablePhoneNumbersRequest')
@@ -1117,6 +1118,8 @@ module Aws::Connect
     StartOutboundChatContactResponse = Shapes::StructureShape.new(name: 'StartOutboundChatContactResponse')
     StartOutboundVoiceContactRequest = Shapes::StructureShape.new(name: 'StartOutboundVoiceContactRequest')
     StartOutboundVoiceContactResponse = Shapes::StructureShape.new(name: 'StartOutboundVoiceContactResponse')
+    StartScreenSharingRequest = Shapes::StructureShape.new(name: 'StartScreenSharingRequest')
+    StartScreenSharingResponse = Shapes::StructureShape.new(name: 'StartScreenSharingResponse')
     StartTaskContactRequest = Shapes::StructureShape.new(name: 'StartTaskContactRequest')
     StartTaskContactResponse = Shapes::StructureShape.new(name: 'StartTaskContactResponse')
     StartWebRTCContactRequest = Shapes::StructureShape.new(name: 'StartWebRTCContactRequest')
@@ -4011,6 +4014,7 @@ module Aws::Connect
     OutputTypeNotFoundException.struct_class = Types::OutputTypeNotFoundException
 
     ParticipantCapabilities.add_member(:video, Shapes::ShapeRef.new(shape: VideoCapability, location_name: "Video"))
+    ParticipantCapabilities.add_member(:screen_share, Shapes::ShapeRef.new(shape: ScreenShareCapability, location_name: "ScreenShare"))
     ParticipantCapabilities.struct_class = Types::ParticipantCapabilities
 
     ParticipantDetails.add_member(:display_name, Shapes::ShapeRef.new(shape: DisplayName, required: true, location_name: "DisplayName"))
@@ -5013,6 +5017,13 @@ module Aws::Connect
     StartOutboundVoiceContactResponse.add_member(:contact_id, Shapes::ShapeRef.new(shape: ContactId, location_name: "ContactId"))
     StartOutboundVoiceContactResponse.struct_class = Types::StartOutboundVoiceContactResponse
 
+    StartScreenSharingRequest.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientToken, location_name: "ClientToken", metadata: {"idempotencyToken"=>true}))
+    StartScreenSharingRequest.add_member(:instance_id, Shapes::ShapeRef.new(shape: InstanceId, required: true, location_name: "InstanceId"))
+    StartScreenSharingRequest.add_member(:contact_id, Shapes::ShapeRef.new(shape: ContactId, required: true, location_name: "ContactId"))
+    StartScreenSharingRequest.struct_class = Types::StartScreenSharingRequest
+
+    StartScreenSharingResponse.struct_class = Types::StartScreenSharingResponse
+
     StartTaskContactRequest.add_member(:instance_id, Shapes::ShapeRef.new(shape: InstanceId, required: true, location_name: "InstanceId"))
     StartTaskContactRequest.add_member(:previous_contact_id, Shapes::ShapeRef.new(shape: ContactId, location_name: "PreviousContactId"))
     StartTaskContactRequest.add_member(:contact_flow_id, Shapes::ShapeRef.new(shape: ContactFlowId, location_name: "ContactFlowId"))
@@ -8888,6 +8899,20 @@ module Aws::Connect
         o.errors << Shapes::ShapeRef.new(shape: OutboundContactNotPermittedException)
       end)
 
+      api.add_operation(:start_screen_sharing, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "StartScreenSharing"
+        o.http_method = "PUT"
+        o.http_request_uri = "/contact/screen-sharing"
+        o.input = Shapes::ShapeRef.new(shape: StartScreenSharingRequest)
+        o.output = Shapes::ShapeRef.new(shape: StartScreenSharingResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServiceException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+      end)
+
       api.add_operation(:start_task_contact, Seahorse::Model::Operation.new.tap do |o|
         o.name = "StartTaskContact"
         o.http_method = "PUT"

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

@@ -52,15 +52,18 @@ module Aws::Connect
       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