aws-sdk-connect 1.154.0 → 1.156.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 537858dd9ff5dcc5e8cb05e021ce0ff0edcb9c7ed3cae299b394c4243b16681b
-  data.tar.gz: 27e83ba1f4ac0176d4c3a0a15a3d2b8e381e1ce40b70a34f91b54c7d4c739f79
+  metadata.gz: 75320558d9a289ed2c5aab965fe6f0205c3e443847b886777c508861feb18017
+  data.tar.gz: abe7ed35c501ab8af8b862b4bd9d2c48e8487ca98ff193893f29142e3dcc7779
 SHA512:
-  metadata.gz: cc1241c87f65f5ae37120f6d4ab79d7e371c5b304e6e70fbb3f49699c210ba7339c778577db9059b021139b43a6342aef1654f064eed066a639419402205115f
-  data.tar.gz: 6fb480cabf18ae43e11a90c27b746c49087a83fb310006c87737ffa02e8091db126c9acb4e827a1f644f2789e8e3e5b336da2bbcff3b54d31121433da8df30af
+  metadata.gz: 1ca72ac9c903c4079b4c25a0c6d0d019f865d3d7cbf0649fa96445ac0a86f5a3ffda86f7f65becbb1ca68fe3643143047bc047d1d1ac5fc3e51f8eb280aa26d3
+  data.tar.gz: f78a7f380ff91a6e41003b3cb6a33e4cc2e22d58e228e39d4119d856d4553a79401e084e0c898c5932bfdcf48c3c5d2b42a77a733caccb301111a7413e567cb1

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.156.0 (2024-05-03)
+------------------
+
+* Feature - This release adds 5 new APIs for managing attachments: StartAttachedFileUpload, CompleteAttachedFileUpload, GetAttachedFile, BatchGetAttachedFileMetadata, DeleteAttachedFile. These APIs can be used to programmatically upload and download attachments to Connect resources, like cases.
+
+1.155.0 (2024-04-25)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.154.0 (2024-04-10)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.154.0
+1.156.0

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

@@ -22,6 +22,7 @@ require 'aws-sdk-core/plugins/endpoint_pattern.rb'
 require 'aws-sdk-core/plugins/response_paging.rb'
 require 'aws-sdk-core/plugins/stub_responses.rb'
 require 'aws-sdk-core/plugins/idempotency_token.rb'
+require 'aws-sdk-core/plugins/invocation_id.rb'
 require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
 require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
@@ -72,6 +73,7 @@ module Aws::Connect
     add_plugin(Aws::Plugins::ResponsePaging)
     add_plugin(Aws::Plugins::StubResponses)
     add_plugin(Aws::Plugins::IdempotencyToken)
+    add_plugin(Aws::Plugins::InvocationId)
     add_plugin(Aws::Plugins::JsonvalueConverter)
     add_plugin(Aws::Plugins::ClientMetricsPlugin)
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
@@ -196,10 +198,17 @@ module Aws::Connect
     #     When set to 'true' the request body will not be compressed
     #     for supported operations.
     #
-    #   @option options [String] :endpoint
-    #     The client endpoint is normally constructed from the `:region`
-    #     option. You should only configure an `:endpoint` when connecting
-    #     to test or custom endpoints. This should be a valid HTTP(S) URI.
+    #   @option options [String, URI::HTTPS, URI::HTTP] :endpoint
+    #     Normally you should not configure the `:endpoint` option
+    #     directly. This is normally constructed from the `:region`
+    #     option. Configuring `:endpoint` is normally reserved for
+    #     connecting to test or custom endpoints. The endpoint should
+    #     be a URI formatted like:
+    #
+    #         'http://example.com'
+    #         'https://example.com'
+    #         'http://example.com:123'
+    #
     #
     #   @option options [Integer] :endpoint_cache_max_entries (1000)
     #     Used for the maximum size limit of the LRU cache storing endpoints data
@@ -337,50 +346,65 @@ module Aws::Connect
     #   @option options [Aws::Connect::EndpointProvider] :endpoint_provider
     #     The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::Connect::EndpointParameters`
     #
