aws-sdk-connect 1.154.0 → 1.156.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 537858dd9ff5dcc5e8cb05e021ce0ff0edcb9c7ed3cae299b394c4243b16681b
4
- data.tar.gz: 27e83ba1f4ac0176d4c3a0a15a3d2b8e381e1ce40b70a34f91b54c7d4c739f79
3
+ metadata.gz: 75320558d9a289ed2c5aab965fe6f0205c3e443847b886777c508861feb18017
4
+ data.tar.gz: abe7ed35c501ab8af8b862b4bd9d2c48e8487ca98ff193893f29142e3dcc7779
5
5
  SHA512:
6
- metadata.gz: cc1241c87f65f5ae37120f6d4ab79d7e371c5b304e6e70fbb3f49699c210ba7339c778577db9059b021139b43a6342aef1654f064eed066a639419402205115f
7
- data.tar.gz: 6fb480cabf18ae43e11a90c27b746c49087a83fb310006c87737ffa02e8091db126c9acb4e827a1f644f2789e8e3e5b336da2bbcff3b54d31121433da8df30af
6
+ metadata.gz: 1ca72ac9c903c4079b4c25a0c6d0d019f865d3d7cbf0649fa96445ac0a86f5a3ffda86f7f65becbb1ca68fe3643143047bc047d1d1ac5fc3e51f8eb280aa26d3
7
+ data.tar.gz: f78a7f380ff91a6e41003b3cb6a33e4cc2e22d58e228e39d4119d856d4553a79401e084e0c898c5932bfdcf48c3c5d2b42a77a733caccb301111a7413e567cb1
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.156.0 (2024-05-03)
5
+ ------------------
6
+
7
+ * 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.
8
+
9
+ 1.155.0 (2024-04-25)
10
+ ------------------
11
+
12
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
13
+
4
14
  1.154.0 (2024-04-10)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.154.0
1
+ 1.156.0
@@ -22,6 +22,7 @@ require 'aws-sdk-core/plugins/endpoint_pattern.rb'
22
22
  require 'aws-sdk-core/plugins/response_paging.rb'
23
23
  require 'aws-sdk-core/plugins/stub_responses.rb'
24
24
  require 'aws-sdk-core/plugins/idempotency_token.rb'
25
+ require 'aws-sdk-core/plugins/invocation_id.rb'
25
26
  require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
26
27
  require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
27
28
  require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
@@ -72,6 +73,7 @@ module Aws::Connect
72
73
  add_plugin(Aws::Plugins::ResponsePaging)
73
74
  add_plugin(Aws::Plugins::StubResponses)
74
75
  add_plugin(Aws::Plugins::IdempotencyToken)
76
+ add_plugin(Aws::Plugins::InvocationId)
75
77
  add_plugin(Aws::Plugins::JsonvalueConverter)
76
78
  add_plugin(Aws::Plugins::ClientMetricsPlugin)
77
79
  add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
@@ -196,10 +198,17 @@ module Aws::Connect
196
198
  # When set to 'true' the request body will not be compressed
197
199
  # for supported operations.
198
200
  #
199
- # @option options [String] :endpoint
200
- # The client endpoint is normally constructed from the `:region`
201
- # option. You should only configure an `:endpoint` when connecting
202
- # to test or custom endpoints. This should be a valid HTTP(S) URI.
201
+ # @option options [String, URI::HTTPS, URI::HTTP] :endpoint
202
+ # Normally you should not configure the `:endpoint` option
203
+ # directly. This is normally constructed from the `:region`
204
+ # option. Configuring `:endpoint` is normally reserved for
205
+ # connecting to test or custom endpoints. The endpoint should
206
+ # be a URI formatted like:
207
+ #
208
+ # 'http://example.com'
209
+ # 'https://example.com'
210
+ # 'http://example.com:123'
211
+ #
203
212
  #
204
213
  # @option options [Integer] :endpoint_cache_max_entries (1000)
205
214
  # Used for the maximum size limit of the LRU cache storing endpoints data
