aws-sdk-connect 1.155.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.
@@ -923,6 +923,103 @@ module Aws::Connect
923
923
  include Aws::Structure
924
924
  end
925
925
 
926
+ # Information about the attached file.
927
+ #
928
+ # @!attribute [rw] creation_time
929
+ # The time of Creation of the file resource as an ISO timestamp. It's
930
+ # specified in ISO 8601 format: `yyyy-MM-ddThh:mm:ss.SSSZ`. For
931
+ # example, `2024-05-03T02:41:28.172Z`.
932
+ # @return [String]
933
+ #
934
+ # @!attribute [rw] file_arn
935
+ # The unique identifier of the attached file resource (ARN).
936
+ # @return [String]
937
+ #
938
+ # @!attribute [rw] file_id
939
+ # The unique identifier of the attached file resource.
940
+ # @return [String]
941
+ #
942
+ # @!attribute [rw] file_name
943
+ # A case-sensitive name of the attached file being uploaded.
944
+ # @return [String]
945
+ #
946
+ # @!attribute [rw] file_size_in_bytes
947
+ # The size of the attached file in bytes.
948
+ # @return [Integer]
949
+ #
950
+ # @!attribute [rw] file_status
951
+ # The current status of the attached file.
952
+ # @return [String]
953
+ #
954
+ # @!attribute [rw] created_by
955
+ # Represents the identity that created the file.
956
+ # @return [Types::CreatedByInfo]
957
+ #
958
+ # @!attribute [rw] file_use_case_type
959
+ # The use case for the file.
960
+ # @return [String]
961
+ #
962
+ # @!attribute [rw] associated_resource_arn
963
+ # The resource to which the attached file is (being) uploaded to.
964
+ # [Cases][1] are the only current supported resource.
965
+ #
966
+ # <note markdown="1"> This value must be a valid ARN.
967
+ #
968
+ # </note>
969
+ #
970
+ #
971
+ #
972
+ # [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.html
973
+ # @return [String]
974
+ #
975
+ # @!attribute [rw] tags
976
+ # The tags used to organize, track, or control access for this
977
+ # resource. For example, `\{ "Tags": \{"key1":"value1",
978
+ # "key2":"value2"\} \}`.
979
+ # @return [Hash<String,String>]
980
+ #
981
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/AttachedFile AWS API Documentation
982
+ #
983
+ class AttachedFile < Struct.new(
984
+ :creation_time,
985
+ :file_arn,
986
+ :file_id,
987
+ :file_name,
988
+ :file_size_in_bytes,
989
+ :file_status,
990
+ :created_by,
991
+ :file_use_case_type,
992
+ :associated_resource_arn,
993
+ :tags)
994
+ SENSITIVE = []
995
+ include Aws::Structure
996
+ end
997
+
998
+ # Error describing a failure to retrieve attached file metadata through
999
+ # BatchGetAttachedFileMetadata action.
1000
+ #
1001
+ # @!attribute [rw] error_code
1002
+ # Status code describing the failure.
1003
+ # @return [String]
1004
+ #
1005
+ # @!attribute [rw] error_message
1006
+ # Why the attached file couldn't be retrieved.
1007
+ # @return [String]
1008
+ #
1009
+ # @!attribute [rw] file_id
1010
+ # The unique identifier of the attached file resource.
1011
+ # @return [String]
1012
+ #
1013
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/AttachedFileError AWS API Documentation
1014
+ #
1015
+ class AttachedFileError < Struct.new(
1016
+ :error_code,
1017
+ :error_message,
1018
+ :file_id)
1019
+ SENSITIVE = []
1020
+ include Aws::Structure
1021
+ end
1022
+
926
1023
  # Information about a reference when the `referenceType` is
927
1024
  # `ATTACHMENT`. Otherwise, null.
928
1025
  #
@@ -1145,6 +1242,54 @@ module Aws::Connect
1145
1242
  include Aws::Structure
1146
1243
  end
1147
1244
 
