aws-sdk-connect 1.43.0 → 1.44.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 774b3bc00f60adb07b61f77c87df413219f2a4e574362aac34a564b35b31d796
-  data.tar.gz: ccf22d050d94253e291558a6a360b0b21fb7a2603dac503ac19d8f08aec54af4
+  metadata.gz: d16cb51cb332e7eb7b41fcd816454fc07475da61860fac58debc41c259055fe0
+  data.tar.gz: 2473f10a57bef02d91b56024d678f12e2539953e182311372bb760606f89696a
 SHA512:
-  metadata.gz: 65281b39977fa23daab45adba9346085f9d204f7d592858880d490a68573b2f420da244fd26873a6ed590388858b2438730807997919e8107a662ff0afb5691d
-  data.tar.gz: 4c678036fee3e09e560b4d77f7148f6db686ad0b112c3accd4fd4aa4eff317d942472240049cb1fe711b3c371fedad46f74a5b8ab03a7c6caece8d3b4b1a14d3
+  metadata.gz: deaaab80d73ab2017512dba80a29bc9fbacfb90433509ede026232f5d2896bb0fd5e2a43a0cb18fbf8fe79ff66957b2dcb6ba63f32bade88b8863141d789ddd8
+  data.tar.gz: 54d7e1e25d86d244b9ed5c8170f59b05f6389f5540387b2ec719add4686fb38537450c2c0b0733c95001ae44ebe829865f824c97f5bc98892bd029c85ed12c89

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.44.0 (2021-05-07)
+------------------
+
+* Feature - Adds tagging support for Connect APIs CreateIntegrationAssociation and CreateUseCase.
+
 1.43.0 (2021-04-28)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.43.0
+1.44.0

data/lib/aws-sdk-connect.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-connect/customizations'
 # @!group service
 module Aws::Connect
 
-  GEM_VERSION = '1.43.0'
+  GEM_VERSION = '1.44.0'
 
 end

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

@@ -672,6 +672,13 @@ module Aws::Connect
     # Service (Amazon S3) or Amazon Kinesis. It also does not allow for any
     # configurations on features, such as Contact Lens for Amazon Connect.
     #
+    # Amazon Connect enforces a limit on the total number of instances that
+    # you can create or delete in 30 days. If you exceed this limit, you
+    # will get an error message indicating there has been an excessive
+    # number of attempts at creating or deleting instances. You must wait 30
+    # days before you can restart creating and deleting instances in your
+    # account.
+    #
     # @option params [String] :client_token
     #   The idempotency token.
     #
@@ -720,9 +727,6 @@ module Aws::Connect
       req.send_request(options)
     end
 
-    # This API is in preview release for Amazon Connect and is subject to
-    # change.
-    #
     # Create an AppIntegration association with an Amazon Connect instance.
     #
     # @option params [required, String] :instance_id
@@ -743,6 +747,9 @@ module Aws::Connect
     # @option params [required, String] :source_type
     #   The type of the data source.
     #
+    # @option params [Hash<String,String>] :tags
+    #   One or more tags.
+    #
     # @return [Types::CreateIntegrationAssociationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateIntegrationAssociationResponse#integration_association_id #integration_association_id} => String
@@ -757,6 +764,9 @@ module Aws::Connect
     #     source_application_url: "URI", # required
     #     source_application_name: "SourceApplicationName", # required
     #     source_type: "SALESFORCE", # required, accepts SALESFORCE, ZENDESK
+    #     tags: {
+    #       "TagKey" => "TagValue",
+    #     },
     #   })
     #
     # @example Response structure
@@ -978,9 +988,6 @@ module Aws::Connect
       req.send_request(options)
     end
 
-    # This API is in preview release for Amazon Connect and is subject to
-    # change.
-    #
     # Creates a use case for an AppIntegration association.
     #
     # @option params [required, String] :instance_id
@@ -994,6 +1001,9 @@ module Aws::Connect
     #   Each AppIntegration association can have only one of each use case
     #   type.
     #
+    # @option params [Hash<String,String>] :tags
+    #   One or more tags.
+    #
     # @return [Types::CreateUseCaseResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateUseCaseResponse#use_case_id #use_case_id} => String