-    #   @option options [URI::HTTP,String] :http_proxy A proxy to send
-    #     requests through.  Formatted like 'http://proxy.com:123'.
-    #
-    #   @option options [Float] :http_open_timeout (15) The number of
-    #     seconds to wait when opening a HTTP session before raising a
-    #     `Timeout::Error`.
-    #
-    #   @option options [Float] :http_read_timeout (60) The default
-    #     number of seconds to wait for response data.  This value can
-    #     safely be set per-request on the session.
-    #
-    #   @option options [Float] :http_idle_timeout (5) The number of
-    #     seconds a connection is allowed to sit idle before it is
-    #     considered stale.  Stale connections are closed and removed
-    #     from the pool before making a request.
-    #
-    #   @option options [Float] :http_continue_timeout (1) The number of
-    #     seconds to wait for a 100-continue response before sending the
-    #     request body.  This option has no effect unless the request has
-    #     "Expect" header set to "100-continue".  Defaults to `nil` which
-    #     disables this behaviour.  This value can safely be set per
-    #     request on the session.
-    #
-    #   @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
-    #     in seconds.
-    #
-    #   @option options [Boolean] :http_wire_trace (false) When `true`,
-    #     HTTP debug output will be sent to the `:logger`.
+    #   @option options [Float] :http_continue_timeout (1)
+    #     The number of seconds to wait for a 100-continue response before sending the
+    #     request body.  This option has no effect unless the request has "Expect"
+    #     header set to "100-continue".  Defaults to `nil` which  disables this
+    #     behaviour.  This value can safely be set per request on the session.
+    #
+    #   @option options [Float] :http_idle_timeout (5)
+    #     The number of seconds a connection is allowed to sit idle before it
+    #     is considered stale.  Stale connections are closed and removed from the
+    #     pool before making a request.
+    #
+    #   @option options [Float] :http_open_timeout (15)
+    #     The default number of seconds to wait for response data.
+    #     This value can safely be set per-request on the session.
+    #
+    #   @option options [URI::HTTP,String] :http_proxy
+    #     A proxy to send requests through.  Formatted like 'http://proxy.com:123'.
+    #
+    #   @option options [Float] :http_read_timeout (60)
+    #     The default number of seconds to wait for response data.
+    #     This value can safely be set per-request on the session.
+    #
+    #   @option options [Boolean] :http_wire_trace (false)
+    #     When `true`,  HTTP debug output will be sent to the `:logger`.
+    #
+    #   @option options [Proc] :on_chunk_received
+    #     When a Proc object is provided, it will be used as callback when each chunk
+    #     of the response body is received. It provides three arguments: the chunk,
+    #     the number of bytes received, and the total number of
+    #     bytes in the response (or nil if the server did not send a `content-length`).
+    #
+    #   @option options [Proc] :on_chunk_sent
+    #     When a Proc object is provided, it will be used as callback when each chunk
+    #     of the request body is sent. It provides three arguments: the chunk,
+    #     the number of bytes read from the body, and the total number of
+    #     bytes in the body.
+    #
+    #   @option options [Boolean] :raise_response_errors (true)
+    #     When `true`, response errors are raised.
+    #
+    #   @option options [String] :ssl_ca_bundle
+    #     Full path to the SSL certificate authority bundle file that should be used when
+    #     verifying peer certificates.  If you do not pass `:ssl_ca_bundle` or
+    #     `:ssl_ca_directory` the the system default will be used if available.
+    #
+    #   @option options [String] :ssl_ca_directory
+    #     Full path of the directory that contains the unbundled SSL certificate
+    #     authority files for verifying peer certificates.  If you do
+    #     not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the system
+    #     default will be used if available.
     #
-    #   @option options [Boolean] :ssl_verify_peer (true) When `true`,
-    #     SSL peer certificates are verified when establishing a
-    #     connection.
+    #   @option options [String] :ssl_ca_store
+    #     Sets the X509::Store to verify peer certificate.
     #
-    #   @option options [String] :ssl_ca_bundle Full path to the SSL
-    #     certificate authority bundle file that should be used when
-    #     verifying peer certificates.  If you do not pass
-    #     `:ssl_ca_bundle` or `:ssl_ca_directory` the the system default
-    #     will be used if available.
+    #   @option options [Float] :ssl_timeout
+    #     Sets the SSL timeout in seconds
     #
-    #   @option options [String] :ssl_ca_directory Full path of the
-    #     directory that contains the unbundled SSL certificate
-    #     authority files for verifying peer certificates.  If you do
-    #     not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the
-    #     system default will be used if available.
+    #   @option options [Boolean] :ssl_verify_peer (true)
+    #     When `true`, SSL peer certificates are verified when establishing a connection.
     #
     def initialize(*args)
       super