1245
+ # @!attribute [rw] file_ids
1246
+ # The unique identifiers of the attached file resource.
1247
+ # @return [Array<String>]
1248
+ #
1249
+ # @!attribute [rw] instance_id
1250
+ # The unique identifier of the Connect instance.
1251
+ # @return [String]
1252
+ #
1253
+ # @!attribute [rw] associated_resource_arn
1254
+ # The resource to which the attached file is (being) uploaded to.
1255
+ # [Cases][1] are the only current supported resource.
1256
+ #
1257
+ # <note markdown="1"> This value must be a valid ARN.
1258
+ #
1259
+ # </note>
1260
+ #
1261
+ #
1262
+ #
1263
+ # [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.html
1264
+ # @return [String]
1265
+ #
1266
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/BatchGetAttachedFileMetadataRequest AWS API Documentation
1267
+ #
1268
+ class BatchGetAttachedFileMetadataRequest < Struct.new(
1269
+ :file_ids,
1270
+ :instance_id,
1271
+ :associated_resource_arn)
1272
+ SENSITIVE = []
1273
+ include Aws::Structure
1274
+ end
1275
+
1276
+ # @!attribute [rw] files
1277
+ # List of attached files that were successfully retrieved.
1278
+ # @return [Array<Types::AttachedFile>]
1279
+ #
1280
+ # @!attribute [rw] errors
1281
+ # List of errors of attached files that could not be retrieved.
1282
+ # @return [Array<Types::AttachedFileError>]
1283
+ #
1284
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/BatchGetAttachedFileMetadataResponse AWS API Documentation
1285
+ #
1286
+ class BatchGetAttachedFileMetadataResponse < Struct.new(
1287
+ :files,
1288
+ :errors)
1289
+ SENSITIVE = []
1290
+ include Aws::Structure
1291
+ end
1292
+
1148
1293
  # @!attribute [rw] instance_id
1149
1294
  # The identifier of the Amazon Connect instance. You can [find the
1150
1295
  # instance ID][1] in the Amazon Resource Name (ARN) of the instance.
@@ -1564,6 +1709,45 @@ module Aws::Connect
1564
1709
  include Aws::Structure
1565
1710
  end
1566
1711
 
1712
+ # Request to CompleteAttachedFileUpload API
1713
+ #
1714
+ # @!attribute [rw] instance_id
1715
+ # The unique identifier of the Connect instance.
1716
+ # @return [String]
1717
+ #
1718
+ # @!attribute [rw] file_id
1719
+ # The unique identifier of the attached file resource.
1720
+ # @return [String]
1721
+ #
1722
+ # @!attribute [rw] associated_resource_arn
1723
+ # The resource to which the attached file is (being) uploaded to.
1724
+ # [Cases][1] are the only current supported resource.
1725
+ #
1726
+ # <note markdown="1"> This value must be a valid ARN.
1727
+ #
1728
+ # </note>
1729
+ #
1730
+ #
1731
+ #
1732
+ # [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.html
1733
+ # @return [String]
1734
+ #
1735
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/CompleteAttachedFileUploadRequest AWS API Documentation
1736
+ #
1737
+ class CompleteAttachedFileUploadRequest < Struct.new(
1738
+ :instance_id,
1739
+ :file_id,
1740
+ :associated_resource_arn)
1741
+ SENSITIVE = []
1742
+ include Aws::Structure
1743
+ end
1744
+
1745
+ # Response from CompleteAttachedFileUpload API
1746
+ #
1747
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/CompleteAttachedFileUploadResponse AWS API Documentation
1748
+ #
1749
+ class CompleteAttachedFileUploadResponse < Aws::EmptyStructure; end
1750
+
1567
1751
  # Operation cannot be performed at this time as there is a conflict with
1568
1752
  # another operation or contact state.
1569
1753
  #
@@ -3953,6 +4137,41 @@ module Aws::Connect
3953
4137
  include Aws::Structure
3954
4138
  end
3955
4139
 
4140
+ # Information on the identity that created the file.
4141
+ #
4142
+ # @note CreatedByInfo is a union - when making an API calls you must set exactly one of the members.
4143
+ #
4144
+ # @note CreatedByInfo is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of CreatedByInfo corresponding to the set member.
4145
+ #
4146
+ # @!attribute [rw] connect_user_arn
4147
+ # An agent ARN representing a [connect user][1].
4148
+ #
4149
+ #
4150
+ #
4151
+ # [1]: https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonconnect.html#amazonconnect-resources-for-iam-policies
4152
+ # @return [String]
4153
+ #
4154
+ # @!attribute [rw] aws_identity_arn
4155
+ # STS or IAM ARN representing the identity of API Caller. SDK users
4156
+ # cannot populate this and this value is calculated automatically if
4157
+ # `ConnectUserArn` is not provided.
4158
+ # @return [String]
4159
+ #
4160
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/CreatedByInfo AWS API Documentation
4161
+ #
4162
+ class CreatedByInfo < Struct.new(
4163
+ :connect_user_arn,
4164
+ :aws_identity_arn,
4165
+ :unknown)
4166
+ SENSITIVE = []
4167
+ include Aws::Structure
4168
+ include Aws::Structure::Union
4169
+
4170
+ class ConnectUserArn < CreatedByInfo; end
4171
+ class AwsIdentityArn < CreatedByInfo; end
4172
+ class Unknown < CreatedByInfo; end
4173
+ end
4174
+
3956
4175
  # Contains credentials to use for federation.
