CmdID

CmdID / aws / aws s3api

aws s3api put-object

End of support notice: As of October 1, 2025, Amazon S3 has discontinued support for Email Grantee Access Control Lists (ACLs). AWS CLI reference

40 options Its page in the AWS CLI reference

Opens CmdID with your command. It is read in your browser and sent nowhere.

Options

40 in the AWS CLI reference
Show its 40 options
--aclThe canned ACL to apply to the object.
--bodyObject data.
--bucket-key-enabledSpecifies whether Amazon S3 should use an S3 Bucket Key for object encryption with server-side encryption using Key Management Service (KMS) keys (SSE-KMS).
--bucketThe bucket name to which the PUT action was initiated.
--cache-controlCan be used to specify caching behavior along the request/reply chain.
--checksum-algorithmIndicates the algorithm used to create the checksum for the object when you use the SDK.
--checksum-crc64-nvme, --checksum-xxhash128, --checksum-xxhash64, --checksum-crc32-c, --checksum-xxhash3, --checksum-sha256, --checksum-sha512, --checksum-crc32, --checksum-sha1, --checksum-md5This header can be used as a data integrity check to verify that the data received is the same data that was originally sent.
--content-dispositionSpecifies presentational information for the object.
--content-encodingSpecifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field.
--content-languageThe language the content is in.
--content-lengthSize of the body in bytes.
--content-md5The Base64 encoded 128-bit MD5 digest of the message (without the headers) according to RFC 1864.
--content-typeA standard MIME type describing the format of the contents.
--expected-bucket-ownerThe account ID of the expected bucket owner.
--expiresThe date and time at which the object is no longer cacheable.
--grant-full-controlGives the grantee READ, READ_ACP, and WRITE_ACP permissions on the object.
--grant-read-acpAllows grantee to read the object ACL.
--grant-readAllows grantee to read the object data and its metadata.
--grant-write-acpAllows grantee to write the ACL for the applicable object.
--if-matchUploads the object only if the ETag (entity tag) value provided during the WRITE operation matches the ETag of the object in S3.
--if-none-matchUploads the object only if the object key name does not already exist in the bucket specified.
--keyObject key for which the PUT action was initiated.
--metadataA map of metadata to store with the object in S3.
--object-lock-event-hold-duration-daysSpecifies the event hold duration in days to apply to this object.
--object-lock-event-hold-duration-yearsSpecifies the event hold duration in years to apply to this object.
--object-lock-event-holdSpecifies the event hold status to apply to this object.
--object-lock-legal-hold-statusSpecifies whether a legal hold will be applied to this object.
--object-lock-modeThe Object Lock mode that you want to apply to this object.
--object-lock-retain-until-dateThe date and time when you want this object's Object Lock to expire.
--request-payerConfirms that the requester knows that they will be charged for the request.
--server-side-encryptionThe server-side encryption algorithm that was used when you store this object in Amazon S3 or Amazon FSx.
--sse-customer-algorithmSpecifies the algorithm to use when encrypting the object (for example, AES256).
--sse-customer-key-md5Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321.
--sse-customer-keySpecifies the customer-provided encryption key for Amazon S3 to use in encrypting data.
--ssekms-encryption-contextSpecifies the Amazon Web Services KMS Encryption Context as an additional encryption context to use for object encryption.
--ssekms-key-idSpecifies the KMS key ID (Key ID, Key ARN, or Key Alias) to use for object encryption.
--storage-classBy default, Amazon S3 uses the STANDARD Storage Class to store newly created objects.
--taggingThe tag-set for the object.
--website-redirect-locationIf the bucket is configured as a website, redirects requests for this object to another object in the same bucket or to an external URL.
--write-offset-bytesSpecifies the offset for appending data to existing objects in bytes.