@@ -1181,6 +1205,70 @@ module Aws::Connect
       req.send_request(options)
     end
 
+    # Allows you to retrieve metadata about multiple attached files on an
+    # associated resource. Each attached file provided in the input list
+    # must be associated with the input AssociatedResourceArn.
+    #
+    # @option params [required, Array<String>] :file_ids
+    #   The unique identifiers of the attached file resource.
+    #
+    # @option params [required, String] :instance_id
+    #   The unique identifier of the Connect instance.
+    #
+    # @option params [required, String] :associated_resource_arn
+    #   The resource to which the attached file is (being) uploaded to.
+    #   [Cases][1] are the only current supported resource.
+    #
+    #   <note markdown="1"> This value must be a valid ARN.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.html
+    #
+    # @return [Types::BatchGetAttachedFileMetadataResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::BatchGetAttachedFileMetadataResponse#files #files} => Array&lt;Types::AttachedFile&gt;
+    #   * {Types::BatchGetAttachedFileMetadataResponse#errors #errors} => Array&lt;Types::AttachedFileError&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.batch_get_attached_file_metadata({
+    #     file_ids: ["FileId"], # required
+    #     instance_id: "InstanceId", # required
+    #     associated_resource_arn: "ARN", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.files #=> Array
+    #   resp.files[0].creation_time #=> String
+    #   resp.files[0].file_arn #=> String
+    #   resp.files[0].file_id #=> String
+    #   resp.files[0].file_name #=> String
+    #   resp.files[0].file_size_in_bytes #=> Integer
+    #   resp.files[0].file_status #=> String, one of "APPROVED", "REJECTED", "PROCESSING", "FAILED"
+    #   resp.files[0].created_by.connect_user_arn #=> String
+    #   resp.files[0].created_by.aws_identity_arn #=> String
+    #   resp.files[0].file_use_case_type #=> String, one of "ATTACHMENT"
+    #   resp.files[0].associated_resource_arn #=> String
+    #   resp.files[0].tags #=> Hash
+    #   resp.files[0].tags["TagKey"] #=> String
+    #   resp.errors #=> Array
+    #   resp.errors[0].error_code #=> String
+    #   resp.errors[0].error_message #=> String
+    #   resp.errors[0].file_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/BatchGetAttachedFileMetadata AWS API Documentation
+    #
+    # @overload batch_get_attached_file_metadata(params = {})
+    # @param [Hash] params ({})
+    def batch_get_attached_file_metadata(params = {}, options = {})
+      req = build_request(:batch_get_attached_file_metadata, params)
+      req.send_request(options)
+    end
+
     # Retrieve the flow associations for the given resources.
     #
     # @option params [required, String] :instance_id
@@ -1432,6 +1520,46 @@ module Aws::Connect
       req.send_request(options)
     end
 