3957
4176
  #
3958
4177
  # @!attribute [rw] access_token
@@ -4196,6 +4415,45 @@ module Aws::Connect
4196
4415
  include Aws::Structure
4197
4416
  end
4198
4417
 
4418
+ # Request to DeleteAttachedFile API
4419
+ #
4420
+ # @!attribute [rw] instance_id
4421
+ # The unique identifier of the Connect instance.
4422
+ # @return [String]
4423
+ #
4424
+ # @!attribute [rw] file_id
4425
+ # The unique identifier of the attached file resource.
4426
+ # @return [String]
4427
+ #
4428
+ # @!attribute [rw] associated_resource_arn
4429
+ # The resource to which the attached file is (being) uploaded to.
4430
+ # [Cases][1] are the only current supported resource.
4431
+ #
4432
+ # <note markdown="1"> This value must be a valid ARN.
4433
+ #
4434
+ # </note>
4435
+ #
4436
+ #
4437
+ #
4438
+ # [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.html
4439
+ # @return [String]
4440
+ #
4441
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/DeleteAttachedFileRequest AWS API Documentation
4442
+ #
4443
+ class DeleteAttachedFileRequest < Struct.new(
4444
+ :instance_id,
4445
+ :file_id,
4446
+ :associated_resource_arn)
4447
+ SENSITIVE = []
4448
+ include Aws::Structure
4449
+ end
4450
+
4451
+ # Response from DeleteAttachedFile API
4452
+ #
4453
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/DeleteAttachedFileResponse AWS API Documentation
4454
+ #
4455
+ class DeleteAttachedFileResponse < Aws::EmptyStructure; end
4456
+
4199
4457
  # @!attribute [rw] instance_id
4200
4458
  # The identifier of the Amazon Connect instance. You can [find the
4201
4459
  # instance ID][1] in the Amazon Resource Name (ARN) of the instance.
@@ -5966,6 +6224,27 @@ module Aws::Connect
5966
6224
  include Aws::Structure
5967
6225
  end
5968
6226
 
6227
+ # Metadata used to download the attached file.
6228
+ #
6229
+ # @!attribute [rw] url
6230
+ # A pre-signed URL that should be used to download the attached file.
6231
+ # @return [String]
6232
+ #
6233
+ # @!attribute [rw] url_expiry
6234
+ # The expiration time of the URL in ISO timestamp. It's specified in
6235
+ # ISO 8601 format: yyyy-MM-ddThh:mm:ss.SSSZ. For example,
6236
+ # 2019-11-08T02:41:28.172Z.
6237
+ # @return [String]
6238
+ #
6239
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/DownloadUrlMetadata AWS API Documentation
6240
+ #
6241
+ class DownloadUrlMetadata < Struct.new(
6242
+ :url,
6243
+ :url_expiry)
6244
+ SENSITIVE = []
6245
+ include Aws::Structure
6246
+ end
6247
+
5969
6248
  # A resource with the specified name already exists.
5970
6249
  #
5971
6250
  # @!attribute [rw] message
@@ -7130,6 +7409,122 @@ module Aws::Connect
7130
7409
  include Aws::Structure
7131
7410
  end
7132
7411
 