@@ -337,50 +346,65 @@ module Aws::Connect
337
346
  # @option options [Aws::Connect::EndpointProvider] :endpoint_provider
338
347
  # 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`
339
348
  #
340
- # @option options [URI::HTTP,String] :http_proxy A proxy to send
341
- # requests through. Formatted like 'http://proxy.com:123'.
342
- #
343
- # @option options [Float] :http_open_timeout (15) The number of
344
- # seconds to wait when opening a HTTP session before raising a
345
- # `Timeout::Error`.
346
- #
347
- # @option options [Float] :http_read_timeout (60) The default
348
- # number of seconds to wait for response data. This value can
349
- # safely be set per-request on the session.
350
- #
351
- # @option options [Float] :http_idle_timeout (5) The number of
352
- # seconds a connection is allowed to sit idle before it is
353
- # considered stale. Stale connections are closed and removed
354
- # from the pool before making a request.
355
- #
356
- # @option options [Float] :http_continue_timeout (1) The number of
357
- # seconds to wait for a 100-continue response before sending the
358
- # request body. This option has no effect unless the request has
359
- # "Expect" header set to "100-continue". Defaults to `nil` which
360
- # disables this behaviour. This value can safely be set per
361
- # request on the session.
362
- #
363
- # @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
364
- # in seconds.
365
- #
366
- # @option options [Boolean] :http_wire_trace (false) When `true`,
367
- # HTTP debug output will be sent to the `:logger`.
349
+ # @option options [Float] :http_continue_timeout (1)
350
+ # The number of seconds to wait for a 100-continue response before sending the
351
+ # request body. This option has no effect unless the request has "Expect"
352
+ # header set to "100-continue". Defaults to `nil` which disables this
353
+ # behaviour. This value can safely be set per request on the session.
354
+ #
355
+ # @option options [Float] :http_idle_timeout (5)
356
+ # The number of seconds a connection is allowed to sit idle before it
357
+ # is considered stale. Stale connections are closed and removed from the
358
+ # pool before making a request.
359
+ #
360
+ # @option options [Float] :http_open_timeout (15)
361
+ # The default number of seconds to wait for response data.
362
+ # This value can safely be set per-request on the session.
363
+ #
364
+ # @option options [URI::HTTP,String] :http_proxy
365
+ # A proxy to send requests through. Formatted like 'http://proxy.com:123'.
366
+ #
367
+ # @option options [Float] :http_read_timeout (60)
368
+ # The default number of seconds to wait for response data.
369
+ # This value can safely be set per-request on the session.
370
+ #
371
+ # @option options [Boolean] :http_wire_trace (false)
372
+ # When `true`, HTTP debug output will be sent to the `:logger`.
373
+ #
374
+ # @option options [Proc] :on_chunk_received
375
+ # When a Proc object is provided, it will be used as callback when each chunk
376
+ # of the response body is received. It provides three arguments: the chunk,
377
+ # the number of bytes received, and the total number of
378
+ # bytes in the response (or nil if the server did not send a `content-length`).
379
+ #
380
+ # @option options [Proc] :on_chunk_sent
381
+ # When a Proc object is provided, it will be used as callback when each chunk
382
+ # of the request body is sent. It provides three arguments: the chunk,
383
+ # the number of bytes read from the body, and the total number of
384
+ # bytes in the body.
385
+ #
386
+ # @option options [Boolean] :raise_response_errors (true)
387
+ # When `true`, response errors are raised.
388
+ #
389
+ # @option options [String] :ssl_ca_bundle
390
+ # Full path to the SSL certificate authority bundle file that should be used when
391
+ # verifying peer certificates. If you do not pass `:ssl_ca_bundle` or
392
+ # `:ssl_ca_directory` the the system default will be used if available.
393
+ #
394
+ # @option options [String] :ssl_ca_directory
395
+ # Full path of the directory that contains the unbundled SSL certificate
396
+ # authority files for verifying peer certificates. If you do
397
+ # not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the system
398
+ # default will be used if available.
368
399
  #