@@ -1005,6 +1015,9 @@ module Aws::Connect
     #     instance_id: "InstanceId", # required
     #     integration_association_id: "IntegrationAssociationId", # required
     #     use_case_type: "RULES_EVALUATION", # required, accepts RULES_EVALUATION
+    #     tags: {
+    #       "TagKey" => "TagValue",
+    #     },
     #   })
     #
     # @example Response structure
@@ -1166,6 +1179,13 @@ module Aws::Connect
     #
     # Deletes the Amazon Connect instance.
     #
+    # Amazon Connect enforces a limit on the total number of instances that
+    # you can create or delete in 30 days. If you exceed this limit, you
+    # will get an error message indicating there has been an excessive
+    # number of attempts at creating or deleting instances. You must wait 30
+    # days before you can restart creating and deleting instances in your
+    # account.
+    #
     # @option params [required, String] :instance_id
     #   The identifier of the Amazon Connect instance.
     #
@@ -1186,9 +1206,6 @@ module Aws::Connect
       req.send_request(options)
     end
 
-    # This API is in preview release for Amazon Connect and is subject to
-    # change.
-    #
     # Deletes an AppIntegration association from an Amazon Connect instance.
     # The association must not have any use cases associated with it.
     #
@@ -1245,9 +1262,6 @@ module Aws::Connect
       req.send_request(options)
     end
 
-    # This API is in preview release for Amazon Connect and is subject to
-    # change.
-    #
     # Deletes a use case from an AppIntegration association.
     #
     # @option params [required, String] :instance_id
@@ -2306,6 +2320,15 @@ module Aws::Connect
 
     # Retrieves a token for federation.
     #
+    # <note markdown="1"> This API doesn't support root users. If you try to invoke
+    # GetFederationToken with root credentials, an error message similar to
+    # the following one appears:
+    #
+    #  `Provided identity: Principal: .... User: .... cannot be used for
+    # federation with Amazon Connect`
+    #
+    #  </note>
+    #
     # @option params [required, String] :instance_id
     #   The identifier of the Amazon Connect instance.
     #
@@ -2373,14 +2396,17 @@ module Aws::Connect
     #   both queue IDs and queue ARNs in the same request. VOICE, CHAT, and
     #   TASK channels are supported.
     #
+    #   <note markdown="1"> To filter by `Queues`, enter the queue ID/ARN, not the name of the
+    #   queue.
+    #
+    #    </note>
+    #
     # @option params [Array<String>] :groupings
     #   The grouping applied to the metrics returned. For example, when
     #   results are grouped by queue, the metrics returned are grouped by
     #   queue. The values returned apply to the metrics for each queue rather
     #   than aggregated for all queues.
     #
-    #   The only supported grouping is `QUEUE`.
-    #
     #   If no grouping is specified, a summary of metrics for all queues is
     #   returned.
     #
@@ -2536,13 +2562,15 @@ module Aws::Connect
     #
     #   SERVICE\_LEVEL
     #
-    #   : Unit: PERCENT
+    #   : You can include up to 20 SERVICE\_LEVEL metrics in a request.
+    #
+    #     Unit: PERCENT
     #
     #     Statistic: AVG
     #
-    #     Threshold: Only "Less than" comparisons are supported, with the
-    #     following service level thresholds: 15, 20, 25, 30, 45, 60, 90, 120,
-    #     180, 240, 300, 600
+    #     Threshold: For `ThresholdValue`, enter any whole number from 1 to
+    #     604800 (inclusive), in seconds. For `Comparison`, you must enter
+    #     `LT` (for "Less than").
     #
     #
     #
@@ -2938,9 +2966,6 @@ module Aws::Connect
       req.send_request(options)
     end
 
-    # This API is in preview release for Amazon Connect and is subject to
-    # change.
-    #
     # Provides summary information about the AppIntegration associations for
     # the specified Amazon Connect instance.
     #
@@ -3253,6 +3278,11 @@ module Aws::Connect
     # Provides information about the queues for the specified Amazon Connect
     # instance.
     #
+    # If you do not specify a `QueueTypes` parameter, both standard and
+    # agent queues are returned. This might cause an unexpected truncation
+    # of results if you have more than 1000 agents and you limit the number
+    # of results of the API call in code.
+    #
     # For more information about queues, see [Queues: Standard and Agent][1]
     # in the *Amazon Connect Administrator Guide*.
     #
