**此页面仅适用于使用文件库和 2012 年原始 REST API 的 Amazon Glacier 服务的现有客户。**

如果您正在寻找归档存储解决方案，建议使用 Amazon S3 中的 Amazon Glacier 存储类别 S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive。要了解有关这些存储选项的更多信息，请参阅 [Amazon Glacier 存储类别](https://www.amazonaws.cn/s3/storage-classes/glacier/)。

Amazon Glacier（最初基于保管库的独立服务）不再接受新客户。Amazon Glacier 是一项独立的服务 APIs ，拥有自己的服务，可将数据存储在文件库中，不同于亚马逊 S3 和 Amazon S3 Glacier 存储类别。在 Amazon Glacier 中，您现有的数据将确保安全，并且可以无限期地访问。无需进行迁移。对于低成本、长期的存档存储， Amazon 建议[使用 Amazon S3 Glacier 存储类别，这些存储类别](https://www.amazonaws.cn/s3/storage-classes/glacier/)基于S3存储桶 APIs、完全 Amazon Web Services 区域 可用性、更低的成本和 Amazon 服务集成，可提供卓越的客户体验。如果您希望加强功能，可以考虑使用我们的 [Amazon 将数据从 Amazon Glacier 文件库传输到 Amazon S3 Glacier 存储类别的解决方案指南](https://www.amazonaws.cn/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/)，迁移到 Amazon S3 Glacier 存储类别。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 启动分段上传（POST multipart-uploads）
<a name="api-multipart-initiate-upload"></a>

## 说明
<a name="api-multipart-initiate-upload-description"></a>

此操作启动分段上传（请参阅[分段上传大型档案（分段上传）](uploading-archive-mpu.md)）。Amazon Glacier（Amazon Glacier）创建了分段上传资源并在响应中返回其 ID。在后续的分段上传操作中，您可以使用此上传 ID。

启动分段上传时，您可以指定段大小（以字节数为单位）。分段大小必须为兆字节（MiB）（1024 千字节 [KiB]）乘以 2 的幂，例如 1048576（1 MiB）、2097152（2 MiB）、4194304（4 MiB）、8388608（8 MiB），以此类推。允许的最小段大小为 1 MiB，最大为 4 GiB。

除了最后一段以外，您使用此上传 ID 上传的每一段都必须具有相同的大小。最后一段可以为相同的大小或较小的大小。例如，假设您要上传一个 16.2 MiB 的文件。如果您以 4 MiB 的段大小启动分段上传，则您将首先上传四段（每段 4 MiB），最后再上传一段（0.2 MiB）。

 

**注意**  
启动分段上传时，您不需要知道档案的大小，因为 Amazon Glacier 不要求您指定整个档案大小。

完成分段上传后，Amazon Glacier 会删除 ID 引用的分段上传资源。如果取消分段上传，Amazon Glacier 还将删除分段上传资源；或者，如果在 24 小时内没有执行任何活动，分段上传资源也会被删除。24 小时后，该 ID 可能仍然可用，但是应用程序不应期望此行为。

## 请求
<a name="api-multipart-initiate-upload-requests"></a>

要启动分段上传，您可以将 HTTP `POST` 请求发送到要在其中保存档案的文件库的 `multipart-uploads` 子资源 URI。请求必须包括段大小，并且可以选择性地包括档案的描述。

### 语法
<a name="api-multipart-initiate-upload-requests-syntax"></a>

```
1. POST /AccountId/vaults/VaultName/multipart-uploads 
2. Host: glacier.us-west-2.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
6. x-amz-archive-description: ArchiveDescription
7. x-amz-part-size: PartSize
```

 

**注意**  
该`AccountId`值是拥有文件库的账户的 Amazon Web Services 账户 ID。您可以指定一个 Amazon Web Services 账户 ID，也可以选择指定一个 '`-`'（连字符），在这种情况下，Amazon Glacier 使用与用于签署请求的凭证关联的 Amazon Web Services 账户 ID。如果您使用账户 ID，请勿在 ID 中包含任何连字符（-）。

### 请求参数
<a name="api-archive-post-requests-parameters1"></a>

此操作不使用请求参数。

### 请求标头
<a name="api-archive-post-requests-headers1"></a>

除了所有操作通用的请求标头外，此操作还使用以下请求标头。有关通用请求标头的更多信息，请参阅[通用请求标头](api-common-request-headers.md)。


|  Name  |  说明  |  必填  | 
| --- | --- | --- | 
|  x-amz-part-size  |  除了最后一段以外的每一段的大小（以字节为单位）。最后一段可以小于此段大小。 类型：字符串 默认值：无 约束：分段大小必须为兆字节（1024 KiB）乘以 2 的幂，例如 1048576（1 MiB）、2097152（2 MiB）、4194304（4 MiB）、8388608（8 MiB），以此类推。允许的最小段大小为 1 MB，最大为 4 GiB（4096 MiB）。  |  是 | 
| x-amz-archive-description  |  您正在分段上传的档案描述。它可以为明语描述或者您选择来分配的某个唯一的标识符。当您检索文件库清单（请参阅[启动任务（POST jobs）](api-initiate-job-post.md)）时，清单会包括因做出响应而返回的每个档案的此描述。档案描述中的前导空白会被删除。 类型：字符串 默认值：无 约束：描述必须小于或等于 1024 字节。允许的字符为不含控制代码的 7 位 ASCII 字符，明确说来就是 ASCII 值为 32-126（十进制）或 0x20-0x7E（十六进制）的字符。  |  否  | 

### 请求正文
<a name="api-multipart-initiate-upload-requests-elements"></a>

此操作没有请求正文。

## 响应
<a name="api-multipart-initiate-upload-responses"></a>

在响应中，Amazon Glacier 会创建由 ID 标识的分段上传资源，并返回分段上传 ID 的相对 URI 路径。

### 语法
<a name="api-multipart-initiate-upload-response-syntax"></a>

```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. Location: Location
5. x-amz-multipart-upload-id: multiPartUploadId
```

### 响应标头
<a name="api-archive-post-responses-headers2"></a>

除了所有操作通用的响应标头外，成功的响应中还包括以下响应标头。有关通用响应标头的更多信息，请参阅[通用响应标头](api-common-response-headers.md)。


|  Name  |  说明  | 
| --- | --- | 
|  Location  |  Amazon Glacier 创建的分段上传 ID 的相对 URI 路径。您可以使用此 URI 路径来纳入您的请求以上传段，以及完成分段上传。 类型：字符串  | 
|  x-amz-multipart-upload-id  |  分段上传的 ID。此值也包括在 `Location` 标头中，作为该标头的一部分。 类型：字符串  | 

### 响应正文
<a name="api-archive-post-responses-elements1"></a>

此操作不返回响应正文。

### 错误
<a name="api-archive-post-responses-errors1"></a>

有关 Amazon Glacier 异常和错误消息的信息，请参阅[错误响应](api-error-responses.md)。

## 示例
<a name="initiate-mpu-api-example"></a>

### 请求示例
<a name="api-multipart-initiate-upload-example-request"></a>

以下示例通过向名为 `POST` 的文件库的 `multipart-uploads` 子资源 URI 发送 HTTP `examplevault` 请求来启动分段上传。该请求包括标头，以指定段大小 4 MiB（4194304 字节）和可选的档案描述。

```
1. POST /-/vaults/examplevault/multipart-uploads 
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-archive-description: MyArchive-101
5. x-amz-part-size: 4194304
6. x-amz-glacier-version: 2012-06-01
7. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```

### 响应示例
<a name="api-multipart-initiate-upload-example-response"></a>

Amazon Glacier 会创建分段上传资源，并将它添加到文件库的 `multipart-uploads` 子资源。`Location` 响应标头包括分段上传 ID 的相对 URI 路径。

```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Location: /111122223333/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE
5. x-amz-multipart-upload-id: OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE
```

有关上传各段的信息，请参阅[上传段（PUT uploadID）](api-upload-part.md)。

## 相关部分
<a name="related-sections-initiate-mpu"></a>

 
+ [上传段（PUT uploadID）](api-upload-part.md)
+ [完成分段上传（POST uploadID）](api-multipart-complete-upload.md)
+ [中止分段上传（DELETE uploadID）](api-multipart-abort-upload.md)
+ [列出分段上传（GET multipart-uploads）](api-multipart-list-uploads.md)
+ [列出段（GET uploadID）](api-multipart-list-parts.md)
+ [删除档案（DELETE archive）](api-archive-delete.md)
+ [分段上传大型档案（分段上传）](uploading-archive-mpu.md)
+ [适用于 Amazon Glacier 的 Identity and Access Management](security-iam.md)