369
- # @option options [Boolean] :ssl_verify_peer (true) When `true`,
370
- # SSL peer certificates are verified when establishing a
371
- # connection.
400
+ # @option options [String] :ssl_ca_store
401
+ # Sets the X509::Store to verify peer certificate.
372
402
  #
373
- # @option options [String] :ssl_ca_bundle Full path to the SSL
374
- # certificate authority bundle file that should be used when
375
- # verifying peer certificates. If you do not pass
376
- # `:ssl_ca_bundle` or `:ssl_ca_directory` the the system default
377
- # will be used if available.
403
+ # @option options [Float] :ssl_timeout
404
+ # Sets the SSL timeout in seconds
378
405
  #
379
- # @option options [String] :ssl_ca_directory Full path of the
380
- # directory that contains the unbundled SSL certificate
381
- # authority files for verifying peer certificates. If you do
382
- # not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the
383
- # system default will be used if available.
406
+ # @option options [Boolean] :ssl_verify_peer (true)
407
+ # When `true`, SSL peer certificates are verified when establishing a connection.
384
408
  #
385
409
  def initialize(*args)
386
410
  super
@@ -1181,6 +1205,70 @@ module Aws::Connect
1181
1205
  req.send_request(options)
1182
1206
  end
1183
1207
 
1208
+ # Allows you to retrieve metadata about multiple attached files on an
1209
+ # associated resource. Each attached file provided in the input list
1210
+ # must be associated with the input AssociatedResourceArn.
1211
+ #
1212
+ # @option params [required, Array<String>] :file_ids
1213
+ # The unique identifiers of the attached file resource.
1214
+ #
1215
+ # @option params [required, String] :instance_id
1216
+ # The unique identifier of the Connect instance.
1217
+ #
1218
+ # @option params [required, String] :associated_resource_arn
1219
+ # The resource to which the attached file is (being) uploaded to.
1220
+ # [Cases][1] are the only current supported resource.
1221
+ #
1222
+ # <note markdown="1"> This value must be a valid ARN.
1223
+ #
1224
+ # </note>
1225
+ #
1226
+ #
1227
+ #
1228
+ # [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.html
1229
+ #
1230
+ # @return [Types::BatchGetAttachedFileMetadataResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1231
+ #
1232
+ # * {Types::BatchGetAttachedFileMetadataResponse#files #files} => Array&lt;Types::AttachedFile&gt;
1233
+ # * {Types::BatchGetAttachedFileMetadataResponse#errors #errors} => Array&lt;Types::AttachedFileError&gt;
1234
+ #
1235
+ # @example Request syntax with placeholder values
1236
+ #
1237
+ # resp = client.batch_get_attached_file_metadata({
1238
+ # file_ids: ["FileId"], # required
1239
+ # instance_id: "InstanceId", # required
1240
+ # associated_resource_arn: "ARN", # required
1241
+ # })
1242
+ #
1243
+ # @example Response structure
1244
+ #
1245
+ # resp.files #=> Array
1246
+ # resp.files[0].creation_time #=> String
1247
+ # resp.files[0].file_arn #=> String
1248
+ # resp.files[0].file_id #=> String
1249
+ # resp.files[0].file_name #=> String
1250
+ # resp.files[0].file_size_in_bytes #=> Integer
1251
+ # resp.files[0].file_status #=> String, one of "APPROVED", "REJECTED", "PROCESSING", "FAILED"
1252
+ # resp.files[0].created_by.connect_user_arn #=> String
1253
+ # resp.files[0].created_by.aws_identity_arn #=> String
1254
+ # resp.files[0].file_use_case_type #=> String, one of "ATTACHMENT"
1255
+ # resp.files[0].associated_resource_arn #=> String
1256
+ # resp.files[0].tags #=> Hash
1257
+ # resp.files[0].tags["TagKey"] #=> String
1258
+ # resp.errors #=> Array
1259
+ # resp.errors[0].error_code #=> String
1260
+ # resp.errors[0].error_message #=> String
1261
+ # resp.errors[0].file_id #=> String
1262
+ #
1263
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/BatchGetAttachedFileMetadata AWS API Documentation
1264
+ #
1265
+ # @overload batch_get_attached_file_metadata(params = {})
1266
+ # @param [Hash] params ({})
1267
+ def batch_get_attached_file_metadata(params = {}, options = {})
1268
+ req = build_request(:batch_get_attached_file_metadata, params)
1269
+ req.send_request(options)
1270
+ end
1271
+
1184
1272
  # Retrieve the flow associations for the given resources.
