aws-sdk-connect 1.154.0 → 1.156.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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