7412
+ # Request to GetAttachedFile API.
7413
+ #
7414
+ # @!attribute [rw] instance_id
7415
+ # The unique identifier of the Connect instance.
7416
+ # @return [String]
7417
+ #
7418
+ # @!attribute [rw] file_id
7419
+ # The unique identifier of the attached file resource.
7420
+ # @return [String]
7421
+ #
7422
+ # @!attribute [rw] url_expiry_in_seconds
7423
+ # Optional override for the expiry of the pre-signed S3 URL in
7424
+ # seconds.
7425
+ # @return [Integer]
7426
+ #
7427
+ # @!attribute [rw] associated_resource_arn
7428
+ # The resource to which the attached file is (being) uploaded to.
7429
+ # [Cases][1] are the only current supported resource.
7430
+ #
7431
+ # <note markdown="1"> This value must be a valid ARN.
7432
+ #
7433
+ # </note>
7434
+ #
7435
+ #
7436
+ #
7437
+ # [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.html
7438
+ # @return [String]
7439
+ #
7440
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/GetAttachedFileRequest AWS API Documentation
7441
+ #
7442
+ class GetAttachedFileRequest < Struct.new(
7443
+ :instance_id,
7444
+ :file_id,
7445
+ :url_expiry_in_seconds,
7446
+ :associated_resource_arn)
7447
+ SENSITIVE = []
7448
+ include Aws::Structure
7449
+ end
7450
+
7451
+ # Response from GetAttachedFile API.
7452
+ #
7453
+ # @!attribute [rw] file_arn
7454
+ # The unique identifier of the attached file resource (ARN).
7455
+ # @return [String]
7456
+ #
7457
+ # @!attribute [rw] file_id
7458
+ # The unique identifier of the attached file resource.
7459
+ # @return [String]
7460
+ #
7461
+ # @!attribute [rw] creation_time
7462
+ # The time of Creation of the file resource as an ISO timestamp. It's
7463
+ # specified in ISO 8601 format: `yyyy-MM-ddThh:mm:ss.SSSZ`. For
7464
+ # example, `2024-05-03T02:41:28.172Z`.
7465
+ # @return [String]
7466
+ #
7467
+ # @!attribute [rw] file_status
7468
+ # The current status of the attached file.
7469
+ # @return [String]
7470
+ #
7471
+ # @!attribute [rw] file_name
7472
+ # A case-sensitive name of the attached file being uploaded.
7473
+ # @return [String]
7474
+ #
7475
+ # @!attribute [rw] file_size_in_bytes
7476
+ # The size of the attached file in bytes.
7477
+ # @return [Integer]
7478
+ #
7479
+ # @!attribute [rw] associated_resource_arn
7480
+ # The resource to which the attached file is (being) uploaded to.
7481
+ # [Cases][1] are the only current supported resource.
7482
+ #
7483
+ # <note markdown="1"> This value must be a valid ARN.
7484
+ #
7485
+ # </note>
7486
+ #
7487
+ #
7488
+ #
7489
+ # [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.html
7490
+ # @return [String]
7491
+ #
7492
+ # @!attribute [rw] file_use_case_type
7493
+ # The use case for the file.
7494
+ # @return [String]
7495
+ #
7496
+ # @!attribute [rw] created_by
7497
+ # Represents the identity that created the file.
7498
+ # @return [Types::CreatedByInfo]
7499
+ #
7500
+ # @!attribute [rw] download_url_metadata
7501
+ # URL and expiry to be used when downloading the attached file.
7502
+ # @return [Types::DownloadUrlMetadata]
7503
+ #
7504
+ # @!attribute [rw] tags
7505
+ # The tags used to organize, track, or control access for this
7506
+ # resource. For example, `\{ "Tags": \{"key1":"value1",
7507
+ # "key2":"value2"\} \}`.
7508
+ # @return [Hash<String,String>]
7509
+ #
7510
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/GetAttachedFileResponse AWS API Documentation
7511
+ #
7512
+ class GetAttachedFileResponse < Struct.new(
7513
+ :file_arn,
7514
+ :file_id,
7515
+ :creation_time,
7516
+ :file_status,
7517
+ :file_name,
7518
+ :file_size_in_bytes,
7519
+ :associated_resource_arn,
7520
+ :file_use_case_type,
7521
+ :created_by,
7522
+ :download_url_metadata,
7523
+ :tags)
7524
+ SENSITIVE = []
7525
+ include Aws::Structure
7526
+ end
7527
+
7133
7528
  # @!attribute [rw] instance_id
7134
7529
  # The identifier of the Amazon Connect instance.
7135
7530
  # @return [String]
@@ -8207,7 +8602,7 @@ module Aws::Connect
8207
8602
  # Valid groupings and filters: Queue, Channel, Routing Profile,
8208
8603
  # Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
8209
8604
  #