1185
1273
  #
1186
1274
  # @option params [required, String] :instance_id
@@ -1432,6 +1520,46 @@ module Aws::Connect
1432
1520
  req.send_request(options)
1433
1521
  end
1434
1522
 
1523
+ # Allows you to confirm that the attached file has been uploaded using
1524
+ # the pre-signed URL provided in the StartAttachedFileUpload API.
1525
+ #
1526
+ # @option params [required, String] :instance_id
1527
+ # The unique identifier of the Connect instance.
1528
+ #
1529
+ # @option params [required, String] :file_id
1530
+ # The unique identifier of the attached file resource.
1531
+ #
1532
+ # @option params [required, String] :associated_resource_arn
1533
+ # The resource to which the attached file is (being) uploaded to.
1534
+ # [Cases][1] are the only current supported resource.
1535
+ #
1536
+ # <note markdown="1"> This value must be a valid ARN.
1537
+ #
1538
+ # </note>
1539
+ #
1540
+ #
1541
+ #
1542
+ # [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.html
1543
+ #
1544
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1545
+ #
1546
+ # @example Request syntax with placeholder values
1547
+ #
1548
+ # resp = client.complete_attached_file_upload({
1549
+ # instance_id: "InstanceId", # required
1550
+ # file_id: "FileId", # required
1551
+ # associated_resource_arn: "ARN", # required
1552
+ # })
1553
+ #
1554
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/CompleteAttachedFileUpload AWS API Documentation
1555
+ #
1556
+ # @overload complete_attached_file_upload(params = {})
1557
+ # @param [Hash] params ({})
1558
+ def complete_attached_file_upload(params = {}, options = {})
1559
+ req = build_request(:complete_attached_file_upload, params)
1560
+ req.send_request(options)
1561
+ end
1562
+
1435
1563
  # This API is in preview release for Amazon Connect and is subject to
1436
1564
  # change.
1437
1565
  #
@@ -3522,6 +3650,48 @@ module Aws::Connect
3522
3650
  req.send_request(options)
3523
3651
  end
3524
3652
 
3653
+ # Deletes an attached file along with the underlying S3 Object.
3654
+ #
3655
+ # The attached file is **permanently deleted** if S3 bucket versioning
3656
+ # is not enabled.
3657
+ #
3658
+ # @option params [required, String] :instance_id
3659
+ # The unique identifier of the Connect instance.
3660
+ #
3661
+ # @option params [required, String] :file_id
3662
+ # The unique identifier of the attached file resource.
3663
+ #
3664
+ # @option params [required, String] :associated_resource_arn
3665
+ # The resource to which the attached file is (being) uploaded to.
3666
+ # [Cases][1] are the only current supported resource.
3667
+ #
3668
+ # <note markdown="1"> This value must be a valid ARN.
3669
+ #
3670
+ # </note>
3671
+ #
3672
+ #
3673
+ #
3674
+ # [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.html
3675
+ #
3676
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3677
+ #
3678
+ # @example Request syntax with placeholder values
3679
+ #
3680
+ # resp = client.delete_attached_file({
3681
+ # instance_id: "InstanceId", # required
3682
+ # file_id: "FileId", # required
3683
+ # associated_resource_arn: "ARN", # required
3684
+ # })
3685
+ #
3686
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/DeleteAttachedFile AWS API Documentation
3687
+ #
3688
+ # @overload delete_attached_file(params = {})
3689
+ # @param [Hash] params ({})
3690
+ def delete_attached_file(params = {}, options = {})
3691
+ req = build_request(:delete_attached_file, params)
3692
+ req.send_request(options)
3693
+ end
3694
+
3525
3695
  # Deletes a contact evaluation in the specified Amazon Connect instance.
