CmdID / aws / aws s3api

aws s3api create-multipart-upload

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

1 example 34 options Its page in the AWS CLI reference

Examples

from aws-cli, each command read by CmdID

To create a multipart upload

The following create-multipart-upload example creates a multipart upload in the bucket amzn-s3-demo-bucket with the key multipart/01.

aws s3api create-multipart-upload --bucket amzn-s3-demo-bucket --key 'multipart/01'Identify

--bucketThe name of the bucket where the multipart upload is initiated and where the object is uploaded.

--keyObject key for which the multipart upload is to be initiated.

Its output

{
    "Bucket": "amzn-s3-demo-bucket",
    "UploadId": "dfRtDYU0WWCCcH43C3WFbkRONycyCpTJJvxu2i5GYkZljF.Yxwh6XG7WfS2vC4to6HiV6Yjlx.cph0gtNBtJ8P3URCSbB7rjxI5iEwVDmgaXZOGgkk5nVTW16HOQ5l0R",
    "Key": "multipart/01"
}

The completed file will be named 01 in a folder called multipart in the bucket amzn-s3-demo-bucket. Save the upload ID, key and bucket name for use with the upload-part command.

For more information, see Uploading and copying objects using multipart upload in Amazon S3 in the Amazon S3 User Guide.

Options

34 in the AWS CLI reference

Show its 34 options

--aclThe canned ACL to apply to the object.

--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 name of the bucket where the multipart upload is initiated and where the object is uploaded.

--cache-controlSpecifies caching behavior along the request/reply chain.

--checksum-algorithmIndicates the algorithm that you want Amazon S3 to use to create the checksum for the object.

--checksum-typeIndicates the checksum type that you want Amazon S3 to use to calculate the object’s checksum value.

--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 that the content is in.

--content-typeA standard MIME type describing the format of the object data.

--expected-bucket-ownerThe account ID of the expected bucket owner.

--expiresThe date and time at which the object is no longer cacheable.

--grant-full-controlSpecify access permissions explicitly to give the grantee READ, READ_ACP, and WRITE_ACP permissions on the object.

--grant-read-acpSpecify access permissions explicitly to allows grantee to read the object ACL.

--grant-readSpecify access permissions explicitly to allow grantee to read the object data and its metadata.

--grant-write-acpSpecify access permissions explicitly to allows grantee to allow grantee to write the ACL for the applicable object.

--keyObject key for which the multipart upload is to be 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 the uploaded object.

--object-lock-event-hold-duration-yearsSpecifies the event hold duration in years to apply to the uploaded object.

--object-lock-event-holdSpecifies the event hold status to apply to the uploaded object.

--object-lock-legal-hold-statusSpecifies whether you want to apply a legal hold to the uploaded object.

--object-lock-modeSpecifies the Object Lock mode that you want to apply to the uploaded object.

--object-lock-retain-until-dateSpecifies the date and time when you want the 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 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 customer-provided 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 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.