aws-sdk-connect 1.9.0 → 1.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 60c6b98784bcedc373073f5ab6fa90958d37bd09
-  data.tar.gz: e8b3b8634a04c2f655c16368d1604baeeef257e5
+  metadata.gz: ad1d4e9b7eb1fc7a8b806261524479e87aacd5c7
+  data.tar.gz: 6e7d5f579d9e358f27fd3598255aec7933862db8
 SHA512:
-  metadata.gz: 572e3e7bdc7e0a0ccd5dcaf37e725df7baf232311cf7b3860d2d360630d8da8f50019c25061599c899ac6f350e1409cb82256d14b2aa1d799a0314ea36b3275a
-  data.tar.gz: 52bb5febf207b628a1e272fed4ba4b5dc16fcbb971792e085d17347fac00baef938a28e73e1257401a15022c88bd485b0b8ad1f6f43426cb1eef56efd2c8c26f
+  metadata.gz: 2416e4b2bdb4ab466b34d5074c82d2a09cd3f8ff77bc36bc2d5f8cdcd1fb7d78221eddf610d051e82f733a85ceae776a98852b3fae875e3bd345b0065437cb05
+  data.tar.gz: fdaa6ce06b7f7706e1a168badecab394a3e3be92c2db73b8d16ecdcfd79780d1999db21f1b9dbe92302d9c0e34b2c84148ecef9936e024b8a8467c29225ab886

data/lib/aws-sdk-connect.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-connect/customizations'
 # @service
 module Aws::Connect
 
-  GEM_VERSION = '1.9.0'
+  GEM_VERSION = '1.10.0'
 
 end

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

@@ -208,7 +208,10 @@ module Aws::Connect
     # Creates a new user account in your Amazon Connect instance.
     #
     # @option params [required, String] :username
-    #   The user name in Amazon Connect for the account to create.
+    #   The user name in Amazon Connect for the account to create. If you are
+    #   using SAML for identity management in your Amazon Connect, the value
+    #   for `Username` can include up to 64 characters from
+    #   \[a-zA-Z0-9\_-.\\@\]+.
     #
     # @option params [String] :password
     #   The password for the user account to create. This is required if you
@@ -222,7 +225,8 @@ module Aws::Connect
     #
     # @option params [required, Types::UserPhoneConfig] :phone_config
     #   Specifies the phone settings for the user, including
-    #   AfterContactWorkTimeLimit, AutoAccept, DeskPhoneNumber, and PhoneType.
+    #   `AfterContactWorkTimeLimit`, `AutoAccept`, `DeskPhoneNumber`, and
+    #   `PhoneType`.
     #
     # @option params [String] :directory_user_id
     #   The unique identifier for the user account in the directory service
@@ -230,8 +234,8 @@ module Aws::Connect
     #   access the existing directory, you can use the `DirectoryUserId` to
     #   authenticate users. If you include the parameter, it is assumed that
     #   Amazon Connect cannot access the directory. If the parameter is not
-    #   included, the UserIdentityInfo is used to authenticate users from your
-    #   existing directory.
+    #   included, the `UserIdentityInfo` is used to authenticate users from
+    #   your existing directory.
     #
     #   This parameter is required if you are using an existing directory for
     #   identity management in Amazon Connect when Amazon Connect cannot
@@ -493,6 +497,41 @@ module Aws::Connect
       req.send_request(options)
     end
 