3526
3696
  #
3527
3697
  # @option params [required, String] :instance_id
@@ -6184,6 +6354,80 @@ module Aws::Connect
6184
6354
  req.send_request(options)
6185
6355
  end
6186
6356
 
6357
+ # Provides a pre-signed URL for download of an approved attached file.
6358
+ # This API also returns metadata about the attached file. It will only
6359
+ # return a downloadURL if the status of the attached file is `APPROVED`.
6360
+ #
6361
+ # @option params [required, String] :instance_id
6362
+ # The unique identifier of the Connect instance.
6363
+ #
6364
+ # @option params [required, String] :file_id
6365
+ # The unique identifier of the attached file resource.
6366
+ #
6367
+ # @option params [Integer] :url_expiry_in_seconds
6368
+ # Optional override for the expiry of the pre-signed S3 URL in seconds.
6369
+ #
6370
+ # @option params [required, String] :associated_resource_arn
6371
+ # The resource to which the attached file is (being) uploaded to.
6372
+ # [Cases][1] are the only current supported resource.
6373
+ #
6374
+ # <note markdown="1"> This value must be a valid ARN.
6375
+ #
6376
+ # </note>
6377
+ #
6378
+ #
6379
+ #
6380
+ # [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.html
6381
+ #
6382
+ # @return [Types::GetAttachedFileResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6383
+ #
6384
+ # * {Types::GetAttachedFileResponse#file_arn #file_arn} => String
6385
+ # * {Types::GetAttachedFileResponse#file_id #file_id} => String
6386
+ # * {Types::GetAttachedFileResponse#creation_time #creation_time} => String
6387
+ # * {Types::GetAttachedFileResponse#file_status #file_status} => String
6388
+ # * {Types::GetAttachedFileResponse#file_name #file_name} => String
6389
+ # * {Types::GetAttachedFileResponse#file_size_in_bytes #file_size_in_bytes} => Integer
6390
+ # * {Types::GetAttachedFileResponse#associated_resource_arn #associated_resource_arn} => String
6391
+ # * {Types::GetAttachedFileResponse#file_use_case_type #file_use_case_type} => String
6392
+ # * {Types::GetAttachedFileResponse#created_by #created_by} => Types::CreatedByInfo
6393
+ # * {Types::GetAttachedFileResponse#download_url_metadata #download_url_metadata} => Types::DownloadUrlMetadata
6394
+ # * {Types::GetAttachedFileResponse#tags #tags} => Hash&lt;String,String&gt;
6395
+ #
6396
+ # @example Request syntax with placeholder values
6397
+ #
6398
+ # resp = client.get_attached_file({
6399
+ # instance_id: "InstanceId", # required
6400
+ # file_id: "FileId", # required
6401
+ # url_expiry_in_seconds: 1,
6402
+ # associated_resource_arn: "ARN", # required
6403
+ # })
6404
+ #
6405
+ # @example Response structure
6406
+ #
6407
+ # resp.file_arn #=> String
6408
+ # resp.file_id #=> String
6409
+ # resp.creation_time #=> String
6410
+ # resp.file_status #=> String, one of "APPROVED", "REJECTED", "PROCESSING", "FAILED"
6411
+ # resp.file_name #=> String
6412
+ # resp.file_size_in_bytes #=> Integer
6413
+ # resp.associated_resource_arn #=> String
6414
+ # resp.file_use_case_type #=> String, one of "ATTACHMENT"
6415
+ # resp.created_by.connect_user_arn #=> String
6416
+ # resp.created_by.aws_identity_arn #=> String
6417
+ # resp.download_url_metadata.url #=> String
6418
+ # resp.download_url_metadata.url_expiry #=> String
6419
+ # resp.tags #=> Hash
6420
+ # resp.tags["TagKey"] #=> String
6421
+ #
6422
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/GetAttachedFile AWS API Documentation
6423
+ #
6424
+ # @overload get_attached_file(params = {})
6425
+ # @param [Hash] params ({})
6426
+ def get_attached_file(params = {}, options = {})
6427
+ req = build_request(:get_attached_file, params)
6428
+ req.send_request(options)
6429
+ end
6430
+
6187
6431
  # Retrieves the contact attributes for the specified contact.
