S3 Create Multipart Upload

POST https://s3.{{region}}.backblazeb2.com/:bucket/:key?uploads

Request Params

KeyDatatypeRequiredDescription
uploadsnullMust be present for a multipart upload.

HEADERS

KeyDatatypeRequiredDescription
Cache-ControlnullOptional. Specifies Cache-Control header on retrieval.
Content-DispositionnullOptional. Specifies Content-Disposition header on retrieval.
Content-EncodingnullOptional. Specifies Content-Encoding header on retrieval.
Content-LanguagenullOptional. Specifies Content-Encoding header on retrieval.
Content-LengthnullOptional. Specifies Content-Length header on retrieval.
Content-TypenullOptional. Specifies Content-Type header on retrieval.
ExpiresnullOptional. Specifies Expires header on retrieval.
x-amz-aclnullOptional. If supplied, must be the same as the bucket ACL.
x-amz-expected-bucket-ownernullOptional. Account ID of the expected bucket owner. If the bucket is owned by a different owner, a 403 Access Denied error will be returned.
x-amz-object-lock-legal-holdnullOptional. Specifies whether a legal hold will be applied. Allowed values are 'ON' or 'OFF'.
x-amz-object-lock-modenullOptional. The lock mode to apply. Allowed values are 'GOVERNANCE' or 'COMPLIANCE'.
x-amz-object-lock-retain-until-datenullOptional. Timestamp for expiration of object lock.
x-amz-server-side-encryption-customer-algorithmnullOptional. Encryption algorithm to be used for SSE-C.
x-amz-server-side-encryption-customer-keynullOptional. Base64-encoded customer key for SSE-C.
x-amz-server-side-encryptionnullOptional. Set to AES256 to use SSE-B2.
x-backblaze-live-read-enablednullOptional. To retrieve data from an ongoing multipart upload with Live Read enabled, the value must be TRUE.
Any value other than TRUE (case-insensitive) is treated as false.
x-backblaze-live-read-part-sizenullOptional. Use this optional header to specify the part size (in bytes) to be used to determine which part numbers correspond to the requested byte range.

RESPONSES

status: OK

"\u003c?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?\u003e\n\u003cInitiateMultipartUploadResult xmlns=\"http://s3.amazonaws.com/doc/2006-03-01/\"\u003e\n    \u003cBucket\u003emy-bucket-name\u003c/Bucket\u003e\n    \u003cKey\u003eobject-1\u003c/Key\u003e\n    \u003cUploadId\u003e4_z6145af89f355ac2f74ed0c1b_f2025e1f1817e0030_d20220128_m233615_c004_v0402000_t0048\u003c/UploadId\u003e\n\u003c/InitiateMultipartUploadResult\u003e"