-
Notifications
You must be signed in to change notification settings - Fork 599
/
types.go
3519 lines (2828 loc) · 135 KB
/
types.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
// Code generated by smithy-go-codegen DO NOT EDIT.
package types
import (
smithydocument "github.com/aws/smithy-go/document"
"time"
)
// Specifies the days since the initiation of an incomplete multipart upload that
// Amazon S3 will wait before permanently removing all parts of the upload. For
// more information, see Aborting Incomplete Multipart Uploads Using a Bucket
// Lifecycle Configuration (https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config)
// in the Amazon S3 User Guide.
type AbortIncompleteMultipartUpload struct {
// Specifies the number of days after which Amazon S3 aborts an incomplete
// multipart upload.
DaysAfterInitiation *int32
noSmithyDocumentSerde
}
// Configures the transfer acceleration state for an Amazon S3 bucket. For more
// information, see Amazon S3 Transfer Acceleration (https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html)
// in the Amazon S3 User Guide.
type AccelerateConfiguration struct {
// Specifies the transfer acceleration status of the bucket.
Status BucketAccelerateStatus
noSmithyDocumentSerde
}
// Contains the elements that set the ACL permissions for an object per grantee.
type AccessControlPolicy struct {
// A list of grants.
Grants []Grant
// Container for the bucket owner's display name and ID.
Owner *Owner
noSmithyDocumentSerde
}
// A container for information about access control for replicas.
type AccessControlTranslation struct {
// Specifies the replica ownership. For default and valid values, see PUT bucket
// replication (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTreplication.html)
// in the Amazon S3 API Reference.
//
// This member is required.
Owner OwnerOverride
noSmithyDocumentSerde
}
// A conjunction (logical AND) of predicates, which is used in evaluating a
// metrics filter. The operator must have at least two predicates in any
// combination, and an object must match all of the predicates for the filter to
// apply.
type AnalyticsAndOperator struct {
// The prefix to use when evaluating an AND predicate: The prefix that an object
// must have to be included in the metrics results.
Prefix *string
// The list of tags to use when evaluating an AND predicate.
Tags []Tag
noSmithyDocumentSerde
}
// Specifies the configuration and any analyses for the analytics filter of an
// Amazon S3 bucket.
type AnalyticsConfiguration struct {
// The ID that identifies the analytics configuration.
//
// This member is required.
Id *string
// Contains data related to access patterns to be collected and made available to
// analyze the tradeoffs between different storage classes.
//
// This member is required.
StorageClassAnalysis *StorageClassAnalysis
// The filter used to describe a set of objects for analyses. A filter must have
// exactly one prefix, one tag, or one conjunction (AnalyticsAndOperator). If no
// filter is provided, all objects will be considered in any analysis.
Filter AnalyticsFilter
noSmithyDocumentSerde
}
// Where to publish the analytics results.
type AnalyticsExportDestination struct {
// A destination signifying output to an S3 bucket.
//
// This member is required.
S3BucketDestination *AnalyticsS3BucketDestination
noSmithyDocumentSerde
}
// The filter used to describe a set of objects for analyses. A filter must have
// exactly one prefix, one tag, or one conjunction (AnalyticsAndOperator). If no
// filter is provided, all objects will be considered in any analysis.
//
// The following types satisfy this interface:
//
// AnalyticsFilterMemberAnd
// AnalyticsFilterMemberPrefix
// AnalyticsFilterMemberTag
type AnalyticsFilter interface {
isAnalyticsFilter()
}
// A conjunction (logical AND) of predicates, which is used in evaluating an
// analytics filter. The operator must have at least two predicates.
type AnalyticsFilterMemberAnd struct {
Value AnalyticsAndOperator
noSmithyDocumentSerde
}
func (*AnalyticsFilterMemberAnd) isAnalyticsFilter() {}
// The prefix to use when evaluating an analytics filter.
type AnalyticsFilterMemberPrefix struct {
Value string
noSmithyDocumentSerde
}
func (*AnalyticsFilterMemberPrefix) isAnalyticsFilter() {}
// The tag to use when evaluating an analytics filter.
type AnalyticsFilterMemberTag struct {
Value Tag
noSmithyDocumentSerde
}
func (*AnalyticsFilterMemberTag) isAnalyticsFilter() {}
// Contains information about where to publish the analytics results.
type AnalyticsS3BucketDestination struct {
// The Amazon Resource Name (ARN) of the bucket to which data is exported.
//
// This member is required.
Bucket *string
// Specifies the file format used when exporting data to Amazon S3.
//
// This member is required.
Format AnalyticsS3ExportFileFormat
// The account ID that owns the destination S3 bucket. If no account ID is
// provided, the owner is not validated before exporting data. Although this value
// is optional, we strongly recommend that you set it to help prevent problems if
// the destination bucket ownership changes.
BucketAccountId *string
// The prefix to use when exporting data. The prefix is prepended to all results.
Prefix *string
noSmithyDocumentSerde
}
// In terms of implementation, a Bucket is a resource.
type Bucket struct {
// Date the bucket was created. This date can change when making changes to your
// bucket, such as editing its bucket policy.
CreationDate *time.Time
// The name of the bucket.
Name *string
noSmithyDocumentSerde
}
// Specifies the information about the bucket that will be created. For more
// information about directory buckets, see Directory buckets (https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html)
// in the Amazon S3 User Guide. This functionality is only supported by directory
// buckets.
type BucketInfo struct {
// The number of Availability Zone that's used for redundancy for the bucket.
DataRedundancy DataRedundancy
// The type of bucket.
Type BucketType
noSmithyDocumentSerde
}
// Specifies the lifecycle configuration for objects in an Amazon S3 bucket. For
// more information, see Object Lifecycle Management (https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html)
// in the Amazon S3 User Guide.
type BucketLifecycleConfiguration struct {
// A lifecycle rule for individual objects in an Amazon S3 bucket.
//
// This member is required.
Rules []LifecycleRule
noSmithyDocumentSerde
}
// Container for logging status information.
type BucketLoggingStatus struct {
// Describes where logs are stored and the prefix that Amazon S3 assigns to all
// log object keys for a bucket. For more information, see PUT Bucket logging (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTlogging.html)
// in the Amazon S3 API Reference.
LoggingEnabled *LoggingEnabled
noSmithyDocumentSerde
}
// Contains all the possible checksum or digest values for an object.
type Checksum struct {
// The base64-encoded, 32-bit CRC32 checksum of the object. This will only be
// present if it was uploaded with the object. When you use an API operation on an
// object that was uploaded using multipart uploads, this value may not be a direct
// checksum value of the full object. Instead, it's a calculation based on the
// checksum values of each individual part. For more information about how
// checksums are calculated with multipart uploads, see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
// in the Amazon S3 User Guide.
ChecksumCRC32 *string
// The base64-encoded, 32-bit CRC32C checksum of the object. This will only be
// present if it was uploaded with the object. When you use an API operation on an
// object that was uploaded using multipart uploads, this value may not be a direct
// checksum value of the full object. Instead, it's a calculation based on the
// checksum values of each individual part. For more information about how
// checksums are calculated with multipart uploads, see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
// in the Amazon S3 User Guide.
ChecksumCRC32C *string
// The base64-encoded, 160-bit SHA-1 digest of the object. This will only be
// present if it was uploaded with the object. When you use the API operation on an
// object that was uploaded using multipart uploads, this value may not be a direct
// checksum value of the full object. Instead, it's a calculation based on the
// checksum values of each individual part. For more information about how
// checksums are calculated with multipart uploads, see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
// in the Amazon S3 User Guide.
ChecksumSHA1 *string
// The base64-encoded, 256-bit SHA-256 digest of the object. This will only be
// present if it was uploaded with the object. When you use an API operation on an
// object that was uploaded using multipart uploads, this value may not be a direct
// checksum value of the full object. Instead, it's a calculation based on the
// checksum values of each individual part. For more information about how
// checksums are calculated with multipart uploads, see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
// in the Amazon S3 User Guide.
ChecksumSHA256 *string
noSmithyDocumentSerde
}
// Container for all (if there are any) keys between Prefix and the next
// occurrence of the string specified by a delimiter. CommonPrefixes lists keys
// that act like subdirectories in the directory specified by Prefix. For example,
// if the prefix is notes/ and the delimiter is a slash (/) as in
// notes/summer/july, the common prefix is notes/summer/.
type CommonPrefix struct {
// Container for the specified common prefix.
Prefix *string
noSmithyDocumentSerde
}
// The container for the completed multipart upload details.
type CompletedMultipartUpload struct {
// Array of CompletedPart data types. If you do not supply a valid Part with your
// request, the service sends back an HTTP 400 response.
Parts []CompletedPart
noSmithyDocumentSerde
}
// Details of the parts that were uploaded.
type CompletedPart struct {
// The base64-encoded, 32-bit CRC32 checksum of the object. This will only be
// present if it was uploaded with the object. When you use an API operation on an
// object that was uploaded using multipart uploads, this value may not be a direct
// checksum value of the full object. Instead, it's a calculation based on the
// checksum values of each individual part. For more information about how
// checksums are calculated with multipart uploads, see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
// in the Amazon S3 User Guide.
ChecksumCRC32 *string
// The base64-encoded, 32-bit CRC32C checksum of the object. This will only be
// present if it was uploaded with the object. When you use an API operation on an
// object that was uploaded using multipart uploads, this value may not be a direct
// checksum value of the full object. Instead, it's a calculation based on the
// checksum values of each individual part. For more information about how
// checksums are calculated with multipart uploads, see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
// in the Amazon S3 User Guide.
ChecksumCRC32C *string
// The base64-encoded, 160-bit SHA-1 digest of the object. This will only be
// present if it was uploaded with the object. When you use the API operation on an
// object that was uploaded using multipart uploads, this value may not be a direct
// checksum value of the full object. Instead, it's a calculation based on the
// checksum values of each individual part. For more information about how
// checksums are calculated with multipart uploads, see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
// in the Amazon S3 User Guide.
ChecksumSHA1 *string
// The base64-encoded, 256-bit SHA-256 digest of the object. This will only be
// present if it was uploaded with the object. When you use an API operation on an
// object that was uploaded using multipart uploads, this value may not be a direct
// checksum value of the full object. Instead, it's a calculation based on the
// checksum values of each individual part. For more information about how
// checksums are calculated with multipart uploads, see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
// in the Amazon S3 User Guide.
ChecksumSHA256 *string
// Entity tag returned when the part was uploaded.
ETag *string
// Part number that identifies the part. This is a positive integer between 1 and
// 10,000.
// - General purpose buckets - In CompleteMultipartUpload , when a additional
// checksum (including x-amz-checksum-crc32 , x-amz-checksum-crc32c ,
// x-amz-checksum-sha1 , or x-amz-checksum-sha256 ) is applied to each part, the
// PartNumber must start at 1 and the part numbers must be consecutive.
// Otherwise, Amazon S3 generates an HTTP 400 Bad Request status code and an
// InvalidPartOrder error code.
// - Directory buckets - In CompleteMultipartUpload , the PartNumber must start
// at 1 and the part numbers must be consecutive.
PartNumber *int32
noSmithyDocumentSerde
}
// A container for describing a condition that must be met for the specified
// redirect to apply. For example, 1. If request is for pages in the /docs folder,
// redirect to the /documents folder. 2. If request results in HTTP error 4xx,
// redirect request to another host where you might process the error.
type Condition struct {
// The HTTP error code when the redirect is applied. In the event of an error, if
// the error code equals this value, then the specified redirect is applied.
// Required when parent element Condition is specified and sibling KeyPrefixEquals
// is not specified. If both are specified, then both must be true for the redirect
// to be applied.
HttpErrorCodeReturnedEquals *string
// The object key name prefix when the redirect is applied. For example, to
// redirect requests for ExamplePage.html , the key prefix will be ExamplePage.html
// . To redirect request for all pages with the prefix docs/ , the key prefix will
// be /docs , which identifies all objects in the docs/ folder. Required when the
// parent element Condition is specified and sibling HttpErrorCodeReturnedEquals
// is not specified. If both conditions are specified, both must be true for the
// redirect to be applied. Replacement must be made for object keys containing
// special characters (such as carriage returns) when using XML requests. For more
// information, see XML related object key constraints (https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-xml-related-constraints)
// .
KeyPrefixEquals *string
noSmithyDocumentSerde
}
type ContinuationEvent struct {
noSmithyDocumentSerde
}
// Container for all response elements.
type CopyObjectResult struct {
// The base64-encoded, 32-bit CRC32 checksum of the object. This will only be
// present if it was uploaded with the object. For more information, see Checking
// object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
// in the Amazon S3 User Guide.
ChecksumCRC32 *string
// The base64-encoded, 32-bit CRC32C checksum of the object. This will only be
// present if it was uploaded with the object. For more information, see Checking
// object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
// in the Amazon S3 User Guide.
ChecksumCRC32C *string
// The base64-encoded, 160-bit SHA-1 digest of the object. This will only be
// present if it was uploaded with the object. For more information, see Checking
// object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
// in the Amazon S3 User Guide.
ChecksumSHA1 *string
// The base64-encoded, 256-bit SHA-256 digest of the object. This will only be
// present if it was uploaded with the object. For more information, see Checking
// object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html)
// in the Amazon S3 User Guide.
ChecksumSHA256 *string
// Returns the ETag of the new object. The ETag reflects only changes to the
// contents of an object, not its metadata.
ETag *string
// Creation date of the object.
LastModified *time.Time
noSmithyDocumentSerde
}
// Container for all response elements.
type CopyPartResult struct {
// The base64-encoded, 32-bit CRC32 checksum of the object. This will only be
// present if it was uploaded with the object. When you use an API operation on an
// object that was uploaded using multipart uploads, this value may not be a direct
// checksum value of the full object. Instead, it's a calculation based on the
// checksum values of each individual part. For more information about how
// checksums are calculated with multipart uploads, see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
// in the Amazon S3 User Guide.
ChecksumCRC32 *string
// The base64-encoded, 32-bit CRC32C checksum of the object. This will only be
// present if it was uploaded with the object. When you use an API operation on an
// object that was uploaded using multipart uploads, this value may not be a direct
// checksum value of the full object. Instead, it's a calculation based on the
// checksum values of each individual part. For more information about how
// checksums are calculated with multipart uploads, see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
// in the Amazon S3 User Guide.
ChecksumCRC32C *string
// The base64-encoded, 160-bit SHA-1 digest of the object. This will only be
// present if it was uploaded with the object. When you use the API operation on an
// object that was uploaded using multipart uploads, this value may not be a direct
// checksum value of the full object. Instead, it's a calculation based on the
// checksum values of each individual part. For more information about how
// checksums are calculated with multipart uploads, see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
// in the Amazon S3 User Guide.
ChecksumSHA1 *string
// The base64-encoded, 256-bit SHA-256 digest of the object. This will only be
// present if it was uploaded with the object. When you use an API operation on an
// object that was uploaded using multipart uploads, this value may not be a direct
// checksum value of the full object. Instead, it's a calculation based on the
// checksum values of each individual part. For more information about how
// checksums are calculated with multipart uploads, see Checking object integrity (https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums)
// in the Amazon S3 User Guide.
ChecksumSHA256 *string
// Entity tag of the object.
ETag *string
// Date and time at which the object was uploaded.
LastModified *time.Time
noSmithyDocumentSerde
}
// Describes the cross-origin access configuration for objects in an Amazon S3
// bucket. For more information, see Enabling Cross-Origin Resource Sharing (https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html)
// in the Amazon S3 User Guide.
type CORSConfiguration struct {
// A set of origins and methods (cross-origin access that you want to allow). You
// can add up to 100 rules to the configuration.
//
// This member is required.
CORSRules []CORSRule
noSmithyDocumentSerde
}
// Specifies a cross-origin access rule for an Amazon S3 bucket.
type CORSRule struct {
// An HTTP method that you allow the origin to execute. Valid values are GET , PUT
// , HEAD , POST , and DELETE .
//
// This member is required.
AllowedMethods []string
// One or more origins you want customers to be able to access the bucket from.
//
// This member is required.
AllowedOrigins []string
// Headers that are specified in the Access-Control-Request-Headers header. These
// headers are allowed in a preflight OPTIONS request. In response to any preflight
// OPTIONS request, Amazon S3 returns any requested headers that are allowed.
AllowedHeaders []string
// One or more headers in the response that you want customers to be able to
// access from their applications (for example, from a JavaScript XMLHttpRequest
// object).
ExposeHeaders []string
// Unique identifier for the rule. The value cannot be longer than 255 characters.
ID *string
// The time in seconds that your browser is to cache the preflight response for
// the specified resource.
MaxAgeSeconds *int32
noSmithyDocumentSerde
}
// The configuration information for the bucket.
type CreateBucketConfiguration struct {
// Specifies the information about the bucket that will be created. This
// functionality is only supported by directory buckets.
Bucket *BucketInfo
// Specifies the location where the bucket will be created. For directory buckets,
// the location type is Availability Zone. This functionality is only supported by
// directory buckets.
Location *LocationInfo
// Specifies the Region where the bucket will be created. You might choose a
// Region to optimize latency, minimize costs, or address regulatory requirements.
// For example, if you reside in Europe, you will probably find it advantageous to
// create buckets in the Europe (Ireland) Region. For more information, see
// Accessing a bucket (https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html#access-bucket-intro)
// in the Amazon S3 User Guide. If you don't specify a Region, the bucket is
// created in the US East (N. Virginia) Region (us-east-1) by default. This
// functionality is not supported for directory buckets.
LocationConstraint BucketLocationConstraint
noSmithyDocumentSerde
}
// Describes how an uncompressed comma-separated values (CSV)-formatted input
// object is formatted.
type CSVInput struct {
// Specifies that CSV field values may contain quoted record delimiters and such
// records should be allowed. Default value is FALSE. Setting this value to TRUE
// may lower performance.
AllowQuotedRecordDelimiter *bool
// A single character used to indicate that a row should be ignored when the
// character is present at the start of that row. You can specify any character to
// indicate a comment line. The default character is # . Default: #
Comments *string
// A single character used to separate individual fields in a record. You can
// specify an arbitrary delimiter.
FieldDelimiter *string
// Describes the first line of input. Valid values are:
// - NONE : First line is not a header.
// - IGNORE : First line is a header, but you can't use the header values to
// indicate the column in an expression. You can use column position (such as _1,
// _2, …) to indicate the column ( SELECT s._1 FROM OBJECT s ).
// - Use : First line is a header, and you can use the header value to identify a
// column in an expression ( SELECT "name" FROM OBJECT ).
FileHeaderInfo FileHeaderInfo
// A single character used for escaping when the field delimiter is part of the
// value. For example, if the value is a, b , Amazon S3 wraps this field value in
// quotation marks, as follows: " a , b " . Type: String Default: " Ancestors: CSV
QuoteCharacter *string
// A single character used for escaping the quotation mark character inside an
// already escaped value. For example, the value """ a , b """ is parsed as " a ,
// b " .
QuoteEscapeCharacter *string
// A single character used to separate individual records in the input. Instead of
// the default value, you can specify an arbitrary delimiter.
RecordDelimiter *string
noSmithyDocumentSerde
}
// Describes how uncompressed comma-separated values (CSV)-formatted results are
// formatted.
type CSVOutput struct {
// The value used to separate individual fields in a record. You can specify an
// arbitrary delimiter.
FieldDelimiter *string
// A single character used for escaping when the field delimiter is part of the
// value. For example, if the value is a, b , Amazon S3 wraps this field value in
// quotation marks, as follows: " a , b " .
QuoteCharacter *string
// The single character used for escaping the quote character inside an already
// escaped value.
QuoteEscapeCharacter *string
// Indicates whether to use quotation marks around output fields.
// - ALWAYS : Always use quotation marks for output fields.
// - ASNEEDED : Use quotation marks for output fields when needed.
QuoteFields QuoteFields
// A single character used to separate individual records in the output. Instead
// of the default value, you can specify an arbitrary delimiter.
RecordDelimiter *string
noSmithyDocumentSerde
}
// The container element for specifying the default Object Lock retention settings
// for new objects placed in the specified bucket.
// - The DefaultRetention settings require both a mode and a period.
// - The DefaultRetention period can be either Days or Years but you must select
// one. You cannot specify Days and Years at the same time.
type DefaultRetention struct {
// The number of days that you want to specify for the default retention period.
// Must be used with Mode .
Days *int32
// The default Object Lock retention mode you want to apply to new objects placed
// in the specified bucket. Must be used with either Days or Years .
Mode ObjectLockRetentionMode
// The number of years that you want to specify for the default retention period.
// Must be used with Mode .
Years *int32
noSmithyDocumentSerde
}
// Container for the objects to delete.
type Delete struct {
// The object to delete. Directory buckets - For directory buckets, an object
// that's composed entirely of whitespace characters is not supported by the
// DeleteObjects API operation. The request will receive a 400 Bad Request error
// and none of the objects in the request will be deleted.
//
// This member is required.
Objects []ObjectIdentifier
// Element to enable quiet mode for the request. When you add this element, you
// must set its value to true .
Quiet *bool
noSmithyDocumentSerde
}
// Information about the deleted object.
type DeletedObject struct {
// Indicates whether the specified object version that was permanently deleted was
// (true) or was not (false) a delete marker before deletion. In a simple DELETE,
// this header indicates whether (true) or not (false) the current version of the
// object is a delete marker. This functionality is not supported for directory
// buckets.
DeleteMarker *bool
// The version ID of the delete marker created as a result of the DELETE
// operation. If you delete a specific object version, the value returned by this
// header is the version ID of the object version deleted. This functionality is
// not supported for directory buckets.
DeleteMarkerVersionId *string
// The name of the deleted object.
Key *string
// The version ID of the deleted object. This functionality is not supported for
// directory buckets.
VersionId *string
noSmithyDocumentSerde
}
// Information about the delete marker.
type DeleteMarkerEntry struct {
// Specifies whether the object is (true) or is not (false) the latest version of
// an object.
IsLatest *bool
// The object key.
Key *string
// Date and time when the object was last modified.
LastModified *time.Time
// The account that created the delete marker.>
Owner *Owner
// Version ID of an object.
VersionId *string
noSmithyDocumentSerde
}
// Specifies whether Amazon S3 replicates delete markers. If you specify a Filter
// in your replication configuration, you must also include a
// DeleteMarkerReplication element. If your Filter includes a Tag element, the
// DeleteMarkerReplication Status must be set to Disabled, because Amazon S3 does
// not support replicating delete markers for tag-based rules. For an example
// configuration, see Basic Rule Configuration (https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-add-config.html#replication-config-min-rule-config)
// . For more information about delete marker replication, see Basic Rule
// Configuration (https://docs.aws.amazon.com/AmazonS3/latest/dev/delete-marker-replication.html)
// . If you are using an earlier version of the replication configuration, Amazon
// S3 handles replication of delete markers differently. For more information, see
// Backward Compatibility (https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-add-config.html#replication-backward-compat-considerations)
// .
type DeleteMarkerReplication struct {
// Indicates whether to replicate delete markers. Indicates whether to replicate
// delete markers.
Status DeleteMarkerReplicationStatus
noSmithyDocumentSerde
}
// Specifies information about where to publish analysis or configuration results
// for an Amazon S3 bucket and S3 Replication Time Control (S3 RTC).
type Destination struct {
// The Amazon Resource Name (ARN) of the bucket where you want Amazon S3 to store
// the results.
//
// This member is required.
Bucket *string
// Specify this only in a cross-account scenario (where source and destination
// bucket owners are not the same), and you want to change replica ownership to the
// Amazon Web Services account that owns the destination bucket. If this is not
// specified in the replication configuration, the replicas are owned by same
// Amazon Web Services account that owns the source object.
AccessControlTranslation *AccessControlTranslation
// Destination bucket owner account ID. In a cross-account scenario, if you direct
// Amazon S3 to change replica ownership to the Amazon Web Services account that
// owns the destination bucket by specifying the AccessControlTranslation
// property, this is the account ID of the destination bucket owner. For more
// information, see Replication Additional Configuration: Changing the Replica
// Owner (https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-change-owner.html)
// in the Amazon S3 User Guide.
Account *string
// A container that provides information about encryption. If
// SourceSelectionCriteria is specified, you must specify this element.
EncryptionConfiguration *EncryptionConfiguration
// A container specifying replication metrics-related settings enabling
// replication metrics and events.
Metrics *Metrics
// A container specifying S3 Replication Time Control (S3 RTC), including whether
// S3 RTC is enabled and the time when all objects and operations on objects must
// be replicated. Must be specified together with a Metrics block.
ReplicationTime *ReplicationTime
// The storage class to use when replicating objects, such as S3 Standard or
// reduced redundancy. By default, Amazon S3 uses the storage class of the source
// object to create the object replica. For valid values, see the StorageClass
// element of the PUT Bucket replication (https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTreplication.html)
// action in the Amazon S3 API Reference.
StorageClass StorageClass
noSmithyDocumentSerde
}
// Contains the type of server-side encryption used.
type Encryption struct {
// The server-side encryption algorithm used when storing job results in Amazon S3
// (for example, AES256, aws:kms ).
//
// This member is required.
EncryptionType ServerSideEncryption
// If the encryption type is aws:kms , this optional value can be used to specify
// the encryption context for the restore results.
KMSContext *string
// If the encryption type is aws:kms , this optional value specifies the ID of the
// symmetric encryption customer managed key to use for encryption of job results.
// Amazon S3 only supports symmetric encryption KMS keys. For more information, see
// Asymmetric keys in KMS (https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html)
// in the Amazon Web Services Key Management Service Developer Guide.
KMSKeyId *string
noSmithyDocumentSerde
}
// Specifies encryption-related information for an Amazon S3 bucket that is a
// destination for replicated objects.
type EncryptionConfiguration struct {
// Specifies the ID (Key ARN or Alias ARN) of the customer managed Amazon Web
// Services KMS key stored in Amazon Web Services Key Management Service (KMS) for
// the destination bucket. Amazon S3 uses this key to encrypt replica objects.
// Amazon S3 only supports symmetric encryption KMS keys. For more information, see
// Asymmetric keys in Amazon Web Services KMS (https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html)
// in the Amazon Web Services Key Management Service Developer Guide.
ReplicaKmsKeyID *string
noSmithyDocumentSerde
}
// A message that indicates the request is complete and no more messages will be
// sent. You should not assume that the request is complete until the client
// receives an EndEvent .
type EndEvent struct {
noSmithyDocumentSerde
}
// Container for all error elements.
type Error struct {
// The error code is a string that uniquely identifies an error condition. It is
// meant to be read and understood by programs that detect and handle errors by
// type. The following is a list of Amazon S3 error codes. For more information,
// see Error responses (https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html)
// .
// - Code: AccessDenied
// - Description: Access Denied
// - HTTP Status Code: 403 Forbidden
// - SOAP Fault Code Prefix: Client
// - Code: AccountProblem
// - Description: There is a problem with your Amazon Web Services account that
// prevents the action from completing successfully. Contact Amazon Web Services
// Support for further assistance.
// - HTTP Status Code: 403 Forbidden
// - SOAP Fault Code Prefix: Client
// - Code: AllAccessDisabled
// - Description: All access to this Amazon S3 resource has been disabled.
// Contact Amazon Web Services Support for further assistance.
// - HTTP Status Code: 403 Forbidden
// - SOAP Fault Code Prefix: Client
// - Code: AmbiguousGrantByEmailAddress
// - Description: The email address you provided is associated with more than
// one account.
// - HTTP Status Code: 400 Bad Request
// - SOAP Fault Code Prefix: Client
// - Code: AuthorizationHeaderMalformed
// - Description: The authorization header you provided is invalid.
// - HTTP Status Code: 400 Bad Request
// - HTTP Status Code: N/A
// - Code: BadDigest
// - Description: The Content-MD5 you specified did not match what we received.
// - HTTP Status Code: 400 Bad Request
// - SOAP Fault Code Prefix: Client
// - Code: BucketAlreadyExists
// - Description: The requested bucket name is not available. The bucket
// namespace is shared by all users of the system. Please select a different name
// and try again.
// - HTTP Status Code: 409 Conflict
// - SOAP Fault Code Prefix: Client
// - Code: BucketAlreadyOwnedByYou
// - Description: The bucket you tried to create already exists, and you own it.
// Amazon S3 returns this error in all Amazon Web Services Regions except in the
// North Virginia Region. For legacy compatibility, if you re-create an existing
// bucket that you already own in the North Virginia Region, Amazon S3 returns 200
// OK and resets the bucket access control lists (ACLs).
// - Code: 409 Conflict (in all Regions except the North Virginia Region)
// - SOAP Fault Code Prefix: Client
// - Code: BucketNotEmpty
// - Description: The bucket you tried to delete is not empty.
// - HTTP Status Code: 409 Conflict
// - SOAP Fault Code Prefix: Client
// - Code: CredentialsNotSupported
// - Description: This request does not support credentials.
// - HTTP Status Code: 400 Bad Request
// - SOAP Fault Code Prefix: Client
// - Code: CrossLocationLoggingProhibited
// - Description: Cross-location logging not allowed. Buckets in one geographic
// location cannot log information to a bucket in another location.
// - HTTP Status Code: 403 Forbidden
// - SOAP Fault Code Prefix: Client
// - Code: EntityTooSmall
// - Description: Your proposed upload is smaller than the minimum allowed
// object size.
// - HTTP Status Code: 400 Bad Request
// - SOAP Fault Code Prefix: Client
// - Code: EntityTooLarge
// - Description: Your proposed upload exceeds the maximum allowed object size.
// - HTTP Status Code: 400 Bad Request
// - SOAP Fault Code Prefix: Client
// - Code: ExpiredToken
// - Description: The provided token has expired.
// - HTTP Status Code: 400 Bad Request
// - SOAP Fault Code Prefix: Client
// - Code: IllegalVersioningConfigurationException
// - Description: Indicates that the versioning configuration specified in the
// request is invalid.
// - HTTP Status Code: 400 Bad Request
// - SOAP Fault Code Prefix: Client
// - Code: IncompleteBody
// - Description: You did not provide the number of bytes specified by the
// Content-Length HTTP header
// - HTTP Status Code: 400 Bad Request
// - SOAP Fault Code Prefix: Client
// - Code: IncorrectNumberOfFilesInPostRequest
// - Description: POST requires exactly one file upload per request.
// - HTTP Status Code: 400 Bad Request
// - SOAP Fault Code Prefix: Client
// - Code: InlineDataTooLarge
// - Description: Inline data exceeds the maximum allowed size.
// - HTTP Status Code: 400 Bad Request
// - SOAP Fault Code Prefix: Client
// - Code: InternalError
// - Description: We encountered an internal error. Please try again.
// - HTTP Status Code: 500 Internal Server Error
// - SOAP Fault Code Prefix: Server
// - Code: InvalidAccessKeyId
// - Description: The Amazon Web Services access key ID you provided does not
// exist in our records.
// - HTTP Status Code: 403 Forbidden
// - SOAP Fault Code Prefix: Client
// - Code: InvalidAddressingHeader
// - Description: You must specify the Anonymous role.
// - HTTP Status Code: N/A
// - SOAP Fault Code Prefix: Client
// - Code: InvalidArgument
// - Description: Invalid Argument
// - HTTP Status Code: 400 Bad Request
// - SOAP Fault Code Prefix: Client
// - Code: InvalidBucketName
// - Description: The specified bucket is not valid.
// - HTTP Status Code: 400 Bad Request
// - SOAP Fault Code Prefix: Client
// - Code: InvalidBucketState
// - Description: The request is not valid with the current state of the bucket.
// - HTTP Status Code: 409 Conflict
// - SOAP Fault Code Prefix: Client
// - Code: InvalidDigest
// - Description: The Content-MD5 you specified is not valid.
// - HTTP Status Code: 400 Bad Request
// - SOAP Fault Code Prefix: Client
// - Code: InvalidEncryptionAlgorithmError
// - Description: The encryption request you specified is not valid. The valid
// value is AES256.
// - HTTP Status Code: 400 Bad Request
// - SOAP Fault Code Prefix: Client
// - Code: InvalidLocationConstraint
// - Description: The specified location constraint is not valid. For more
// information about Regions, see How to Select a Region for Your Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html#access-bucket-intro)
// .
// - HTTP Status Code: 400 Bad Request
// - SOAP Fault Code Prefix: Client
// - Code: InvalidObjectState
// - Description: The action is not valid for the current state of the object.
// - HTTP Status Code: 403 Forbidden
// - SOAP Fault Code Prefix: Client
// - Code: InvalidPart
// - Description: One or more of the specified parts could not be found. The
// part might not have been uploaded, or the specified entity tag might not have
// matched the part's entity tag.
// - HTTP Status Code: 400 Bad Request
// - SOAP Fault Code Prefix: Client
// - Code: InvalidPartOrder
// - Description: The list of parts was not in ascending order. Parts list must
// be specified in order by part number.
// - HTTP Status Code: 400 Bad Request
// - SOAP Fault Code Prefix: Client
// - Code: InvalidPayer
// - Description: All access to this object has been disabled. Please contact
// Amazon Web Services Support for further assistance.
// - HTTP Status Code: 403 Forbidden
// - SOAP Fault Code Prefix: Client
// - Code: InvalidPolicyDocument
// - Description: The content of the form does not meet the conditions specified
// in the policy document.
// - HTTP Status Code: 400 Bad Request
// - SOAP Fault Code Prefix: Client
// - Code: InvalidRange
// - Description: The requested range cannot be satisfied.
// - HTTP Status Code: 416 Requested Range Not Satisfiable
// - SOAP Fault Code Prefix: Client
// - Code: InvalidRequest
// - Description: Please use AWS4-HMAC-SHA256 .
// - HTTP Status Code: 400 Bad Request
// - Code: N/A
// - Code: InvalidRequest
// - Description: SOAP requests must be made over an HTTPS connection.
// - HTTP Status Code: 400 Bad Request
// - SOAP Fault Code Prefix: Client
// - Code: InvalidRequest
// - Description: Amazon S3 Transfer Acceleration is not supported for buckets
// with non-DNS compliant names.
// - HTTP Status Code: 400 Bad Request
// - Code: N/A
// - Code: InvalidRequest
// - Description: Amazon S3 Transfer Acceleration is not supported for buckets
// with periods (.) in their names.
// - HTTP Status Code: 400 Bad Request
// - Code: N/A
// - Code: InvalidRequest
// - Description: Amazon S3 Transfer Accelerate endpoint only supports virtual
// style requests.
// - HTTP Status Code: 400 Bad Request