6188
6432
  #
6189
6433
  # @option params [required, String] :instance_id
@@ -7375,7 +7619,7 @@ module Aws::Connect
7375
7619
  # Valid groupings and filters: Queue, Channel, Routing Profile, Agent,
7376
7620
  # Agent Hierarchy, contact/segmentAttributes/connect:Subtype
7377
7621
  #
7378
- # UI name: [Average greeting time agent ][21]
7622
+ # UI name: [Average agent greeting time][21]
7379
7623
  #
7380
7624
  # AVG\_HANDLE\_TIME
7381
7625
  #
@@ -7460,7 +7704,7 @@ module Aws::Connect
7460
7704
  # Valid groupings and filters: Queue, Channel, Routing Profile, Agent,
7461
7705
  # Agent Hierarchy, contact/segmentAttributes/connect:Subtype
7462
7706
  #
7463
- # UI name: [Average interruptions agent ][28]
7707
+ # UI name: [Average agent interruptions][28]
7464
7708
  #
7465
7709
  # AVG\_INTERRUPTION\_TIME\_AGENT
7466
7710
  #
@@ -7472,7 +7716,7 @@ module Aws::Connect
7472
7716
  # Valid groupings and filters: Queue, Channel, Routing Profile, Agent,
7473
7717
  # Agent Hierarchy, contact/segmentAttributes/connect:Subtype
7474
7718
  #
7475
- # UI name: [Average interruption time agent][29]
7719
+ # UI name: [Average agent interruption time][29]
7476
7720
  #
7477
7721
  # AVG\_NON\_TALK\_TIME
7478
7722
  #
@@ -7530,7 +7774,7 @@ module Aws::Connect
7530
7774
  # Valid groupings and filters: Queue, Channel, Routing Profile, Agent,
7531
7775
  # Agent Hierarchy, contact/segmentAttributes/connect:Subtype
7532
7776
  #
7533
- # UI name: [Average talk time agent][34]
7777
+ # UI name: [Average agent talk time][34]
7534
7778
  #
7535
7779
  # AVG\_TALK\_TIME\_CUSTOMER
7536
7780
  #
@@ -7542,7 +7786,7 @@ module Aws::Connect
7542
7786
  # Valid groupings and filters: Queue, Channel, Routing Profile, Agent,
7543
7787
  # Agent Hierarchy, contact/segmentAttributes/connect:Subtype
7544
7788
  #
7545
- # UI name: [Average talk time customer][35]
7789
+ # UI name: [Average customer talk time][35]
7546
7790
  #
7547
7791
  # CASES\_CREATED
7548
7792
  #
@@ -7604,7 +7848,7 @@ module Aws::Connect
7604
7848
  # Valid groupings and filters: Queue, Channel, Agent, Agent Hierarchy,
7605
7849
  # contact/segmentAttributes/connect:Subtype
7606
7850
  #
7607
- # UI name: [Contacts handled by Connected to agent][40]
7851
+ # UI name: [Contacts handled (connected to agent timestamp)][40]
7608
7852
  #
7609
7853
  # CONTACTS\_HOLD\_ABANDONS
7610
7854
  #
@@ -7676,7 +7920,7 @@ module Aws::Connect
7676
7920
  # Valid groupings and filters: Queue, Channel, Agent, Agent Hierarchy,
7677
7921
  # contact/segmentAttributes/connect:Subtype
7678
7922
  #
7679
- # UI name: [Contacts queued by Enqueue][46]
7923
+ # UI name: [Contacts queued (enqueue timestamp)][46]
7680
7924
  #
7681
7925
  # CONTACTS\_RESOLVED\_IN\_X