+    # Retrieves the contact attributes associated with a contact.
+    #
+    # @option params [required, String] :instance_id
+    #   The instance ID for the instance from which to retrieve contact
+    #   attributes.
+    #
+    # @option params [required, String] :initial_contact_id
+    #   The ID for the initial contact in Amazon Connect associated with the
+    #   attributes to update.
+    #
+    # @return [Types::GetContactAttributesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetContactAttributesResponse#attributes #attributes} => Hash<String,String>
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_contact_attributes({
+    #     instance_id: "InstanceId", # required
+    #     initial_contact_id: "ContactId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.attributes #=> Hash
+    #   resp.attributes["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/GetContactAttributes AWS API Documentation
+    #
+    # @overload get_contact_attributes(params = {})
+    # @param [Hash] params ({})
+    def get_contact_attributes(params = {}, options = {})
+      req = build_request(:get_contact_attributes, params)
+      req.send_request(options)
+    end
+
     # The `GetCurrentMetricData` operation retrieves current metric data
     # from your Amazon Connect instance.
     #
@@ -537,7 +576,8 @@ module Aws::Connect
     # @option params [required, Array<Types::CurrentMetric>] :current_metrics
     #   A list of `CurrentMetric` objects for the metrics to retrieve. Each
     #   `CurrentMetric` includes a name of a metric to retrieve and the unit
-    #   to use for it.
+    #   to use for it. You must list each metric to retrieve data for in the
+    #   request.
     #
     #   The following metrics are available:
     #
@@ -746,8 +786,9 @@ module Aws::Connect
     #   A `HistoricalMetric` object contains: `HistoricalMetricName`,
     #   `Statistic`, `Threshold`, and `Unit`.
     #
-    #   For each historical metric you include in the request, you must
-    #   include a `Unit` and a `Statistic`.
+    #   You must list each metric to retrieve data for in the request. For
+    #   each historical metric you include in the request, you must include a
+    #   `Unit` and a `Statistic`.
     #
     #   The following historical metrics are available:
     #
@@ -1183,6 +1224,9 @@ module Aws::Connect
     # If you are using an IAM account, it must have permission to the
     # `connect:StartOutboundVoiceContact` action.
     #
+    # There is a 60 second dialing timeout for this operation. If the call
+    # is not connected after 60 seconds, the call fails.
+    #
     # @option params [required, String] :destination_phone_number
     #   The phone number of the customer in E.164 format.
     #
@@ -1234,9 +1278,9 @@ module Aws::Connect
     #   are standard Amazon Connect attributes, and can be accessed in contact
     #   flows just like any other contact attributes.
     #
-    #   There can be up to 32,768 UTF-8 bytes across all key-value pairs.
-    #   Attribute keys can include only alphanumeric, dash, and underscore
-    #   characters.
+    #   There can be up to 32,768 UTF-8 bytes across all key-value pairs per
+    #   contact. Attribute keys can include only alphanumeric, dash, and
+    #   underscore characters.
     #
     #   For example, if you want play a greeting when the customer answers the
     #   call, you can pass the customer name in attributes similar to the
@@ -1350,7 +1394,13 @@ module Aws::Connect
     #   10a4c4eb-f57e-4d4c-b602-bf39176ced07.
     #
     # @option params [required, Hash<String,String>] :attributes
-    #   The key-value pairs for the attribute to update.
+    #   Specify a custom key-value pair using an attribute map. The attributes
+    #   are standard Amazon Connect attributes, and can be accessed in contact
+    #   flows just like any other contact attributes.
+    #
+    #   There can be up to 32,768 UTF-8 bytes across all key-value pairs per
+    #   contact. Attribute keys can include only alphanumeric, dash, and
+    #   underscore characters.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1580,7 +1630,7 @@ module Aws::Connect
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-connect'
-      context[:gem_version] = '1.9.0'
+      context[:gem_version] = '1.10.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -50,6 +50,8 @@ module Aws::Connect
     DuplicateResourceException = Shapes::StructureShape.new(name: 'DuplicateResourceException')
     Email = Shapes::StringShape.new(name: 'Email')
     Filters = Shapes::StructureShape.new(name: 'Filters')
+    GetContactAttributesRequest = Shapes::StructureShape.new(name: 'GetContactAttributesRequest')
+    GetContactAttributesResponse = Shapes::StructureShape.new(name: 'GetContactAttributesResponse')
     GetCurrentMetricDataRequest = Shapes::StructureShape.new(name: 'GetCurrentMetricDataRequest')
     GetCurrentMetricDataResponse = Shapes::StructureShape.new(name: 'GetCurrentMetricDataResponse')
     GetFederationTokenRequest = Shapes::StructureShape.new(name: 'GetFederationTokenRequest')
@@ -212,6 +214,13 @@ module Aws::Connect
     Filters.add_member(:channels, Shapes::ShapeRef.new(shape: Channels, location_name: "Channels"))
     Filters.struct_class = Types::Filters
 
+    GetContactAttributesRequest.add_member(:instance_id, Shapes::ShapeRef.new(shape: InstanceId, required: true, location: "uri", location_name: "InstanceId"))
+    GetContactAttributesRequest.add_member(:initial_contact_id, Shapes::ShapeRef.new(shape: ContactId, required: true, location: "uri", location_name: "InitialContactId"))
+    GetContactAttributesRequest.struct_class = Types::GetContactAttributesRequest
+
+    GetContactAttributesResponse.add_member(:attributes, Shapes::ShapeRef.new(shape: Attributes, location_name: "Attributes"))
+    GetContactAttributesResponse.struct_class = Types::GetContactAttributesResponse
+
     GetCurrentMetricDataRequest.add_member(:instance_id, Shapes::ShapeRef.new(shape: InstanceId, required: true, location: "uri", location_name: "InstanceId"))
     GetCurrentMetricDataRequest.add_member(:filters, Shapes::ShapeRef.new(shape: Filters, required: true, location_name: "Filters"))
     GetCurrentMetricDataRequest.add_member(:groupings, Shapes::ShapeRef.new(shape: Groupings, location_name: "Groupings"))
@@ -527,6 +536,17 @@ module Aws::Connect
         o.errors << Shapes::ShapeRef.new(shape: InternalServiceException)
       end)
 
+      api.add_operation(:get_contact_attributes, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetContactAttributes"
+        o.http_method = "GET"
+        o.http_request_uri = "/contact/attributes/{InstanceId}/{InitialContactId}"
+        o.input = Shapes::ShapeRef.new(shape: GetContactAttributesRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetContactAttributesResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServiceException)
+      end)
+
       api.add_operation(:get_current_metric_data, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetCurrentMetricData"
         o.http_method = "POST"

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

@@ -33,7 +33,10 @@ module Aws::Connect
     #       }
     #
     # @!attribute [rw] username
-    #   The user name in Amazon Connect for the account to create.
+    #   The user name in Amazon Connect for the account to create. If you
+    #   are using SAML for identity management in your Amazon Connect, the
+    #   value for `Username` can include up to 64 characters from
+    #   \[a-zA-Z0-9\_-.\\@\]+.
     #   @return [String]
     #
     # @!attribute [rw] password
@@ -50,8 +53,8 @@ module Aws::Connect
     #
     # @!attribute [rw] phone_config
     #   Specifies the phone settings for the user, including
-    #   AfterContactWorkTimeLimit, AutoAccept, DeskPhoneNumber, and
-    #   PhoneType.
+    #   `AfterContactWorkTimeLimit`, `AutoAccept`, `DeskPhoneNumber`, and
+    #   `PhoneType`.
     #   @return [Types::UserPhoneConfig]
     #
     # @!attribute [rw] directory_user_id
@@ -60,7 +63,7 @@ module Aws::Connect
     #   to access the existing directory, you can use the `DirectoryUserId`
     #   to authenticate users. If you include the parameter, it is assumed
     #   that Amazon Connect cannot access the directory. If the parameter is
-    #   not included, the UserIdentityInfo is used to authenticate users
+    #   not included, the `UserIdentityInfo` is used to authenticate users
     #   from your existing directory.
     #
     #   This parameter is required if you are using an existing directory
@@ -417,6 +420,43 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass GetContactAttributesRequest
+    #   data as a hash:
+    #
+    #       {
+    #         instance_id: "InstanceId", # required
+    #         initial_contact_id: "ContactId", # required
+    #       }
+    #
+    # @!attribute [rw] instance_id
+    #   The instance ID for the instance from which to retrieve contact
+    #   attributes.
+    #   @return [String]
+    #
+    # @!attribute [rw] initial_contact_id
+    #   The ID for the initial contact in Amazon Connect associated with the
+    #   attributes to update.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/GetContactAttributesRequest AWS API Documentation
+    #
+    class GetContactAttributesRequest < Struct.new(
+      :instance_id,
+      :initial_contact_id)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] attributes
+    #   The attributes to update.
+    #   @return [Hash<String,String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/GetContactAttributesResponse AWS API Documentation
+    #
+    class GetContactAttributesResponse < Struct.new(
+      :attributes)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass GetCurrentMetricDataRequest
     #   data as a hash:
     #
@@ -478,7 +518,8 @@ module Aws::Connect
     # @!attribute [rw] current_metrics
     #   A list of `CurrentMetric` objects for the metrics to retrieve. Each
     #   `CurrentMetric` includes a name of a metric to retrieve and the unit
-    #   to use for it.
+    #   to use for it. You must list each metric to retrieve data for in the
+    #   request.
     #
     #   The following metrics are available:
     #
@@ -719,8 +760,9 @@ module Aws::Connect
     #   A `HistoricalMetric` object contains: `HistoricalMetricName`,
     #   `Statistic`, `Threshold`, and `Unit`.
     #
-    #   For each historical metric you include in the request, you must
-    #   include a `Unit` and a `Statistic`.
+    #   You must list each metric to retrieve data for in the request. For
+    #   each historical metric you include in the request, you must include
+    #   a `Unit` and a `Statistic`.
     #
     #   The following historical metrics are available:
     #
@@ -1125,11 +1167,11 @@ module Aws::Connect
     #   @return [Types::Threshold]
     #
     # @!attribute [rw] statistic
-    #   The statistic for the metric: SUM, MAX, or SUM.
+    #   The statistic for the metric.
     #   @return [String]
     #
     # @!attribute [rw] unit
-    #   The unit for the metric: COUNT, PERCENT, or SECONDS.
+    #   The unit for the metric.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/HistoricalMetric AWS API Documentation
@@ -1545,9 +1587,9 @@ module Aws::Connect
     #   attributes are standard Amazon Connect attributes, and can be
     #   accessed in contact flows just like any other contact attributes.
     #
-    #   There can be up to 32,768 UTF-8 bytes across all key-value pairs.
-    #   Attribute keys can include only alphanumeric, dash, and underscore
-    #   characters.
+    #   There can be up to 32,768 UTF-8 bytes across all key-value pairs per
+    #   contact. Attribute keys can include only alphanumeric, dash, and
+    #   underscore characters.
     #
     #   For example, if you want play a greeting when the customer answers
     #   the call, you can pass the customer name in attributes similar to
@@ -1670,7 +1712,13 @@ module Aws::Connect
     #   @return [String]
     #
     # @!attribute [rw] attributes
-    #   The key-value pairs for the attribute to update.
+    #   Specify a custom key-value pair using an attribute map. The
+    #   attributes are standard Amazon Connect attributes, and can be
+    #   accessed in contact flows just like any other contact attributes.
+    #
+    #   There can be up to 32,768 UTF-8 bytes across all key-value pairs per
+    #   contact. Attribute keys can include only alphanumeric, dash, and
+    #   underscore characters.
     #   @return [Hash<String,String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/UpdateContactAttributesRequest AWS API Documentation

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-connect
 version: !ruby/object:Gem::Version
-  version: 1.9.0
+  version: 1.10.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-11-20 00:00:00.000000000 Z
+date: 2018-12-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core