@@ -3610,9 +3640,6 @@ module Aws::Connect
       req.send_request(options)
     end
 
-    # This API is in preview release for Amazon Connect and is subject to
-    # change.
-    #
     # Lists the use cases.
     #
     # @option params [required, String] :instance_id
@@ -3809,7 +3836,7 @@ module Aws::Connect
     # A 429 error occurs in two situations:
     #
     # * API rate limit is exceeded. API TPS throttling returns a
-    #   `TooManyRequests` exception from the API Gateway.
+    #   `TooManyRequests` exception.
     #
     # * The [quota for concurrent active chats][2] is exceeded. Active chat
     #   throttling returns a `LimitExceededException`.
@@ -4300,21 +4327,23 @@ module Aws::Connect
       req.send_request(options)
     end
 
-    # Creates or updates the contact attributes associated with the
+    # Creates or updates user-defined contact attributes associated with the
     # specified contact.
     #
-    # You can add or update attributes for both ongoing and completed
-    # contacts. For example, while the call is active, you can update the
-    # customer's name or the reason the customer called. You can add notes
-    # about steps that the agent took during the call that display to the
-    # next agent that takes the call. You can also update attributes for a
-    # contact using data from your CRM application and save the data with
-    # the contact in Amazon Connect. You could also flag calls for
+    # You can create or update user-defined attributes for both ongoing and
+    # completed contacts. For example, while the call is active, you can
+    # update the customer's name or the reason the customer called. You can
+    # add notes about steps that the agent took during the call that display
+    # to the next agent that takes the call. You can also update attributes
+    # for a contact using data from your CRM application and save the data
+    # with the contact in Amazon Connect. You could also flag calls for
     # additional analysis, such as legal review or to identify abusive
     # callers.
     #
     # Contact attributes are available in Amazon Connect for 24 months, and
-    # are then deleted.
+    # are then deleted. For information about CTR retention and the maximum
+    # size of the CTR attributes section, see [Feature specifications][1] in
+    # the *Amazon Connect Administrator Guide*.
     #
     # **Important:** You cannot use the operation to update attributes for
     # contacts that occurred prior to the release of the API, which was
@@ -4325,6 +4354,10 @@ module Aws::Connect
     # that were initiated prior to the release of the API but are still
     # active in your instance.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-service-limits.html#feature-limits
+    #
     # @option params [required, String] :initial_contact_id
     #   The identifier of the contact. This is the identifier of the contact
     #   associated with the first interaction with the contact center.
@@ -5207,7 +5240,7 @@ module Aws::Connect
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-connect'
-      context[:gem_version] = '1.43.0'
+      context[:gem_version] = '1.44.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -528,6 +528,7 @@ module Aws::Connect
     CreateIntegrationAssociationRequest.add_member(:source_application_url, Shapes::ShapeRef.new(shape: URI, required: true, location_name: "SourceApplicationUrl"))
     CreateIntegrationAssociationRequest.add_member(:source_application_name, Shapes::ShapeRef.new(shape: SourceApplicationName, required: true, location_name: "SourceApplicationName"))
     CreateIntegrationAssociationRequest.add_member(:source_type, Shapes::ShapeRef.new(shape: SourceType, required: true, location_name: "SourceType"))
+    CreateIntegrationAssociationRequest.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "Tags"))
     CreateIntegrationAssociationRequest.struct_class = Types::CreateIntegrationAssociationRequest
 
     CreateIntegrationAssociationResponse.add_member(:integration_association_id, Shapes::ShapeRef.new(shape: IntegrationAssociationId, location_name: "IntegrationAssociationId"))
@@ -575,6 +576,7 @@ module Aws::Connect
     CreateUseCaseRequest.add_member(:instance_id, Shapes::ShapeRef.new(shape: InstanceId, required: true, location: "uri", location_name: "InstanceId"))
     CreateUseCaseRequest.add_member(:integration_association_id, Shapes::ShapeRef.new(shape: IntegrationAssociationId, required: true, location: "uri", location_name: "IntegrationAssociationId"))
     CreateUseCaseRequest.add_member(:use_case_type, Shapes::ShapeRef.new(shape: UseCaseType, required: true, location_name: "UseCaseType"))