8210
- # UI name: [Average greeting time agent ][21]
8605
+ # UI name: [Average agent greeting time][21]
8211
8606
  #
8212
8607
  # AVG\_HANDLE\_TIME
8213
8608
  #
@@ -8294,7 +8689,7 @@ module Aws::Connect
8294
8689
  # Valid groupings and filters: Queue, Channel, Routing Profile,
8295
8690
  # Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
8296
8691
  #
8297
- # UI name: [Average interruptions agent ][28]
8692
+ # UI name: [Average agent interruptions][28]
8298
8693
  #
8299
8694
  # AVG\_INTERRUPTION\_TIME\_AGENT
8300
8695
  #
@@ -8306,7 +8701,7 @@ module Aws::Connect
8306
8701
  # Valid groupings and filters: Queue, Channel, Routing Profile,
8307
8702
  # Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
8308
8703
  #
8309
- # UI name: [Average interruption time agent][29]
8704
+ # UI name: [Average agent interruption time][29]
8310
8705
  #
8311
8706
  # AVG\_NON\_TALK\_TIME
8312
8707
  #
@@ -8364,7 +8759,7 @@ module Aws::Connect
8364
8759
  # Valid groupings and filters: Queue, Channel, Routing Profile,
8365
8760
  # Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
8366
8761
  #
8367
- # UI name: [Average talk time agent][34]
8762
+ # UI name: [Average agent talk time][34]
8368
8763
  #
8369
8764
  # AVG\_TALK\_TIME\_CUSTOMER
8370
8765
  #
@@ -8376,7 +8771,7 @@ module Aws::Connect
8376
8771
  # Valid groupings and filters: Queue, Channel, Routing Profile,
8377
8772
  # Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
8378
8773
  #
8379
- # UI name: [Average talk time customer][35]
8774
+ # UI name: [Average customer talk time][35]
8380
8775
  #
8381
8776
  # CASES\_CREATED
8382
8777
  #
@@ -8438,7 +8833,7 @@ module Aws::Connect
8438
8833
  # Valid groupings and filters: Queue, Channel, Agent, Agent
8439
8834
  # Hierarchy, contact/segmentAttributes/connect:Subtype
8440
8835
  #
8441
- # UI name: [Contacts handled by Connected to agent][40]
8836
+ # UI name: [Contacts handled (connected to agent timestamp)][40]
8442
8837
  #
8443
8838
  # CONTACTS\_HOLD\_ABANDONS
8444
8839
  #
@@ -8510,7 +8905,7 @@ module Aws::Connect
8510
8905
  # Valid groupings and filters: Queue, Channel, Agent, Agent
8511
8906
  # Hierarchy, contact/segmentAttributes/connect:Subtype
8512
8907
  #
8513
- # UI name: [Contacts queued by Enqueue][46]
8908
+ # UI name: [Contacts queued (enqueue timestamp)][46]
8514
8909
  #
8515
8910
  # CONTACTS\_RESOLVED\_IN\_X
8516
8911
  #
@@ -8636,7 +9031,7 @@ module Aws::Connect
8636
9031
  # Valid groupings and filters: Queue, Channel, Routing Profile,
8637
9032
  # Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
8638
9033
  #
8639
- # UI name: [Talk time agent percent][55]
9034
+ # UI name: [Agent talk time percent][55]
8640
9035
  #
8641
9036
  # PERCENT\_TALK\_TIME\_CUSTOMER
8642
9037
  #
@@ -8648,7 +9043,7 @@ module Aws::Connect
8648
9043
  # Valid groupings and filters: Queue, Channel, Routing Profile,
8649
9044
  # Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
8650
9045
  #
8651
- # UI name: [Talk time customer percent][56]
9046
+ # UI name: [Customer talk time percent][56]
8652
9047
  #
8653
9048
  # REOPENED\_CASE\_ACTIONS
8654
9049
  #
@@ -10199,12 +10594,36 @@ module Aws::Connect
10199
10594
  # The message about the request.
10200
10595
  # @return [String]
10201
10596
  #
10597
+ # @!attribute [rw] reason
10598
+ # Reason why the request was invalid.
10599
+ # @return [Types::InvalidRequestExceptionReason]
10600
+ #
10202
10601
  # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/InvalidRequestException AWS API Documentation
10203
10602
  #