+    # Allows you to confirm that the attached file has been uploaded using
+    # the pre-signed URL provided in the StartAttachedFileUpload API.
+    #
+    # @option params [required, String] :instance_id
+    #   The unique identifier of the Connect instance.
+    #
+    # @option params [required, String] :file_id
+    #   The unique identifier of the attached file resource.
+    #
+    # @option params [required, String] :associated_resource_arn
+    #   The resource to which the attached file is (being) uploaded to.
+    #   [Cases][1] are the only current supported resource.
+    #
+    #   <note markdown="1"> This value must be a valid ARN.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.html
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.complete_attached_file_upload({
+    #     instance_id: "InstanceId", # required
+    #     file_id: "FileId", # required
+    #     associated_resource_arn: "ARN", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/CompleteAttachedFileUpload AWS API Documentation
+    #
+    # @overload complete_attached_file_upload(params = {})
+    # @param [Hash] params ({})
+    def complete_attached_file_upload(params = {}, options = {})
+      req = build_request(:complete_attached_file_upload, params)
+      req.send_request(options)
+    end
+
     # This API is in preview release for Amazon Connect and is subject to
     # change.
     #
@@ -3522,6 +3650,48 @@ module Aws::Connect
       req.send_request(options)
     end
 
+    # Deletes an attached file along with the underlying S3 Object.
+    #
+    # The attached file is **permanently deleted** if S3 bucket versioning
+    # is not enabled.
+    #
+    # @option params [required, String] :instance_id
+    #   The unique identifier of the Connect instance.
+    #
+    # @option params [required, String] :file_id
+    #   The unique identifier of the attached file resource.
+    #
+    # @option params [required, String] :associated_resource_arn
+    #   The resource to which the attached file is (being) uploaded to.
+    #   [Cases][1] are the only current supported resource.
+    #
+    #   <note markdown="1"> This value must be a valid ARN.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.html
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_attached_file({
+    #     instance_id: "InstanceId", # required
+    #     file_id: "FileId", # required
+    #     associated_resource_arn: "ARN", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/DeleteAttachedFile AWS API Documentation
+    #
+    # @overload delete_attached_file(params = {})
+    # @param [Hash] params ({})
+    def delete_attached_file(params = {}, options = {})
+      req = build_request(:delete_attached_file, params)
+      req.send_request(options)
+    end
+
     # Deletes a contact evaluation in the specified Amazon Connect instance.
     #
     # @option params [required, String] :instance_id
@@ -6184,6 +6354,80 @@ module Aws::Connect
       req.send_request(options)
     end
 
+    # Provides a pre-signed URL for download of an approved attached file.
+    # This API also returns metadata about the attached file. It will only
+    # return a downloadURL if the status of the attached file is `APPROVED`.
+    #
+    # @option params [required, String] :instance_id
+    #   The unique identifier of the Connect instance.
+    #
+    # @option params [required, String] :file_id
+    #   The unique identifier of the attached file resource.
+    #
+    # @option params [Integer] :url_expiry_in_seconds
+    #   Optional override for the expiry of the pre-signed S3 URL in seconds.
+    #
+    # @option params [required, String] :associated_resource_arn
+    #   The resource to which the attached file is (being) uploaded to.
+    #   [Cases][1] are the only current supported resource.
+    #
+    #   <note markdown="1"> This value must be a valid ARN.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.html
+    #
+    # @return [Types::GetAttachedFileResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetAttachedFileResponse#file_arn #file_arn} => String
+    #   * {Types::GetAttachedFileResponse#file_id #file_id} => String
+    #   * {Types::GetAttachedFileResponse#creation_time #creation_time} => String
+    #   * {Types::GetAttachedFileResponse#file_status #file_status} => String
+    #   * {Types::GetAttachedFileResponse#file_name #file_name} => String
+    #   * {Types::GetAttachedFileResponse#file_size_in_bytes #file_size_in_bytes} => Integer
+    #   * {Types::GetAttachedFileResponse#associated_resource_arn #associated_resource_arn} => String
+    #   * {Types::GetAttachedFileResponse#file_use_case_type #file_use_case_type} => String
+    #   * {Types::GetAttachedFileResponse#created_by #created_by} => Types::CreatedByInfo
+    #   * {Types::GetAttachedFileResponse#download_url_metadata #download_url_metadata} => Types::DownloadUrlMetadata
+    #   * {Types::GetAttachedFileResponse#tags #tags} => Hash&lt;String,String&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_attached_file({
+    #     instance_id: "InstanceId", # required
+    #     file_id: "FileId", # required
+    #     url_expiry_in_seconds: 1,
+    #     associated_resource_arn: "ARN", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.file_arn #=> String
+    #   resp.file_id #=> String
+    #   resp.creation_time #=> String
+    #   resp.file_status #=> String, one of "APPROVED", "REJECTED", "PROCESSING", "FAILED"
+    #   resp.file_name #=> String
+    #   resp.file_size_in_bytes #=> Integer
+    #   resp.associated_resource_arn #=> String
+    #   resp.file_use_case_type #=> String, one of "ATTACHMENT"
+    #   resp.created_by.connect_user_arn #=> String
+    #   resp.created_by.aws_identity_arn #=> String
+    #   resp.download_url_metadata.url #=> String
+    #   resp.download_url_metadata.url_expiry #=> String
+    #   resp.tags #=> Hash
+    #   resp.tags["TagKey"] #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/GetAttachedFile AWS API Documentation
+    #
+    # @overload get_attached_file(params = {})
+    # @param [Hash] params ({})
+    def get_attached_file(params = {}, options = {})
+      req = build_request(:get_attached_file, params)
+      req.send_request(options)
+    end
+
     # Retrieves the contact attributes for the specified contact.
     #
     # @option params [required, String] :instance_id
@@ -7375,7 +7619,7 @@ module Aws::Connect
     #     Valid groupings and filters: Queue, Channel, Routing Profile, Agent,
     #     Agent Hierarchy, contact/segmentAttributes/connect:Subtype
     #
-    #     UI name: [Average greeting time agent ][21]
+    #     UI name: [Average agent greeting time][21]
     #
     #   AVG\_HANDLE\_TIME
     #
@@ -7460,7 +7704,7 @@ module Aws::Connect
     #     Valid groupings and filters: Queue, Channel, Routing Profile, Agent,
     #     Agent Hierarchy, contact/segmentAttributes/connect:Subtype
     #
-    #     UI name: [Average interruptions agent ][28]
+    #     UI name: [Average agent interruptions][28]
     #
     #   AVG\_INTERRUPTION\_TIME\_AGENT
     #
@@ -7472,7 +7716,7 @@ module Aws::Connect
     #     Valid groupings and filters: Queue, Channel, Routing Profile, Agent,
     #     Agent Hierarchy, contact/segmentAttributes/connect:Subtype
     #
-    #     UI name: [Average interruption time agent][29]
+    #     UI name: [Average agent interruption time][29]
     #
     #   AVG\_NON\_TALK\_TIME
     #
@@ -7530,7 +7774,7 @@ module Aws::Connect
     #     Valid groupings and filters: Queue, Channel, Routing Profile, Agent,
     #     Agent Hierarchy, contact/segmentAttributes/connect:Subtype
     #
-    #     UI name: [Average talk time agent][34]
+    #     UI name: [Average agent talk time][34]
     #
     #   AVG\_TALK\_TIME\_CUSTOMER
     #
@@ -7542,7 +7786,7 @@ module Aws::Connect
     #     Valid groupings and filters: Queue, Channel, Routing Profile, Agent,
     #     Agent Hierarchy, contact/segmentAttributes/connect:Subtype
     #
-    #     UI name: [Average talk time customer][35]
+    #     UI name: [Average customer talk time][35]
     #
     #   CASES\_CREATED
     #
@@ -7604,7 +7848,7 @@ module Aws::Connect
     #     Valid groupings and filters: Queue, Channel, Agent, Agent Hierarchy,
     #     contact/segmentAttributes/connect:Subtype
     #
-    #     UI name: [Contacts handled by Connected to agent][40]
+    #     UI name: [Contacts handled (connected to agent timestamp)][40]
     #
     #   CONTACTS\_HOLD\_ABANDONS
     #
@@ -7676,7 +7920,7 @@ module Aws::Connect
     #     Valid groupings and filters: Queue, Channel, Agent, Agent Hierarchy,
     #     contact/segmentAttributes/connect:Subtype
     #
-    #     UI name: [Contacts queued by Enqueue][46]
+    #     UI name: [Contacts queued (enqueue timestamp)][46]
     #
     #   CONTACTS\_RESOLVED\_IN\_X
     #
@@ -7801,7 +8045,7 @@ module Aws::Connect
     #     Valid groupings and filters: Queue, Channel, Routing Profile, Agent,
     #     Agent Hierarchy, contact/segmentAttributes/connect:Subtype
     #
-    #     UI name: [Talk time agent percent][55]
+    #     UI name: [Agent talk time percent][55]
     #
     #   PERCENT\_TALK\_TIME\_CUSTOMER
     #
@@ -7813,7 +8057,7 @@ module Aws::Connect
     #     Valid groupings and filters: Queue, Channel, Routing Profile, Agent,
     #     Agent Hierarchy, contact/segmentAttributes/connect:Subtype
     #
-    #     UI name: [Talk time customer percent][56]
+    #     UI name: [Customer talk time percent][56]
     #
     #   REOPENED\_CASE\_ACTIONS
     #
@@ -12767,6 +13011,113 @@ module Aws::Connect
       req.send_request(options)
     end
 
+    # Provides a pre-signed Amazon S3 URL in response for uploading your
+    # content.
+    #
+    # You may only use this API to upload attachments to a [Connect
+    # Case][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.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 unique identifier of the Connect instance.
+    #
+    # @option params [required, String] :file_name
+    #   A case-sensitive name of the attached file being uploaded.
+    #
+    # @option params [required, Integer] :file_size_in_bytes
+    #   The size of the attached file in bytes.
+    #
+    # @option params [Integer] :url_expiry_in_seconds
+    #   Optional override for the expiry of the pre-signed S3 URL in seconds.
+    #
+    # @option params [required, String] :file_use_case_type
+    #   The use case for the file.
+    #
+    # @option params [required, String] :associated_resource_arn
+    #   The resource to which the attached file is (being) uploaded to.
+    #   [Cases][1] are the only current supported resource.
+    #
+    #   <note markdown="1"> This value must be a valid ARN.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.html
+    #
+    # @option params [Types::CreatedByInfo] :created_by
+    #   Represents the identity that created the file.
+    #
+    # @option params [Hash<String,String>] :tags
+    #   The tags used to organize, track, or control access for this resource.
+    #   For example, `\{ "Tags": \{"key1":"value1", "key2":"value2"\} \}`.
+    #
+    # @return [Types::StartAttachedFileUploadResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StartAttachedFileUploadResponse#file_arn #file_arn} => String
+    #   * {Types::StartAttachedFileUploadResponse#file_id #file_id} => String
+    #   * {Types::StartAttachedFileUploadResponse#creation_time #creation_time} => String
+    #   * {Types::StartAttachedFileUploadResponse#file_status #file_status} => String
+    #   * {Types::StartAttachedFileUploadResponse#created_by #created_by} => Types::CreatedByInfo
+    #   * {Types::StartAttachedFileUploadResponse#upload_url_metadata #upload_url_metadata} => Types::UploadUrlMetadata
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.start_attached_file_upload({
+    #     client_token: "ClientToken",
+    #     instance_id: "InstanceId", # required
+    #     file_name: "FileName", # required
+    #     file_size_in_bytes: 1, # required
+    #     url_expiry_in_seconds: 1,
+    #     file_use_case_type: "ATTACHMENT", # required, accepts ATTACHMENT
+    #     associated_resource_arn: "ARN", # required
+    #     created_by: {
+    #       connect_user_arn: "ARN",
+    #       aws_identity_arn: "ARN",
+    #     },
+    #     tags: {
+    #       "TagKey" => "TagValue",
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.file_arn #=> String
+    #   resp.file_id #=> String
+    #   resp.creation_time #=> String
+    #   resp.file_status #=> String, one of "APPROVED", "REJECTED", "PROCESSING", "FAILED"
+    #   resp.created_by.connect_user_arn #=> String
+    #   resp.created_by.aws_identity_arn #=> String
+    #   resp.upload_url_metadata.url #=> String
+    #   resp.upload_url_metadata.url_expiry #=> String
+    #   resp.upload_url_metadata.headers_to_include #=> Hash
+    #   resp.upload_url_metadata.headers_to_include["UrlMetadataSignedHeadersKey"] #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/StartAttachedFileUpload AWS API Documentation
+    #
+    # @overload start_attached_file_upload(params = {})
+    # @param [Hash] params ({})
+    def start_attached_file_upload(params = {}, options = {})
+      req = build_request(:start_attached_file_upload, params)
+      req.send_request(options)
+    end
+
     # Initiates a flow to start a new chat for the customer. Response of
     # this API provides a token required to obtain credentials from the
     # [CreateParticipantConnection][1] API in the Amazon Connect Participant
@@ -14290,6 +14641,23 @@ module Aws::Connect
     #   contact. Attribute keys can include only alphanumeric, dash, and
     #   underscore characters.
     #
+    #   When the attributes for a contact exceed 32 KB, the contact is routed
+    #   down the Error branch of the flow. As a mitigation, consider the
+    #   following options:
+    #
+    #   * Remove unnecessary attributes by setting their values to empty.
+    #
+    #   * If the attributes are only used in one flow and don't need to be
+    #     referred to outside of that flow (for example, by a Lambda or
+    #     another flow), then use flow attributes. This way you aren't
+    #     needlessly persisting the 32 KB of information from one flow to
+    #     another. For more information, see [Flow block: Set contact
+    #     attributes][1] in the *Amazon Connect Administrator Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/connect/latest/adminguide/set-contact-attributes.html
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -16682,7 +17050,7 @@ module Aws::Connect
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-connect'
-      context[:gem_version] = '1.154.0'
+      context[:gem_version] = '1.156.0'
       Seahorse::Client::Request.new(handlers, context)
     end