+    CreateUseCaseRequest.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "Tags"))
     CreateUseCaseRequest.struct_class = Types::CreateUseCaseRequest
 
     CreateUseCaseResponse.add_member(:use_case_id, Shapes::ShapeRef.new(shape: UseCaseId, location_name: "UseCaseId"))

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

@@ -576,6 +576,9 @@ module Aws::Connect
     #         source_application_url: "URI", # required
     #         source_application_name: "SourceApplicationName", # required
     #         source_type: "SALESFORCE", # required, accepts SALESFORCE, ZENDESK
+    #         tags: {
+    #           "TagKey" => "TagValue",
+    #         },
     #       }
     #
     # @!attribute [rw] instance_id
@@ -602,6 +605,10 @@ module Aws::Connect
     #   The type of the data source.
     #   @return [String]
     #
+    # @!attribute [rw] tags
+    #   One or more tags.
+    #   @return [Hash<String,String>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/CreateIntegrationAssociationRequest AWS API Documentation
     #
     class CreateIntegrationAssociationRequest < Struct.new(
@@ -610,7 +617,8 @@ module Aws::Connect
       :integration_arn,
       :source_application_url,
       :source_application_name,
-      :source_type)
+      :source_type,
+      :tags)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -891,6 +899,9 @@ module Aws::Connect
     #         instance_id: "InstanceId", # required
     #         integration_association_id: "IntegrationAssociationId", # required
     #         use_case_type: "RULES_EVALUATION", # required, accepts RULES_EVALUATION
+    #         tags: {
+    #           "TagKey" => "TagValue",
+    #         },
     #       }
     #
     # @!attribute [rw] instance_id
@@ -907,12 +918,17 @@ module Aws::Connect
     #   type.
     #   @return [String]
     #
+    # @!attribute [rw] tags
+    #   One or more tags.
+    #   @return [Hash<String,String>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/CreateUseCaseRequest AWS API Documentation
     #
     class CreateUseCaseRequest < Struct.new(
       :instance_id,
       :integration_association_id,
-      :use_case_type)
+      :use_case_type,
+      :tags)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2398,6 +2414,11 @@ module Aws::Connect
     #   with the queues or channels included in the filter. You can include
     #   both queue IDs and queue ARNs in the same request. VOICE, CHAT, and
     #   TASK channels are supported.
+    #
+    #   <note markdown="1"> To filter by `Queues`, enter the queue ID/ARN, not the name of the
+    #   queue.
+    #
+    #    </note>
     #   @return [Types::Filters]
     #
     # @!attribute [rw] groupings
@@ -2406,8 +2427,6 @@ module Aws::Connect
     #   queue. The values returned apply to the metrics for each queue
     #   rather than aggregated for all queues.
     #
-    #   The only supported grouping is `QUEUE`.
-    #
     #   If no grouping is specified, a summary of metrics for all queues is
     #   returned.
     #   @return [Array<String>]
@@ -2564,13 +2583,15 @@ module Aws::Connect
     #
     #   SERVICE\_LEVEL
     #
-    #   : Unit: PERCENT
+    #   : You can include up to 20 SERVICE\_LEVEL metrics in a request.
+    #
+    #     Unit: PERCENT
     #
     #     Statistic: AVG
     #
-    #     Threshold: Only "Less than" comparisons are supported, with the
-    #     following service level thresholds: 15, 20, 25, 30, 45, 60, 90,
-    #     120, 180, 240, 300, 600
+    #     Threshold: For `ThresholdValue`, enter any whole number from 1 to
+    #     604800 (inclusive), in seconds. For `Comparison`, you must enter
+    #     `LT` (for "Less than").
     #
     #
     #
@@ -4654,6 +4675,12 @@ module Aws::Connect
     # @!attribute [rw] concurrency
     #   The number of contacts an agent can have on a channel
     #   simultaneously.
+    #
+    #   Valid Range for `VOICE`\: Minimum value of 1. Maximum value of 1.
+    #
+    #   Valid Range for `CHAT`\: Minimum value of 1. Maximum value of 5.
+    #
+    #   Valid Range for `TASK`\: Minimum value of 1. Maximum value of 10.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/MediaConcurrency AWS API Documentation

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-connect
 version: !ruby/object:Gem::Version
-  version: 1.43.0
+  version: 1.44.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-04-28 00:00:00.000000000 Z
+date: 2021-05-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core