7682
7926
  #
@@ -7801,7 +8045,7 @@ module Aws::Connect
7801
8045
  # Valid groupings and filters: Queue, Channel, Routing Profile, Agent,
7802
8046
  # Agent Hierarchy, contact/segmentAttributes/connect:Subtype
7803
8047
  #
7804
- # UI name: [Talk time agent percent][55]
8048
+ # UI name: [Agent talk time percent][55]
7805
8049
  #
7806
8050
  # PERCENT\_TALK\_TIME\_CUSTOMER
7807
8051
  #
@@ -7813,7 +8057,7 @@ module Aws::Connect
7813
8057
  # Valid groupings and filters: Queue, Channel, Routing Profile, Agent,
7814
8058
  # Agent Hierarchy, contact/segmentAttributes/connect:Subtype
7815
8059
  #
7816
- # UI name: [Talk time customer percent][56]
8060
+ # UI name: [Customer talk time percent][56]
7817
8061
  #
7818
8062
  # REOPENED\_CASE\_ACTIONS
7819
8063
  #
@@ -12767,6 +13011,113 @@ module Aws::Connect
12767
13011
  req.send_request(options)
12768
13012
  end
12769
13013
 
13014
+ # Provides a pre-signed Amazon S3 URL in response for uploading your
13015
+ # content.
13016
+ #
13017
+ # You may only use this API to upload attachments to a [Connect
13018
+ # Case][1].
13019
+ #
13020
+ #
13021
+ #
13022
+ # [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.html
13023
+ #
13024
+ # @option params [String] :client_token
13025
+ # A unique, case-sensitive identifier that you provide to ensure the
13026
+ # idempotency of the request. If not provided, the Amazon Web Services
13027
+ # SDK populates this field. For more information about idempotency, see
13028
+ # [Making retries safe with idempotent APIs][1].
13029
+ #
13030
+ # **A suitable default value is auto-generated.** You should normally
13031
+ # not need to pass this option.**
13032
+ #
13033
+ #
13034
+ #
13035
+ # [1]: https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/
13036
+ #
13037
+ # @option params [required, String] :instance_id
13038
+ # The unique identifier of the Connect instance.
13039
+ #
13040
+ # @option params [required, String] :file_name
13041
+ # A case-sensitive name of the attached file being uploaded.
13042
+ #
13043
+ # @option params [required, Integer] :file_size_in_bytes
13044
+ # The size of the attached file in bytes.
13045
+ #
13046
+ # @option params [Integer] :url_expiry_in_seconds
13047
+ # Optional override for the expiry of the pre-signed S3 URL in seconds.
13048
+ #
13049
+ # @option params [required, String] :file_use_case_type
13050
+ # The use case for the file.
13051
+ #
13052
+ # @option params [required, String] :associated_resource_arn
13053
+ # The resource to which the attached file is (being) uploaded to.
13054
+ # [Cases][1] are the only current supported resource.
13055
+ #
13056
+ # <note markdown="1"> This value must be a valid ARN.
13057
+ #
13058
+ # </note>
13059
+ #
13060
+ #
13061
+ #
13062
+ # [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.html
13063
+ #
13064
+ # @option params [Types::CreatedByInfo] :created_by
13065
+ # Represents the identity that created the file.
13066
+ #
13067
+ # @option params [Hash<String,String>] :tags
13068
+ # The tags used to organize, track, or control access for this resource.
13069
+ # For example, `\{ "Tags": \{"key1":"value1", "key2":"value2"\} \}`.
13070
+ #
13071
+ # @return [Types::StartAttachedFileUploadResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
13072
+ #
13073
+ # * {Types::StartAttachedFileUploadResponse#file_arn #file_arn} => String
13074
+ # * {Types::StartAttachedFileUploadResponse#file_id #file_id} => String
13075
+ # * {Types::StartAttachedFileUploadResponse#creation_time #creation_time} => String
13076
+ # * {Types::StartAttachedFileUploadResponse#file_status #file_status} => String
13077
+ # * {Types::StartAttachedFileUploadResponse#created_by #created_by} => Types::CreatedByInfo
13078
+ # * {Types::StartAttachedFileUploadResponse#upload_url_metadata #upload_url_metadata} => Types::UploadUrlMetadata
13079
+ #
13080
+ # @example Request syntax with placeholder values
13081
+ #
13082
+ # resp = client.start_attached_file_upload({
13083
+ # client_token: "ClientToken",
13084
+ # instance_id: "InstanceId", # required
13085
+ # file_name: "FileName", # required
13086
+ # file_size_in_bytes: 1, # required
13087
+ # url_expiry_in_seconds: 1,
13088
+ # file_use_case_type: "ATTACHMENT", # required, accepts ATTACHMENT
13089
+ # associated_resource_arn: "ARN", # required
13090
+ # created_by: {
13091
+ # connect_user_arn: "ARN",
13092
+ # aws_identity_arn: "ARN",
13093
+ # },
13094
+ # tags: {
13095
+ # "TagKey" => "TagValue",
13096
+ # },
13097
+ # })
13098
+ #
13099
+ # @example Response structure
13100
+ #
13101
+ # resp.file_arn #=> String
13102
+ # resp.file_id #=> String
13103
+ # resp.creation_time #=> String
13104
+ # resp.file_status #=> String, one of "APPROVED", "REJECTED", "PROCESSING", "FAILED"
13105
+ # resp.created_by.connect_user_arn #=> String
13106
+ # resp.created_by.aws_identity_arn #=> String
13107
+ # resp.upload_url_metadata.url #=> String
13108
+ # resp.upload_url_metadata.url_expiry #=> String
13109
+ # resp.upload_url_metadata.headers_to_include #=> Hash
13110
+ # resp.upload_url_metadata.headers_to_include["UrlMetadataSignedHeadersKey"] #=> String
13111
+ #
13112
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/StartAttachedFileUpload AWS API Documentation
13113
+ #
13114
+ # @overload start_attached_file_upload(params = {})
13115
+ # @param [Hash] params ({})
13116
+ def start_attached_file_upload(params = {}, options = {})
13117
+ req = build_request(:start_attached_file_upload, params)
13118
+ req.send_request(options)
13119
+ end
13120
+
12770
13121
  # Initiates a flow to start a new chat for the customer. Response of
