You can return to the original look by selecting English in the language selector
above.

Initiate Multipart Upload (POST
multipart-uploads)

Description

This operation initiates a multipart upload (see Uploading Large Archives in Parts (Multipart Upload)).
Amazon S3 Glacier (Glacier) creates a multipart upload
resource and returns its ID in the response. You use this Upload ID in subsequent
multipart upload operations.

When you initiate a multipart upload, you specify the part size in number of bytes.
The part
size must be a megabyte (1024 KB) multiplied by a power of 2—for example, 1048576
(1 MB), 2097152 (2 MB), 4194304 (4 MB), 8388608 (8 MB), and so on. The minimum
allowable
part size is 1 MB, and the maximum is 4 GB.

Every part you upload using this upload ID, except the last one, must have the same
size.
The last one can be the same size or smaller. For example, suppose you want to
upload a
16.2 MB file. If you initiate the multipart upload with a part size of 4 MB, you
will
upload four parts of 4 MB each and one part of 0.2 MB.

Note

You don't need to know the size of the archive when you start a multipart upload because
Glacier does not require you to specify the overall archive size.

After you complete the multipart upload, Glacier removes the multipart upload resource
referenced by the ID. Glacier will also remove the multipart upload resource if
you
cancel the multipart upload or it may be removed if there is no activity for a
period of
24 hours. The ID may still be available after 24 hours, but applications should
not
expect this behavior.

Requests

To initiate a multipart upload, you send an HTTP POST request to the URI of the
multipart-uploads subresource of the vault in which you want to save
the archive. The request must include the part size and can optionally include
a
description of the archive.

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify
an AWS account ID or optionally a single '-' (hyphen), in which case Amazon S3 Glacier uses the AWS account ID associated with
the credentials used to sign the request. If you use an account ID, do not include
any hyphens ('-') in the ID.

Request Parameters

This operation does not use request parameters.

Request Headers

This operation uses the following request headers, in addition to the request headers
that are common to all operations.
For more information about the common request headers, see
Common Request Headers.

Name

Description

Required

x-amz-part-size

The size of each part except the last, in bytes. The last part can be smaller than
this part size.

Type: String

Default: None

Constraints: The part size must be a megabyte (1024 KB) multiplied by a power of
2—for example, 1048576 (1 MB), 2097152 (2 MB), 4194304 (4
MB), 8388608 (8 MB), and so on. The minimum allowable part size
is 1 MB, and the maximum is 4 GB (4096 MB).

Yes

x-amz-archive-description

Archive description you are uploading in parts. It can be a plain-language
description or some unique identifier you choose to assign. When
you retrieve a vault inventory (see Initiate Job (POST jobs) ), the inventory
includes this description for each of the archives it returns in
response. Leading whitespace in archive descriptions is
removed.

Type: String

Default: None

Constraints: The description must be less than or equal to 1024 bytes. The
allowable characters are 7 bit ASCII without control codes,
specifically ASCII values 32-126 decimal or 0x20-0x7E
hexadecimal.

No

Request Body

This operation does not have a request body.

Responses

In the response, Glacier creates a multipart upload resource identified by an ID and
returns the relative URI path of the multipart upload ID.

Syntax

Response Headers

A successful response includes the following response headers, in addition to the
response headers that are common to all operations. For more information about common
response headers, see
Common Response Headers.

Name

Description

Location

The relative URI path of the multipart upload ID Glacier created. You use this
URI path to scope your requests to upload parts, and to complete
the multipart upload.

Type: String

x-amz-multipart-upload-id

The ID of the multipart upload. This value is also included
as part of the Location header.

Type: String

Response Body

This operation does not return a response body.

Errors

For information about Amazon S3 Glacier
exceptions and error messages, see Error Responses.

Example

Example Request

The following example initiates a multipart upload by sending an HTTP POST
request to the URI of the multipart-uploads subresource of a vault
named examplevault. The request includes headers to specify the part
size of 4 MB (4194304 bytes) and the optional archive description.