aws_sdk_s3/operation/upload_part/_upload_part_input.rs
1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2#[allow(missing_docs)] // documentation missing in model
3#[non_exhaustive]
4pub struct UploadPartInput {
5 /// <p>Object data.</p>
6 pub body: ::aws_smithy_types::byte_stream::ByteStream,
7 /// <p>The name of the bucket to which the multipart upload was initiated.</p>
8 /// <p><b>Directory buckets</b> - When you use this operation with a directory bucket, you must use virtual-hosted-style requests in the format <code> <i>Bucket-name</i>.s3express-<i>zone-id</i>.<i>region-code</i>.amazonaws.com</code>. Path-style requests are not supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names must follow the format <code> <i>bucket-base-name</i>--<i>zone-id</i>--x-s3</code> (for example, <code> <i>amzn-s3-demo-bucket</i>--<i>usw2-az1</i>--x-s3</code>). For information about bucket naming restrictions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html">Directory bucket naming rules</a> in the <i>Amazon S3 User Guide</i>.</p>
9 /// <p><b>Access points</b> - When you use this action with an access point for general purpose buckets, you must provide the alias of the access point in place of the bucket name or specify the access point ARN. When you use this action with an access point for directory buckets, you must provide the access point name in place of the bucket name. When using the access point ARN, you must direct requests to the access point hostname. The access point hostname takes the form <i>AccessPointName</i>-<i>AccountId</i>.s3-accesspoint.<i>Region</i>.amazonaws.com. When using this action with an access point through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html">Using access points</a> in the <i>Amazon S3 User Guide</i>.</p><note>
10 /// <p>Object Lambda access points are not supported by directory buckets.</p>
11 /// </note>
12 /// <p><b>S3 on Outposts</b> - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form <code> <i>AccessPointName</i>-<i>AccountId</i>.<i>outpostID</i>.s3-outposts.<i>Region</i>.amazonaws.com</code>. When you use this action with S3 on Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more information about S3 on Outposts, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html">What is S3 on Outposts?</a> in the <i>Amazon S3 User Guide</i>.</p>
13 pub bucket: ::std::option::Option<::std::string::String>,
14 /// <p>Size of the body in bytes. This parameter is useful when the size of the body cannot be determined automatically.</p>
15 pub content_length: ::std::option::Option<i64>,
16 /// <p>The Base64 encoded 128-bit MD5 digest of the part data. This parameter is auto-populated when using the command from the CLI. This parameter is required if object lock parameters are specified.</p><note>
17 /// <p>This functionality is not supported for directory buckets.</p>
18 /// </note>
19 pub content_md5: ::std::option::Option<::std::string::String>,
20 /// <p>Indicates the algorithm used to create the checksum for the object when you use the SDK. This header will not provide any additional functionality if you don't use the SDK. When you send this header, there must be a corresponding <code>x-amz-checksum</code> or <code>x-amz-trailer</code> header sent. Otherwise, Amazon S3 fails the request with the HTTP status code <code>400 Bad Request</code>. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
21 /// <p>If you provide an individual checksum, Amazon S3 ignores any provided <code>ChecksumAlgorithm</code> parameter.</p>
22 /// <p>This checksum algorithm must be the same for all parts and it match the checksum value supplied in the <code>CreateMultipartUpload</code> request.</p>
23 pub checksum_algorithm: ::std::option::Option<crate::types::ChecksumAlgorithm>,
24 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 32-bit <code>CRC32</code> checksum of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
25 pub checksum_crc32: ::std::option::Option<::std::string::String>,
26 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 32-bit <code>CRC32C</code> checksum of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
27 pub checksum_crc32_c: ::std::option::Option<::std::string::String>,
28 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 64-bit <code>CRC64NVME</code> checksum of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
29 pub checksum_crc64_nvme: ::std::option::Option<::std::string::String>,
30 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 160-bit <code>SHA1</code> digest of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
31 pub checksum_sha1: ::std::option::Option<::std::string::String>,
32 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 256-bit <code>SHA256</code> digest of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
33 pub checksum_sha256: ::std::option::Option<::std::string::String>,
34 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 512-bit <code>SHA512</code> digest of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
35 pub checksum_sha512: ::std::option::Option<::std::string::String>,
36 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 128-bit <code>MD5</code> digest of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
37 pub checksum_md5: ::std::option::Option<::std::string::String>,
38 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 64-bit <code>XXHASH64</code> checksum of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
39 pub checksum_xxhash64: ::std::option::Option<::std::string::String>,
40 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 64-bit <code>XXHASH3</code> checksum of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
41 pub checksum_xxhash3: ::std::option::Option<::std::string::String>,
42 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 128-bit <code>XXHASH128</code> checksum of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
43 pub checksum_xxhash128: ::std::option::Option<::std::string::String>,
44 /// <p>Object key for which the multipart upload was initiated.</p>
45 pub key: ::std::option::Option<::std::string::String>,
46 /// <p>Part number of part being uploaded. This is a positive integer between 1 and 10,000.</p>
47 pub part_number: ::std::option::Option<i32>,
48 /// <p>Upload ID identifying the multipart upload whose part is being uploaded.</p>
49 pub upload_id: ::std::option::Option<::std::string::String>,
50 /// <p>Specifies the algorithm to use when encrypting the object (for example, AES256).</p><note>
51 /// <p>This functionality is not supported for directory buckets.</p>
52 /// </note>
53 pub sse_customer_algorithm: ::std::option::Option<::std::string::String>,
54 /// <p>Specifies the customer-provided encryption key for Amazon S3 to use in encrypting data. This value is used to store the object and then it is discarded; Amazon S3 does not store the encryption key. The key must be appropriate for use with the algorithm specified in the <code>x-amz-server-side-encryption-customer-algorithm header</code>. This must be the same encryption key specified in the initiate multipart upload request.</p><note>
55 /// <p>This functionality is not supported for directory buckets.</p>
56 /// </note>
57 pub sse_customer_key: ::std::option::Option<::std::string::String>,
58 /// <p>Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321. Amazon S3 uses this header for a message integrity check to ensure that the encryption key was transmitted without error.</p><note>
59 /// <p>This functionality is not supported for directory buckets.</p>
60 /// </note>
61 pub sse_customer_key_md5: ::std::option::Option<::std::string::String>,
62 /// <p>Confirms that the requester knows that they will be charged for the request. Bucket owners need not specify this parameter in their requests. If either the source or destination S3 bucket has Requester Pays enabled, the requester will pay for the corresponding charges. For information about downloading objects from Requester Pays buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html">Downloading Objects in Requester Pays Buckets</a> in the <i>Amazon S3 User Guide</i>.</p><note>
63 /// <p>This functionality is not supported for directory buckets.</p>
64 /// </note>
65 pub request_payer: ::std::option::Option<crate::types::RequestPayer>,
66 /// <p>The account ID of the expected bucket owner. If the account ID that you provide does not match the actual owner of the bucket, the request fails with the HTTP status code <code>403 Forbidden</code> (access denied).</p>
67 pub expected_bucket_owner: ::std::option::Option<::std::string::String>,
68}
69impl UploadPartInput {
70 /// <p>Object data.</p>
71 pub fn body(&self) -> &::aws_smithy_types::byte_stream::ByteStream {
72 &self.body
73 }
74 /// <p>The name of the bucket to which the multipart upload was initiated.</p>
75 /// <p><b>Directory buckets</b> - When you use this operation with a directory bucket, you must use virtual-hosted-style requests in the format <code> <i>Bucket-name</i>.s3express-<i>zone-id</i>.<i>region-code</i>.amazonaws.com</code>. Path-style requests are not supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names must follow the format <code> <i>bucket-base-name</i>--<i>zone-id</i>--x-s3</code> (for example, <code> <i>amzn-s3-demo-bucket</i>--<i>usw2-az1</i>--x-s3</code>). For information about bucket naming restrictions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html">Directory bucket naming rules</a> in the <i>Amazon S3 User Guide</i>.</p>
76 /// <p><b>Access points</b> - When you use this action with an access point for general purpose buckets, you must provide the alias of the access point in place of the bucket name or specify the access point ARN. When you use this action with an access point for directory buckets, you must provide the access point name in place of the bucket name. When using the access point ARN, you must direct requests to the access point hostname. The access point hostname takes the form <i>AccessPointName</i>-<i>AccountId</i>.s3-accesspoint.<i>Region</i>.amazonaws.com. When using this action with an access point through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html">Using access points</a> in the <i>Amazon S3 User Guide</i>.</p><note>
77 /// <p>Object Lambda access points are not supported by directory buckets.</p>
78 /// </note>
79 /// <p><b>S3 on Outposts</b> - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form <code> <i>AccessPointName</i>-<i>AccountId</i>.<i>outpostID</i>.s3-outposts.<i>Region</i>.amazonaws.com</code>. When you use this action with S3 on Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more information about S3 on Outposts, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html">What is S3 on Outposts?</a> in the <i>Amazon S3 User Guide</i>.</p>
80 pub fn bucket(&self) -> ::std::option::Option<&str> {
81 self.bucket.as_deref()
82 }
83 /// <p>Size of the body in bytes. This parameter is useful when the size of the body cannot be determined automatically.</p>
84 pub fn content_length(&self) -> ::std::option::Option<i64> {
85 self.content_length
86 }
87 /// <p>The Base64 encoded 128-bit MD5 digest of the part data. This parameter is auto-populated when using the command from the CLI. This parameter is required if object lock parameters are specified.</p><note>
88 /// <p>This functionality is not supported for directory buckets.</p>
89 /// </note>
90 pub fn content_md5(&self) -> ::std::option::Option<&str> {
91 self.content_md5.as_deref()
92 }
93 /// <p>Indicates the algorithm used to create the checksum for the object when you use the SDK. This header will not provide any additional functionality if you don't use the SDK. When you send this header, there must be a corresponding <code>x-amz-checksum</code> or <code>x-amz-trailer</code> header sent. Otherwise, Amazon S3 fails the request with the HTTP status code <code>400 Bad Request</code>. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
94 /// <p>If you provide an individual checksum, Amazon S3 ignores any provided <code>ChecksumAlgorithm</code> parameter.</p>
95 /// <p>This checksum algorithm must be the same for all parts and it match the checksum value supplied in the <code>CreateMultipartUpload</code> request.</p>
96 pub fn checksum_algorithm(&self) -> ::std::option::Option<&crate::types::ChecksumAlgorithm> {
97 self.checksum_algorithm.as_ref()
98 }
99 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 32-bit <code>CRC32</code> checksum of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
100 pub fn checksum_crc32(&self) -> ::std::option::Option<&str> {
101 self.checksum_crc32.as_deref()
102 }
103 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 32-bit <code>CRC32C</code> checksum of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
104 pub fn checksum_crc32_c(&self) -> ::std::option::Option<&str> {
105 self.checksum_crc32_c.as_deref()
106 }
107 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 64-bit <code>CRC64NVME</code> checksum of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
108 pub fn checksum_crc64_nvme(&self) -> ::std::option::Option<&str> {
109 self.checksum_crc64_nvme.as_deref()
110 }
111 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 160-bit <code>SHA1</code> digest of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
112 pub fn checksum_sha1(&self) -> ::std::option::Option<&str> {
113 self.checksum_sha1.as_deref()
114 }
115 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 256-bit <code>SHA256</code> digest of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
116 pub fn checksum_sha256(&self) -> ::std::option::Option<&str> {
117 self.checksum_sha256.as_deref()
118 }
119 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 512-bit <code>SHA512</code> digest of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
120 pub fn checksum_sha512(&self) -> ::std::option::Option<&str> {
121 self.checksum_sha512.as_deref()
122 }
123 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 128-bit <code>MD5</code> digest of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
124 pub fn checksum_md5(&self) -> ::std::option::Option<&str> {
125 self.checksum_md5.as_deref()
126 }
127 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 64-bit <code>XXHASH64</code> checksum of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
128 pub fn checksum_xxhash64(&self) -> ::std::option::Option<&str> {
129 self.checksum_xxhash64.as_deref()
130 }
131 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 64-bit <code>XXHASH3</code> checksum of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
132 pub fn checksum_xxhash3(&self) -> ::std::option::Option<&str> {
133 self.checksum_xxhash3.as_deref()
134 }
135 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 128-bit <code>XXHASH128</code> checksum of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
136 pub fn checksum_xxhash128(&self) -> ::std::option::Option<&str> {
137 self.checksum_xxhash128.as_deref()
138 }
139 /// <p>Object key for which the multipart upload was initiated.</p>
140 pub fn key(&self) -> ::std::option::Option<&str> {
141 self.key.as_deref()
142 }
143 /// <p>Part number of part being uploaded. This is a positive integer between 1 and 10,000.</p>
144 pub fn part_number(&self) -> ::std::option::Option<i32> {
145 self.part_number
146 }
147 /// <p>Upload ID identifying the multipart upload whose part is being uploaded.</p>
148 pub fn upload_id(&self) -> ::std::option::Option<&str> {
149 self.upload_id.as_deref()
150 }
151 /// <p>Specifies the algorithm to use when encrypting the object (for example, AES256).</p><note>
152 /// <p>This functionality is not supported for directory buckets.</p>
153 /// </note>
154 pub fn sse_customer_algorithm(&self) -> ::std::option::Option<&str> {
155 self.sse_customer_algorithm.as_deref()
156 }
157 /// <p>Specifies the customer-provided encryption key for Amazon S3 to use in encrypting data. This value is used to store the object and then it is discarded; Amazon S3 does not store the encryption key. The key must be appropriate for use with the algorithm specified in the <code>x-amz-server-side-encryption-customer-algorithm header</code>. This must be the same encryption key specified in the initiate multipart upload request.</p><note>
158 /// <p>This functionality is not supported for directory buckets.</p>
159 /// </note>
160 pub fn sse_customer_key(&self) -> ::std::option::Option<&str> {
161 self.sse_customer_key.as_deref()
162 }
163 /// <p>Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321. Amazon S3 uses this header for a message integrity check to ensure that the encryption key was transmitted without error.</p><note>
164 /// <p>This functionality is not supported for directory buckets.</p>
165 /// </note>
166 pub fn sse_customer_key_md5(&self) -> ::std::option::Option<&str> {
167 self.sse_customer_key_md5.as_deref()
168 }
169 /// <p>Confirms that the requester knows that they will be charged for the request. Bucket owners need not specify this parameter in their requests. If either the source or destination S3 bucket has Requester Pays enabled, the requester will pay for the corresponding charges. For information about downloading objects from Requester Pays buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html">Downloading Objects in Requester Pays Buckets</a> in the <i>Amazon S3 User Guide</i>.</p><note>
170 /// <p>This functionality is not supported for directory buckets.</p>
171 /// </note>
172 pub fn request_payer(&self) -> ::std::option::Option<&crate::types::RequestPayer> {
173 self.request_payer.as_ref()
174 }
175 /// <p>The account ID of the expected bucket owner. If the account ID that you provide does not match the actual owner of the bucket, the request fails with the HTTP status code <code>403 Forbidden</code> (access denied).</p>
176 pub fn expected_bucket_owner(&self) -> ::std::option::Option<&str> {
177 self.expected_bucket_owner.as_deref()
178 }
179}
180impl ::std::fmt::Debug for UploadPartInput {
181 fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
182 let mut formatter = f.debug_struct("UploadPartInput");
183 formatter.field("body", &self.body);
184 formatter.field("bucket", &self.bucket);
185 formatter.field("content_length", &self.content_length);
186 formatter.field("content_md5", &self.content_md5);
187 formatter.field("checksum_algorithm", &self.checksum_algorithm);
188 formatter.field("checksum_crc32", &self.checksum_crc32);
189 formatter.field("checksum_crc32_c", &self.checksum_crc32_c);
190 formatter.field("checksum_crc64_nvme", &self.checksum_crc64_nvme);
191 formatter.field("checksum_sha1", &self.checksum_sha1);
192 formatter.field("checksum_sha256", &self.checksum_sha256);
193 formatter.field("checksum_sha512", &self.checksum_sha512);
194 formatter.field("checksum_md5", &self.checksum_md5);
195 formatter.field("checksum_xxhash64", &self.checksum_xxhash64);
196 formatter.field("checksum_xxhash3", &self.checksum_xxhash3);
197 formatter.field("checksum_xxhash128", &self.checksum_xxhash128);
198 formatter.field("key", &self.key);
199 formatter.field("part_number", &self.part_number);
200 formatter.field("upload_id", &self.upload_id);
201 formatter.field("sse_customer_algorithm", &self.sse_customer_algorithm);
202 formatter.field("sse_customer_key", &"*** Sensitive Data Redacted ***");
203 formatter.field("sse_customer_key_md5", &self.sse_customer_key_md5);
204 formatter.field("request_payer", &self.request_payer);
205 formatter.field("expected_bucket_owner", &self.expected_bucket_owner);
206 formatter.finish()
207 }
208}
209impl UploadPartInput {
210 /// Creates a new builder-style object to manufacture [`UploadPartInput`](crate::operation::upload_part::UploadPartInput).
211 pub fn builder() -> crate::operation::upload_part::builders::UploadPartInputBuilder {
212 crate::operation::upload_part::builders::UploadPartInputBuilder::default()
213 }
214}
215
216/// A builder for [`UploadPartInput`](crate::operation::upload_part::UploadPartInput).
217#[derive(::std::default::Default)]
218#[non_exhaustive]
219pub struct UploadPartInputBuilder {
220 pub(crate) body: ::std::option::Option<::aws_smithy_types::byte_stream::ByteStream>,
221 pub(crate) bucket: ::std::option::Option<::std::string::String>,
222 pub(crate) content_length: ::std::option::Option<i64>,
223 pub(crate) content_md5: ::std::option::Option<::std::string::String>,
224 pub(crate) checksum_algorithm: ::std::option::Option<crate::types::ChecksumAlgorithm>,
225 pub(crate) checksum_crc32: ::std::option::Option<::std::string::String>,
226 pub(crate) checksum_crc32_c: ::std::option::Option<::std::string::String>,
227 pub(crate) checksum_crc64_nvme: ::std::option::Option<::std::string::String>,
228 pub(crate) checksum_sha1: ::std::option::Option<::std::string::String>,
229 pub(crate) checksum_sha256: ::std::option::Option<::std::string::String>,
230 pub(crate) checksum_sha512: ::std::option::Option<::std::string::String>,
231 pub(crate) checksum_md5: ::std::option::Option<::std::string::String>,
232 pub(crate) checksum_xxhash64: ::std::option::Option<::std::string::String>,
233 pub(crate) checksum_xxhash3: ::std::option::Option<::std::string::String>,
234 pub(crate) checksum_xxhash128: ::std::option::Option<::std::string::String>,
235 pub(crate) key: ::std::option::Option<::std::string::String>,
236 pub(crate) part_number: ::std::option::Option<i32>,
237 pub(crate) upload_id: ::std::option::Option<::std::string::String>,
238 pub(crate) sse_customer_algorithm: ::std::option::Option<::std::string::String>,
239 pub(crate) sse_customer_key: ::std::option::Option<::std::string::String>,
240 pub(crate) sse_customer_key_md5: ::std::option::Option<::std::string::String>,
241 pub(crate) request_payer: ::std::option::Option<crate::types::RequestPayer>,
242 pub(crate) expected_bucket_owner: ::std::option::Option<::std::string::String>,
243}
244impl UploadPartInputBuilder {
245 /// <p>Object data.</p>
246 pub fn body(mut self, input: ::aws_smithy_types::byte_stream::ByteStream) -> Self {
247 self.body = ::std::option::Option::Some(input);
248 self
249 }
250 /// <p>Object data.</p>
251 pub fn set_body(mut self, input: ::std::option::Option<::aws_smithy_types::byte_stream::ByteStream>) -> Self {
252 self.body = input;
253 self
254 }
255 /// <p>Object data.</p>
256 pub fn get_body(&self) -> &::std::option::Option<::aws_smithy_types::byte_stream::ByteStream> {
257 &self.body
258 }
259 /// <p>The name of the bucket to which the multipart upload was initiated.</p>
260 /// <p><b>Directory buckets</b> - When you use this operation with a directory bucket, you must use virtual-hosted-style requests in the format <code> <i>Bucket-name</i>.s3express-<i>zone-id</i>.<i>region-code</i>.amazonaws.com</code>. Path-style requests are not supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names must follow the format <code> <i>bucket-base-name</i>--<i>zone-id</i>--x-s3</code> (for example, <code> <i>amzn-s3-demo-bucket</i>--<i>usw2-az1</i>--x-s3</code>). For information about bucket naming restrictions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html">Directory bucket naming rules</a> in the <i>Amazon S3 User Guide</i>.</p>
261 /// <p><b>Access points</b> - When you use this action with an access point for general purpose buckets, you must provide the alias of the access point in place of the bucket name or specify the access point ARN. When you use this action with an access point for directory buckets, you must provide the access point name in place of the bucket name. When using the access point ARN, you must direct requests to the access point hostname. The access point hostname takes the form <i>AccessPointName</i>-<i>AccountId</i>.s3-accesspoint.<i>Region</i>.amazonaws.com. When using this action with an access point through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html">Using access points</a> in the <i>Amazon S3 User Guide</i>.</p><note>
262 /// <p>Object Lambda access points are not supported by directory buckets.</p>
263 /// </note>
264 /// <p><b>S3 on Outposts</b> - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form <code> <i>AccessPointName</i>-<i>AccountId</i>.<i>outpostID</i>.s3-outposts.<i>Region</i>.amazonaws.com</code>. When you use this action with S3 on Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more information about S3 on Outposts, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html">What is S3 on Outposts?</a> in the <i>Amazon S3 User Guide</i>.</p>
265 /// This field is required.
266 pub fn bucket(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
267 self.bucket = ::std::option::Option::Some(input.into());
268 self
269 }
270 /// <p>The name of the bucket to which the multipart upload was initiated.</p>
271 /// <p><b>Directory buckets</b> - When you use this operation with a directory bucket, you must use virtual-hosted-style requests in the format <code> <i>Bucket-name</i>.s3express-<i>zone-id</i>.<i>region-code</i>.amazonaws.com</code>. Path-style requests are not supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names must follow the format <code> <i>bucket-base-name</i>--<i>zone-id</i>--x-s3</code> (for example, <code> <i>amzn-s3-demo-bucket</i>--<i>usw2-az1</i>--x-s3</code>). For information about bucket naming restrictions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html">Directory bucket naming rules</a> in the <i>Amazon S3 User Guide</i>.</p>
272 /// <p><b>Access points</b> - When you use this action with an access point for general purpose buckets, you must provide the alias of the access point in place of the bucket name or specify the access point ARN. When you use this action with an access point for directory buckets, you must provide the access point name in place of the bucket name. When using the access point ARN, you must direct requests to the access point hostname. The access point hostname takes the form <i>AccessPointName</i>-<i>AccountId</i>.s3-accesspoint.<i>Region</i>.amazonaws.com. When using this action with an access point through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html">Using access points</a> in the <i>Amazon S3 User Guide</i>.</p><note>
273 /// <p>Object Lambda access points are not supported by directory buckets.</p>
274 /// </note>
275 /// <p><b>S3 on Outposts</b> - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form <code> <i>AccessPointName</i>-<i>AccountId</i>.<i>outpostID</i>.s3-outposts.<i>Region</i>.amazonaws.com</code>. When you use this action with S3 on Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more information about S3 on Outposts, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html">What is S3 on Outposts?</a> in the <i>Amazon S3 User Guide</i>.</p>
276 pub fn set_bucket(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
277 self.bucket = input;
278 self
279 }
280 /// <p>The name of the bucket to which the multipart upload was initiated.</p>
281 /// <p><b>Directory buckets</b> - When you use this operation with a directory bucket, you must use virtual-hosted-style requests in the format <code> <i>Bucket-name</i>.s3express-<i>zone-id</i>.<i>region-code</i>.amazonaws.com</code>. Path-style requests are not supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names must follow the format <code> <i>bucket-base-name</i>--<i>zone-id</i>--x-s3</code> (for example, <code> <i>amzn-s3-demo-bucket</i>--<i>usw2-az1</i>--x-s3</code>). For information about bucket naming restrictions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html">Directory bucket naming rules</a> in the <i>Amazon S3 User Guide</i>.</p>
282 /// <p><b>Access points</b> - When you use this action with an access point for general purpose buckets, you must provide the alias of the access point in place of the bucket name or specify the access point ARN. When you use this action with an access point for directory buckets, you must provide the access point name in place of the bucket name. When using the access point ARN, you must direct requests to the access point hostname. The access point hostname takes the form <i>AccessPointName</i>-<i>AccountId</i>.s3-accesspoint.<i>Region</i>.amazonaws.com. When using this action with an access point through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html">Using access points</a> in the <i>Amazon S3 User Guide</i>.</p><note>
283 /// <p>Object Lambda access points are not supported by directory buckets.</p>
284 /// </note>
285 /// <p><b>S3 on Outposts</b> - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form <code> <i>AccessPointName</i>-<i>AccountId</i>.<i>outpostID</i>.s3-outposts.<i>Region</i>.amazonaws.com</code>. When you use this action with S3 on Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more information about S3 on Outposts, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html">What is S3 on Outposts?</a> in the <i>Amazon S3 User Guide</i>.</p>
286 pub fn get_bucket(&self) -> &::std::option::Option<::std::string::String> {
287 &self.bucket
288 }
289 /// <p>Size of the body in bytes. This parameter is useful when the size of the body cannot be determined automatically.</p>
290 pub fn content_length(mut self, input: i64) -> Self {
291 self.content_length = ::std::option::Option::Some(input);
292 self
293 }
294 /// <p>Size of the body in bytes. This parameter is useful when the size of the body cannot be determined automatically.</p>
295 pub fn set_content_length(mut self, input: ::std::option::Option<i64>) -> Self {
296 self.content_length = input;
297 self
298 }
299 /// <p>Size of the body in bytes. This parameter is useful when the size of the body cannot be determined automatically.</p>
300 pub fn get_content_length(&self) -> &::std::option::Option<i64> {
301 &self.content_length
302 }
303 /// <p>The Base64 encoded 128-bit MD5 digest of the part data. This parameter is auto-populated when using the command from the CLI. This parameter is required if object lock parameters are specified.</p><note>
304 /// <p>This functionality is not supported for directory buckets.</p>
305 /// </note>
306 pub fn content_md5(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
307 self.content_md5 = ::std::option::Option::Some(input.into());
308 self
309 }
310 /// <p>The Base64 encoded 128-bit MD5 digest of the part data. This parameter is auto-populated when using the command from the CLI. This parameter is required if object lock parameters are specified.</p><note>
311 /// <p>This functionality is not supported for directory buckets.</p>
312 /// </note>
313 pub fn set_content_md5(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
314 self.content_md5 = input;
315 self
316 }
317 /// <p>The Base64 encoded 128-bit MD5 digest of the part data. This parameter is auto-populated when using the command from the CLI. This parameter is required if object lock parameters are specified.</p><note>
318 /// <p>This functionality is not supported for directory buckets.</p>
319 /// </note>
320 pub fn get_content_md5(&self) -> &::std::option::Option<::std::string::String> {
321 &self.content_md5
322 }
323 /// <p>Indicates the algorithm used to create the checksum for the object when you use the SDK. This header will not provide any additional functionality if you don't use the SDK. When you send this header, there must be a corresponding <code>x-amz-checksum</code> or <code>x-amz-trailer</code> header sent. Otherwise, Amazon S3 fails the request with the HTTP status code <code>400 Bad Request</code>. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
324 /// <p>If you provide an individual checksum, Amazon S3 ignores any provided <code>ChecksumAlgorithm</code> parameter.</p>
325 /// <p>This checksum algorithm must be the same for all parts and it match the checksum value supplied in the <code>CreateMultipartUpload</code> request.</p>
326 pub fn checksum_algorithm(mut self, input: crate::types::ChecksumAlgorithm) -> Self {
327 self.checksum_algorithm = ::std::option::Option::Some(input);
328 self
329 }
330 /// <p>Indicates the algorithm used to create the checksum for the object when you use the SDK. This header will not provide any additional functionality if you don't use the SDK. When you send this header, there must be a corresponding <code>x-amz-checksum</code> or <code>x-amz-trailer</code> header sent. Otherwise, Amazon S3 fails the request with the HTTP status code <code>400 Bad Request</code>. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
331 /// <p>If you provide an individual checksum, Amazon S3 ignores any provided <code>ChecksumAlgorithm</code> parameter.</p>
332 /// <p>This checksum algorithm must be the same for all parts and it match the checksum value supplied in the <code>CreateMultipartUpload</code> request.</p>
333 pub fn set_checksum_algorithm(mut self, input: ::std::option::Option<crate::types::ChecksumAlgorithm>) -> Self {
334 self.checksum_algorithm = input;
335 self
336 }
337 /// <p>Indicates the algorithm used to create the checksum for the object when you use the SDK. This header will not provide any additional functionality if you don't use the SDK. When you send this header, there must be a corresponding <code>x-amz-checksum</code> or <code>x-amz-trailer</code> header sent. Otherwise, Amazon S3 fails the request with the HTTP status code <code>400 Bad Request</code>. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
338 /// <p>If you provide an individual checksum, Amazon S3 ignores any provided <code>ChecksumAlgorithm</code> parameter.</p>
339 /// <p>This checksum algorithm must be the same for all parts and it match the checksum value supplied in the <code>CreateMultipartUpload</code> request.</p>
340 pub fn get_checksum_algorithm(&self) -> &::std::option::Option<crate::types::ChecksumAlgorithm> {
341 &self.checksum_algorithm
342 }
343 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 32-bit <code>CRC32</code> checksum of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
344 pub fn checksum_crc32(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
345 self.checksum_crc32 = ::std::option::Option::Some(input.into());
346 self
347 }
348 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 32-bit <code>CRC32</code> checksum of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
349 pub fn set_checksum_crc32(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
350 self.checksum_crc32 = input;
351 self
352 }
353 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 32-bit <code>CRC32</code> checksum of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
354 pub fn get_checksum_crc32(&self) -> &::std::option::Option<::std::string::String> {
355 &self.checksum_crc32
356 }
357 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 32-bit <code>CRC32C</code> checksum of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
358 pub fn checksum_crc32_c(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
359 self.checksum_crc32_c = ::std::option::Option::Some(input.into());
360 self
361 }
362 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 32-bit <code>CRC32C</code> checksum of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
363 pub fn set_checksum_crc32_c(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
364 self.checksum_crc32_c = input;
365 self
366 }
367 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 32-bit <code>CRC32C</code> checksum of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
368 pub fn get_checksum_crc32_c(&self) -> &::std::option::Option<::std::string::String> {
369 &self.checksum_crc32_c
370 }
371 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 64-bit <code>CRC64NVME</code> checksum of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
372 pub fn checksum_crc64_nvme(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
373 self.checksum_crc64_nvme = ::std::option::Option::Some(input.into());
374 self
375 }
376 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 64-bit <code>CRC64NVME</code> checksum of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
377 pub fn set_checksum_crc64_nvme(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
378 self.checksum_crc64_nvme = input;
379 self
380 }
381 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 64-bit <code>CRC64NVME</code> checksum of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
382 pub fn get_checksum_crc64_nvme(&self) -> &::std::option::Option<::std::string::String> {
383 &self.checksum_crc64_nvme
384 }
385 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 160-bit <code>SHA1</code> digest of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
386 pub fn checksum_sha1(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
387 self.checksum_sha1 = ::std::option::Option::Some(input.into());
388 self
389 }
390 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 160-bit <code>SHA1</code> digest of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
391 pub fn set_checksum_sha1(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
392 self.checksum_sha1 = input;
393 self
394 }
395 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 160-bit <code>SHA1</code> digest of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
396 pub fn get_checksum_sha1(&self) -> &::std::option::Option<::std::string::String> {
397 &self.checksum_sha1
398 }
399 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 256-bit <code>SHA256</code> digest of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
400 pub fn checksum_sha256(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
401 self.checksum_sha256 = ::std::option::Option::Some(input.into());
402 self
403 }
404 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 256-bit <code>SHA256</code> digest of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
405 pub fn set_checksum_sha256(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
406 self.checksum_sha256 = input;
407 self
408 }
409 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 256-bit <code>SHA256</code> digest of the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
410 pub fn get_checksum_sha256(&self) -> &::std::option::Option<::std::string::String> {
411 &self.checksum_sha256
412 }
413 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 512-bit <code>SHA512</code> digest of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
414 pub fn checksum_sha512(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
415 self.checksum_sha512 = ::std::option::Option::Some(input.into());
416 self
417 }
418 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 512-bit <code>SHA512</code> digest of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
419 pub fn set_checksum_sha512(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
420 self.checksum_sha512 = input;
421 self
422 }
423 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 512-bit <code>SHA512</code> digest of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
424 pub fn get_checksum_sha512(&self) -> &::std::option::Option<::std::string::String> {
425 &self.checksum_sha512
426 }
427 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 128-bit <code>MD5</code> digest of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
428 pub fn checksum_md5(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
429 self.checksum_md5 = ::std::option::Option::Some(input.into());
430 self
431 }
432 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 128-bit <code>MD5</code> digest of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
433 pub fn set_checksum_md5(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
434 self.checksum_md5 = input;
435 self
436 }
437 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 128-bit <code>MD5</code> digest of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
438 pub fn get_checksum_md5(&self) -> &::std::option::Option<::std::string::String> {
439 &self.checksum_md5
440 }
441 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 64-bit <code>XXHASH64</code> checksum of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
442 pub fn checksum_xxhash64(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
443 self.checksum_xxhash64 = ::std::option::Option::Some(input.into());
444 self
445 }
446 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 64-bit <code>XXHASH64</code> checksum of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
447 pub fn set_checksum_xxhash64(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
448 self.checksum_xxhash64 = input;
449 self
450 }
451 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 64-bit <code>XXHASH64</code> checksum of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
452 pub fn get_checksum_xxhash64(&self) -> &::std::option::Option<::std::string::String> {
453 &self.checksum_xxhash64
454 }
455 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 64-bit <code>XXHASH3</code> checksum of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
456 pub fn checksum_xxhash3(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
457 self.checksum_xxhash3 = ::std::option::Option::Some(input.into());
458 self
459 }
460 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 64-bit <code>XXHASH3</code> checksum of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
461 pub fn set_checksum_xxhash3(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
462 self.checksum_xxhash3 = input;
463 self
464 }
465 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 64-bit <code>XXHASH3</code> checksum of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
466 pub fn get_checksum_xxhash3(&self) -> &::std::option::Option<::std::string::String> {
467 &self.checksum_xxhash3
468 }
469 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 128-bit <code>XXHASH128</code> checksum of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
470 pub fn checksum_xxhash128(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
471 self.checksum_xxhash128 = ::std::option::Option::Some(input.into());
472 self
473 }
474 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 128-bit <code>XXHASH128</code> checksum of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
475 pub fn set_checksum_xxhash128(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
476 self.checksum_xxhash128 = input;
477 self
478 }
479 /// <p>This header can be used as a data integrity check to verify that the data received is the same data that was originally sent. This header specifies the Base64 encoded, 128-bit <code>XXHASH128</code> checksum of the part. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
480 pub fn get_checksum_xxhash128(&self) -> &::std::option::Option<::std::string::String> {
481 &self.checksum_xxhash128
482 }
483 /// <p>Object key for which the multipart upload was initiated.</p>
484 /// This field is required.
485 pub fn key(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
486 self.key = ::std::option::Option::Some(input.into());
487 self
488 }
489 /// <p>Object key for which the multipart upload was initiated.</p>
490 pub fn set_key(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
491 self.key = input;
492 self
493 }
494 /// <p>Object key for which the multipart upload was initiated.</p>
495 pub fn get_key(&self) -> &::std::option::Option<::std::string::String> {
496 &self.key
497 }
498 /// <p>Part number of part being uploaded. This is a positive integer between 1 and 10,000.</p>
499 /// This field is required.
500 pub fn part_number(mut self, input: i32) -> Self {
501 self.part_number = ::std::option::Option::Some(input);
502 self
503 }
504 /// <p>Part number of part being uploaded. This is a positive integer between 1 and 10,000.</p>
505 pub fn set_part_number(mut self, input: ::std::option::Option<i32>) -> Self {
506 self.part_number = input;
507 self
508 }
509 /// <p>Part number of part being uploaded. This is a positive integer between 1 and 10,000.</p>
510 pub fn get_part_number(&self) -> &::std::option::Option<i32> {
511 &self.part_number
512 }
513 /// <p>Upload ID identifying the multipart upload whose part is being uploaded.</p>
514 /// This field is required.
515 pub fn upload_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
516 self.upload_id = ::std::option::Option::Some(input.into());
517 self
518 }
519 /// <p>Upload ID identifying the multipart upload whose part is being uploaded.</p>
520 pub fn set_upload_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
521 self.upload_id = input;
522 self
523 }
524 /// <p>Upload ID identifying the multipart upload whose part is being uploaded.</p>
525 pub fn get_upload_id(&self) -> &::std::option::Option<::std::string::String> {
526 &self.upload_id
527 }
528 /// <p>Specifies the algorithm to use when encrypting the object (for example, AES256).</p><note>
529 /// <p>This functionality is not supported for directory buckets.</p>
530 /// </note>
531 pub fn sse_customer_algorithm(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
532 self.sse_customer_algorithm = ::std::option::Option::Some(input.into());
533 self
534 }
535 /// <p>Specifies the algorithm to use when encrypting the object (for example, AES256).</p><note>
536 /// <p>This functionality is not supported for directory buckets.</p>
537 /// </note>
538 pub fn set_sse_customer_algorithm(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
539 self.sse_customer_algorithm = input;
540 self
541 }
542 /// <p>Specifies the algorithm to use when encrypting the object (for example, AES256).</p><note>
543 /// <p>This functionality is not supported for directory buckets.</p>
544 /// </note>
545 pub fn get_sse_customer_algorithm(&self) -> &::std::option::Option<::std::string::String> {
546 &self.sse_customer_algorithm
547 }
548 /// <p>Specifies the customer-provided encryption key for Amazon S3 to use in encrypting data. This value is used to store the object and then it is discarded; Amazon S3 does not store the encryption key. The key must be appropriate for use with the algorithm specified in the <code>x-amz-server-side-encryption-customer-algorithm header</code>. This must be the same encryption key specified in the initiate multipart upload request.</p><note>
549 /// <p>This functionality is not supported for directory buckets.</p>
550 /// </note>
551 pub fn sse_customer_key(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
552 self.sse_customer_key = ::std::option::Option::Some(input.into());
553 self
554 }
555 /// <p>Specifies the customer-provided encryption key for Amazon S3 to use in encrypting data. This value is used to store the object and then it is discarded; Amazon S3 does not store the encryption key. The key must be appropriate for use with the algorithm specified in the <code>x-amz-server-side-encryption-customer-algorithm header</code>. This must be the same encryption key specified in the initiate multipart upload request.</p><note>
556 /// <p>This functionality is not supported for directory buckets.</p>
557 /// </note>
558 pub fn set_sse_customer_key(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
559 self.sse_customer_key = input;
560 self
561 }
562 /// <p>Specifies the customer-provided encryption key for Amazon S3 to use in encrypting data. This value is used to store the object and then it is discarded; Amazon S3 does not store the encryption key. The key must be appropriate for use with the algorithm specified in the <code>x-amz-server-side-encryption-customer-algorithm header</code>. This must be the same encryption key specified in the initiate multipart upload request.</p><note>
563 /// <p>This functionality is not supported for directory buckets.</p>
564 /// </note>
565 pub fn get_sse_customer_key(&self) -> &::std::option::Option<::std::string::String> {
566 &self.sse_customer_key
567 }
568 /// <p>Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321. Amazon S3 uses this header for a message integrity check to ensure that the encryption key was transmitted without error.</p><note>
569 /// <p>This functionality is not supported for directory buckets.</p>
570 /// </note>
571 pub fn sse_customer_key_md5(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
572 self.sse_customer_key_md5 = ::std::option::Option::Some(input.into());
573 self
574 }
575 /// <p>Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321. Amazon S3 uses this header for a message integrity check to ensure that the encryption key was transmitted without error.</p><note>
576 /// <p>This functionality is not supported for directory buckets.</p>
577 /// </note>
578 pub fn set_sse_customer_key_md5(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
579 self.sse_customer_key_md5 = input;
580 self
581 }
582 /// <p>Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321. Amazon S3 uses this header for a message integrity check to ensure that the encryption key was transmitted without error.</p><note>
583 /// <p>This functionality is not supported for directory buckets.</p>
584 /// </note>
585 pub fn get_sse_customer_key_md5(&self) -> &::std::option::Option<::std::string::String> {
586 &self.sse_customer_key_md5
587 }
588 /// <p>Confirms that the requester knows that they will be charged for the request. Bucket owners need not specify this parameter in their requests. If either the source or destination S3 bucket has Requester Pays enabled, the requester will pay for the corresponding charges. For information about downloading objects from Requester Pays buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html">Downloading Objects in Requester Pays Buckets</a> in the <i>Amazon S3 User Guide</i>.</p><note>
589 /// <p>This functionality is not supported for directory buckets.</p>
590 /// </note>
591 pub fn request_payer(mut self, input: crate::types::RequestPayer) -> Self {
592 self.request_payer = ::std::option::Option::Some(input);
593 self
594 }
595 /// <p>Confirms that the requester knows that they will be charged for the request. Bucket owners need not specify this parameter in their requests. If either the source or destination S3 bucket has Requester Pays enabled, the requester will pay for the corresponding charges. For information about downloading objects from Requester Pays buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html">Downloading Objects in Requester Pays Buckets</a> in the <i>Amazon S3 User Guide</i>.</p><note>
596 /// <p>This functionality is not supported for directory buckets.</p>
597 /// </note>
598 pub fn set_request_payer(mut self, input: ::std::option::Option<crate::types::RequestPayer>) -> Self {
599 self.request_payer = input;
600 self
601 }
602 /// <p>Confirms that the requester knows that they will be charged for the request. Bucket owners need not specify this parameter in their requests. If either the source or destination S3 bucket has Requester Pays enabled, the requester will pay for the corresponding charges. For information about downloading objects from Requester Pays buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html">Downloading Objects in Requester Pays Buckets</a> in the <i>Amazon S3 User Guide</i>.</p><note>
603 /// <p>This functionality is not supported for directory buckets.</p>
604 /// </note>
605 pub fn get_request_payer(&self) -> &::std::option::Option<crate::types::RequestPayer> {
606 &self.request_payer
607 }
608 /// <p>The account ID of the expected bucket owner. If the account ID that you provide does not match the actual owner of the bucket, the request fails with the HTTP status code <code>403 Forbidden</code> (access denied).</p>
609 pub fn expected_bucket_owner(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
610 self.expected_bucket_owner = ::std::option::Option::Some(input.into());
611 self
612 }
613 /// <p>The account ID of the expected bucket owner. If the account ID that you provide does not match the actual owner of the bucket, the request fails with the HTTP status code <code>403 Forbidden</code> (access denied).</p>
614 pub fn set_expected_bucket_owner(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
615 self.expected_bucket_owner = input;
616 self
617 }
618 /// <p>The account ID of the expected bucket owner. If the account ID that you provide does not match the actual owner of the bucket, the request fails with the HTTP status code <code>403 Forbidden</code> (access denied).</p>
619 pub fn get_expected_bucket_owner(&self) -> &::std::option::Option<::std::string::String> {
620 &self.expected_bucket_owner
621 }
622 /// Consumes the builder and constructs a [`UploadPartInput`](crate::operation::upload_part::UploadPartInput).
623 pub fn build(self) -> ::std::result::Result<crate::operation::upload_part::UploadPartInput, ::aws_smithy_types::error::operation::BuildError> {
624 ::std::result::Result::Ok(crate::operation::upload_part::UploadPartInput {
625 body: self.body.unwrap_or_default(),
626 bucket: self.bucket,
627 content_length: self.content_length,
628 content_md5: self.content_md5,
629 checksum_algorithm: self.checksum_algorithm,
630 checksum_crc32: self.checksum_crc32,
631 checksum_crc32_c: self.checksum_crc32_c,
632 checksum_crc64_nvme: self.checksum_crc64_nvme,
633 checksum_sha1: self.checksum_sha1,
634 checksum_sha256: self.checksum_sha256,
635 checksum_sha512: self.checksum_sha512,
636 checksum_md5: self.checksum_md5,
637 checksum_xxhash64: self.checksum_xxhash64,
638 checksum_xxhash3: self.checksum_xxhash3,
639 checksum_xxhash128: self.checksum_xxhash128,
640 key: self.key,
641 part_number: self.part_number,
642 upload_id: self.upload_id,
643 sse_customer_algorithm: self.sse_customer_algorithm,
644 sse_customer_key: self.sse_customer_key,
645 sse_customer_key_md5: self.sse_customer_key_md5,
646 request_payer: self.request_payer,
647 expected_bucket_owner: self.expected_bucket_owner,
648 })
649 }
650}
651impl ::std::fmt::Debug for UploadPartInputBuilder {
652 fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
653 let mut formatter = f.debug_struct("UploadPartInputBuilder");
654 formatter.field("body", &self.body);
655 formatter.field("bucket", &self.bucket);
656 formatter.field("content_length", &self.content_length);
657 formatter.field("content_md5", &self.content_md5);
658 formatter.field("checksum_algorithm", &self.checksum_algorithm);
659 formatter.field("checksum_crc32", &self.checksum_crc32);
660 formatter.field("checksum_crc32_c", &self.checksum_crc32_c);
661 formatter.field("checksum_crc64_nvme", &self.checksum_crc64_nvme);
662 formatter.field("checksum_sha1", &self.checksum_sha1);
663 formatter.field("checksum_sha256", &self.checksum_sha256);
664 formatter.field("checksum_sha512", &self.checksum_sha512);
665 formatter.field("checksum_md5", &self.checksum_md5);
666 formatter.field("checksum_xxhash64", &self.checksum_xxhash64);
667 formatter.field("checksum_xxhash3", &self.checksum_xxhash3);
668 formatter.field("checksum_xxhash128", &self.checksum_xxhash128);
669 formatter.field("key", &self.key);
670 formatter.field("part_number", &self.part_number);
671 formatter.field("upload_id", &self.upload_id);
672 formatter.field("sse_customer_algorithm", &self.sse_customer_algorithm);
673 formatter.field("sse_customer_key", &"*** Sensitive Data Redacted ***");
674 formatter.field("sse_customer_key_md5", &self.sse_customer_key_md5);
675 formatter.field("request_payer", &self.request_payer);
676 formatter.field("expected_bucket_owner", &self.expected_bucket_owner);
677 formatter.finish()
678 }
679}