boto3 icon indicating copy to clipboard operation
boto3 copied to clipboard

"the object was uploaded with the object"

Open riv-jkambites opened this issue 3 months ago • 1 comments

Describe the issue

The documentation for S3.Object.checksum_sha256 reads as follows (my bold):

The Base64 encoded, 256-bit SHA256 digest of the object. This will only be present if the object 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.

It's very unclear to me what "the object was uploaded with the object" is supposed to mean. The only thing I can guess is that it means the upload was not multipart, except that contradicts the following sentence, which implies the checksum will be present for multipart upload and will be a calculation based on the checksums of each part.

IMO this could do with some clarification - I'd glady do it myself, but I don't know enough to be confident of getting it right.

Links

https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3/object/checksum_sha256.html

riv-jkambites avatar Oct 06 '25 14:10 riv-jkambites

Hello @riv-jkambites, thanks for reaching out. I have reached out to the S3 Service Team in regards to their documentation for clarifying information in regards. An update will be given once the team has given any updates.

Internal Ref: P311980059

adev-code avatar Oct 06 '25 18:10 adev-code