10204
10603
  class InvalidRequestException < Struct.new(
10205
- :message)
10604
+ :message,
10605
+ :reason)
10606
+ SENSITIVE = []
10607
+ include Aws::Structure
10608
+ end
10609
+
10610
+ # Reason why the request was invalid.
10611
+ #
10612
+ # @!attribute [rw] attached_file_invalid_request_exception_reason
10613
+ # Reason why the StartAttachedFiledUpload request was invalid.
10614
+ # @return [String]
10615
+ #
10616
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/InvalidRequestExceptionReason AWS API Documentation
10617
+ #
10618
+ class InvalidRequestExceptionReason < Struct.new(
10619
+ :attached_file_invalid_request_exception_reason,
10620
+ :unknown)
10206
10621
  SENSITIVE = []
10207
10622
  include Aws::Structure
10623
+ include Aws::Structure::Union
10624
+
10625
+ class AttachedFileInvalidRequestExceptionReason < InvalidRequestExceptionReason; end
10626
+ class Unknown < InvalidRequestExceptionReason; end
10208
10627
  end
10209
10628
 
10210
10629
  # A field that is invisible to an agent.
@@ -17004,6 +17423,121 @@ module Aws::Connect
17004
17423
  include Aws::Structure
17005
17424
  end
17006
17425
 
17426
+ # @!attribute [rw] client_token
17427
+ # A unique, case-sensitive identifier that you provide to ensure the
17428
+ # idempotency of the request. If not provided, the Amazon Web Services
17429
+ # SDK populates this field. For more information about idempotency,
17430
+ # see [Making retries safe with idempotent APIs][1].
17431
+ #
17432
+ # **A suitable default value is auto-generated.** You should normally
17433
+ # not need to pass this option.
17434
+ #
17435
+ #
17436
+ #
17437
+ # [1]: https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/
17438
+ # @return [String]
17439
+ #
17440
+ # @!attribute [rw] instance_id
17441
+ # The unique identifier of the Connect instance.
17442
+ # @return [String]
17443
+ #
17444
+ # @!attribute [rw] file_name
17445
+ # A case-sensitive name of the attached file being uploaded.
17446
+ # @return [String]
17447
+ #
17448
+ # @!attribute [rw] file_size_in_bytes
17449
+ # The size of the attached file in bytes.
17450
+ # @return [Integer]
17451
+ #
17452
+ # @!attribute [rw] url_expiry_in_seconds
17453
+ # Optional override for the expiry of the pre-signed S3 URL in
17454
+ # seconds.
17455
+ # @return [Integer]
17456
+ #
17457
+ # @!attribute [rw] file_use_case_type
17458
+ # The use case for the file.
17459
+ # @return [String]
17460
+ #
17461
+ # @!attribute [rw] associated_resource_arn
17462
+ # The resource to which the attached file is (being) uploaded to.
17463
+ # [Cases][1] are the only current supported resource.
17464
+ #
17465
+ # <note markdown="1"> This value must be a valid ARN.
17466
+ #
17467
+ # </note>
17468
+ #
17469
+ #
17470
+ #
17471
+ # [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.html
17472
+ # @return [String]
17473
+ #
17474
+ # @!attribute [rw] created_by
17475
+ # Represents the identity that created the file.
17476
+ # @return [Types::CreatedByInfo]
17477
+ #
17478
+ # @!attribute [rw] tags
17479
+ # The tags used to organize, track, or control access for this
17480
+ # resource. For example, `\{ "Tags": \{"key1":"value1",
17481
+ # "key2":"value2"\} \}`.
17482
+ # @return [Hash<String,String>]
17483
+ #
17484
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/StartAttachedFileUploadRequest AWS API Documentation
17485
+ #
17486
+ class StartAttachedFileUploadRequest < Struct.new(
17487
+ :client_token,
17488
+ :instance_id,
17489
+ :file_name,
17490
+ :file_size_in_bytes,
17491
+ :url_expiry_in_seconds,
17492
+ :file_use_case_type,
17493
+ :associated_resource_arn,
17494
+ :created_by,
17495
+ :tags)
17496
+ SENSITIVE = []
17497
+ include Aws::Structure
17498
+ end
17499
+
17500
+ # Response from StartAttachedFileUpload API.
17501
+ #
17502
+ # @!attribute [rw] file_arn
17503
+ # The unique identifier of the attached file resource (ARN).
17504
+ # @return [String]
17505
+ #
17506
+ # @!attribute [rw] file_id
17507
+ # The unique identifier of the attached file resource.
17508
+ # @return [String]
17509
+ #
17510
+ # @!attribute [rw] creation_time
17511
+ # The time of Creation of the file resource as an ISO timestamp. It's
17512
+ # specified in ISO 8601 format: `yyyy-MM-ddThh:mm:ss.SSSZ`. For
17513
+ # example, `2024-05-03T02:41:28.172Z`.
17514
+ # @return [String]
17515
+ #
17516
+ # @!attribute [rw] file_status
17517
+ # The current status of the attached file.
17518
+ # @return [String]
17519
+ #
17520
+ # @!attribute [rw] created_by
17521
+ # Represents the identity that created the file.
17522
+ # @return [Types::CreatedByInfo]
17523
+ #
17524
+ # @!attribute [rw] upload_url_metadata
17525
+ # Information to be used while uploading the attached file.
17526
+ # @return [Types::UploadUrlMetadata]
17527
+ #
17528
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/StartAttachedFileUploadResponse AWS API Documentation
17529
+ #
17530
+ class StartAttachedFileUploadResponse < Struct.new(
17531
+ :file_arn,
17532
+ :file_id,
17533
+ :creation_time,
17534
+ :file_status,
17535
+ :created_by,
17536
+ :upload_url_metadata)
17537
+ SENSITIVE = []
17538
+ include Aws::Structure
17539
+ end
17540
+
17007
17541
  # @!attribute [rw] instance_id
