AWS cli documentation change
Summary
Added support for new checksum algorithms (SHA512, MD5, XXHASH64, XXHASH3, XXHASH128) in the complete-multipart-upload command, including CLI parameters, request/response fields, and updated syntax examples
Security assessment
This change adds documentation for new checksum options that enhance data integrity verification capabilities. While checksums are security-adjacent features for data integrity, there is no evidence in the diff that this addresses a specific security vulnerability or incident. The change expands existing checksum support with additional algorithms.
Diff
diff --git a/cli/latest/reference/s3api/complete-multipart-upload.md b/cli/latest/reference/s3api/complete-multipart-upload.md index 7eafa30fa..d62c881fa 100644 --- a//cli/latest/reference/s3api/complete-multipart-upload.md +++ b//cli/latest/reference/s3api/complete-multipart-upload.md @@ -15 +15 @@ - * [AWS CLI 2.34.34 Command Reference](../../index.html) » + * [AWS CLI 2.34.37 Command Reference](../../index.html) » @@ -138,0 +139,5 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/s3-200 + [--checksum-sha512 <value>] + [--checksum-md5 <value>] + [--checksum-xxhash64 <value>] + [--checksum-xxhash3 <value>] + [--checksum-xxhash128 <value>] @@ -225 +230 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/s3-200 ->>>> The Base64 encoded, 64-bit `CRC64NVME` checksum of the part. This checksum is present if the multipart upload request was created with the `CRC64NVME` checksum algorithm to the uploaded 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_ . +>>>> The Base64 encoded, 64-bit `CRC64NVME` checksum of the part. This checksum is present if the multipart upload request was created with the `CRC64NVME` checksum algorithm. 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_ . @@ -234,0 +240,20 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/s3-200 +>>> ChecksumSHA512 -> (string) +>>> +>>>> The Base64 encoded, 512-bit `SHA512` digest of the part. This checksum is present if the multipart upload request was created with the `SHA512` checksum algorithm. 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_ . +>>> +>>> ChecksumMD5 -> (string) +>>> +>>>> The Base64 encoded, 128-bit `MD5` digest of the part. This checksum is present if the multipart upload request was created with the `MD5` checksum algorithm. 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_ . +>>> +>>> ChecksumXXHASH64 -> (string) +>>> +>>>> The Base64 encoded, 64-bit `XXHASH64` checksum of the part. This checksum is present if the multipart upload request was created with the `XXHASH64` checksum algorithm. 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_ . +>>> +>>> ChecksumXXHASH3 -> (string) +>>> +>>>> The Base64 encoded, 64-bit `XXHASH3` checksum of the part. This checksum is present if the multipart upload request was created with the `XXHASH3` checksum algorithm. 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_ . +>>> +>>> ChecksumXXHASH128 -> (string) +>>> +>>>> The Base64 encoded, 128-bit `XXHASH128` checksum of the part. This checksum is present if the multipart upload request was created with the `XXHASH128` checksum algorithm. 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_ . +>>> @@ -249 +274 @@ Shorthand Syntax: - Parts=[{ETag=string,ChecksumCRC32=string,ChecksumCRC32C=string,ChecksumCRC64NVME=string,ChecksumSHA1=string,ChecksumSHA256=string,PartNumber=integer},{ETag=string,ChecksumCRC32=string,ChecksumCRC32C=string,ChecksumCRC64NVME=string,ChecksumSHA1=string,ChecksumSHA256=string,PartNumber=integer}] + Parts=[{ETag=string,ChecksumCRC32=string,ChecksumCRC32C=string,ChecksumCRC64NVME=string,ChecksumSHA1=string,ChecksumSHA256=string,ChecksumSHA512=string,ChecksumMD5=string,ChecksumXXHASH64=string,ChecksumXXHASH3=string,ChecksumXXHASH128=string,PartNumber=integer},{ETag=string,ChecksumCRC32=string,ChecksumCRC32C=string,ChecksumCRC64NVME=string,ChecksumSHA1=string,ChecksumSHA256=string,ChecksumSHA512=string,ChecksumMD5=string,ChecksumXXHASH64=string,ChecksumXXHASH3=string,ChecksumXXHASH128=string,PartNumber=integer}] @@ -263,0 +289,5 @@ JSON Syntax: + "ChecksumSHA512": "string", + "ChecksumMD5": "string", + "ChecksumXXHASH64": "string", + "ChecksumXXHASH3": "string", + "ChecksumXXHASH128": "string", @@ -294,0 +325,20 @@ JSON Syntax: +`--checksum-sha512` (string) + +> 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 `SHA512` digest of the object. For more information, see [Checking object integrity in the Amazon S3 User Guide](https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html) . + +`--checksum-md5` (string) + +> 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 `MD5` digest of the object. For more information, see [Checking object integrity in the Amazon S3 User Guide](https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html) . + +`--checksum-xxhash64` (string) + +> 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 `XXHASH64` checksum of the object. For more information, see [Checking object integrity in the Amazon S3 User Guide](https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html) . + +`--checksum-xxhash3` (string) + +> 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 `XXHASH3` checksum of the object. For more information, see [Checking object integrity in the Amazon S3 User Guide](https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html) . + +`--checksum-xxhash128` (string) + +> 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 `XXHASH128` checksum of the object. For more information, see [Checking object integrity in the Amazon S3 User Guide](https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html) . + @@ -590,0 +641,20 @@ ChecksumSHA256 -> (string) +ChecksumSHA512 -> (string) + +> The Base64 encoded, 512-bit `SHA512` digest of the object. For more information, see [Checking object integrity in the Amazon S3 User Guide](https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html) . + +ChecksumMD5 -> (string) + +> The Base64 encoded, 128-bit `MD5` digest of the object. For more information, see [Checking object integrity in the Amazon S3 User Guide](https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html) . + +ChecksumXXHASH64 -> (string) + +> The Base64 encoded, 64-bit `XXHASH64` checksum of the object. For more information, see [Checking object integrity in the Amazon S3 User Guide](https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html) . + +ChecksumXXHASH3 -> (string) + +> The Base64 encoded, 64-bit `XXHASH3` checksum of the object. For more information, see [Checking object integrity in the Amazon S3 User Guide](https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html) . + +ChecksumXXHASH128 -> (string) + +> The Base64 encoded, 128-bit `XXHASH128` checksum of the object. For more information, see [Checking object integrity in the Amazon S3 User Guide](https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html) . + @@ -659 +729 @@ RequestCharged -> (string) - * [AWS CLI 2.34.34 Command Reference](../../index.html) » + * [AWS CLI 2.34.37 Command Reference](../../index.html) »