12771
13122
  # this API provides a token required to obtain credentials from the
12772
13123
  # [CreateParticipantConnection][1] API in the Amazon Connect Participant
@@ -14290,6 +14641,23 @@ module Aws::Connect
14290
14641
  # contact. Attribute keys can include only alphanumeric, dash, and
14291
14642
  # underscore characters.
14292
14643
  #
14644
+ # When the attributes for a contact exceed 32 KB, the contact is routed
14645
+ # down the Error branch of the flow. As a mitigation, consider the
14646
+ # following options:
14647
+ #
14648
+ # * Remove unnecessary attributes by setting their values to empty.
14649
+ #
14650
+ # * If the attributes are only used in one flow and don't need to be
14651
+ # referred to outside of that flow (for example, by a Lambda or
14652
+ # another flow), then use flow attributes. This way you aren't
14653
+ # needlessly persisting the 32 KB of information from one flow to
14654
+ # another. For more information, see [Flow block: Set contact
14655
+ # attributes][1] in the *Amazon Connect Administrator Guide*.
14656
+ #
14657
+ #
14658
+ #
14659
+ # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/set-contact-attributes.html
14660
+ #
14293
14661
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
14294
14662
  #
14295
14663
  # @example Request syntax with placeholder values
@@ -16682,7 +17050,7 @@ module Aws::Connect
16682
17050
  params: params,
16683
17051
  config: config)
16684
17052
  context[:gem_name] = 'aws-sdk-connect'
16685
- context[:gem_version] = '1.154.0'
17053
+ context[:gem_version] = '1.156.0'
16686
17054
  Seahorse::Client::Request.new(handlers, context)
16687
17055
  end
16688
17056