17008
17542
  # The identifier of the Amazon Connect instance. You can [find the
17009
17543
  # instance ID][1] in the Amazon Resource Name (ARN) of the instance.
@@ -18829,6 +19363,23 @@ module Aws::Connect
18829
19363
  # You can have up to 32,768 UTF-8 bytes across all attributes for a
18830
19364
  # contact. Attribute keys can include only alphanumeric, dash, and
18831
19365
  # underscore characters.
19366
+ #
19367
+ # When the attributes for a contact exceed 32 KB, the contact is
19368
+ # routed down the Error branch of the flow. As a mitigation, consider
19369
+ # the following options:
19370
+ #
19371
+ # * Remove unnecessary attributes by setting their values to empty.
19372
+ #
19373
+ # * If the attributes are only used in one flow and don't need to be
19374
+ # referred to outside of that flow (for example, by a Lambda or
19375
+ # another flow), then use flow attributes. This way you aren't
19376
+ # needlessly persisting the 32 KB of information from one flow to
19377
+ # another. For more information, see [Flow block: Set contact
19378
+ # attributes][1] in the *Amazon Connect Administrator Guide*.
19379
+ #
19380
+ #
19381
+ #
19382
+ # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/set-contact-attributes.html
18832
19383
  # @return [Hash<String,String>]
18833
19384
  #
18834
19385
  # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/UpdateContactAttributesRequest AWS API Documentation
@@ -20545,6 +21096,34 @@ module Aws::Connect
20545
21096
  #
20546
21097
  class UpdateViewMetadataResponse < Aws::EmptyStructure; end
20547
21098
 
21099
+ # Fields required when uploading an attached file.
21100
+ #
21101
+ # @!attribute [rw] url
21102
+ # A pre-signed S3 URL that should be used for uploading the attached
21103
+ # file.
21104
+ # @return [String]
21105
+ #
21106
+ # @!attribute [rw] url_expiry
21107
+ # The expiration time of the URL in ISO timestamp. It's specified in
21108
+ # ISO 8601 format: `yyyy-MM-ddThh:mm:ss.SSSZ`. For example,
21109
+ # `2019-11-08T02:41:28.172Z`.
21110
+ # @return [String]
21111
+ #
21112
+ # @!attribute [rw] headers_to_include
21113
+ # A map of headers that should be provided when uploading the attached
21114
+ # file.
21115
+ # @return [Hash<String,String>]
21116
+ #
21117
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/UploadUrlMetadata AWS API Documentation
21118
+ #
21119
+ class UploadUrlMetadata < Struct.new(
21120
+ :url,
21121
+ :url_expiry,
21122
+ :headers_to_include)
21123
+ SENSITIVE = []
21124
+ include Aws::Structure
21125
+ end
21126
+
20548
21127
  # The URL reference.
20549
21128
  #
20550
21129
  # @!attribute [rw] name