**Esta página destina-se somente a clientes atuais do serviço Amazon Glacier que usam cofres e a API REST original de 2012.**
Se você estiver procurando soluções de armazenamento de arquivos do Amazon Glacier, recomendamos usar as classes de armazenamento do Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Para saber mais sobre essas opções de armazenamento, consulte [Classes de armazenamento do Amazon Glacier](https://aws.amazon.com/s3/storage-classes/glacier/).
O Amazon Glacier (serviço autônomo original baseado em cofre) não está mais aceitando novos clientes. O Amazon Glacier é um serviço independente APIs que armazena dados em cofres e é diferente das classes de armazenamento Amazon S3 e Amazon S3 Glacier. Seus dados existentes permanecerão seguros e acessíveis no Amazon Glacier indefinidamente. Nenhuma migração é necessária. Para armazenamento de arquivamento de baixo custo e longo prazo, AWS recomenda as classes de armazenamento [Amazon S3 Glacier](https://aws.amazon.com/s3/storage-classes/glacier/), que oferecem uma experiência superior ao cliente com APIs base em buckets S3, disponibilidade Região da AWS total, custos mais baixos e integração de serviços. AWS Se você quiser recursos aprimorados, considere migrar para as classes de armazenamento do Amazon S3 Glacier usando nossas [Orientações de soluções da AWS para transferir dados dos cofres do Amazon Glacier para as classes de armazenamento do Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/).
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Operações de multipart upload
Estas são as operações de upload multiparte disponíveis para serem usadas no Amazon Glacier.
**Topics**
+ [Abort Multipart Upload (DELETE uploadID)](api-multipart-abort-upload.md)
+ [Complete Multipart Upload (POST uploadID)](api-multipart-complete-upload.md)
+ [Initiate Multipart Upload (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [List Parts (GET uploadID)](api-multipart-list-parts.md)
+ [List Multipart Uploads (GET multipart-uploads)](api-multipart-list-uploads.md)
+ [Upload Part (PUT uploadID)](api-upload-part.md)
# Abort Multipart Upload (DELETE uploadID)
## Description
Esta operação de multipart upload interrompe um multipart upload identificado pelo ID de upload.
Depois que a solicitação Abort Multipart Upload for bem-sucedida, você não poderá usar o ID de upload para fazer upload de mais partes ou realizar outras operações. A interrupção de um multipart upload concluído falha. No entanto, a interrupção de um upload já anulado será bem-sucedida, por um curto período.
Essa operação é idempotente.
Para obter informações sobre o multipart upload, consulte [Fazer upload de arquivos grandes em partes (Multipart Upload)](uploading-archive-mpu.md).
## Solicitações
Para interromper um multipart upload, envie uma solicitação `DELETE` HTTP para o URI do sub-recurso `multipart-uploads` do cofre e identifique o ID de multipart upload específico como parte do URI.
### Sintaxe
```
1. DELETE /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
```
**nota**
O `AccountId` valor é o Conta da AWS ID da conta proprietária do cofre. Você pode especificar um Conta da AWS ID ou, opcionalmente, um único '`-`' (hífen). Nesse caso, o Amazon Glacier usa Conta da AWS o ID associado às credenciais usadas para assinar a solicitação. Se você usar um ID de conta, não inclua nenhum hífen ('-') no ID.
### Parâmetros da solicitação
Essa operação não usa parâmetros de solicitação.
### Cabeçalhos de solicitação
Essa operação usa somente os cabeçalhos de solicitação que são comuns a todas as operações. Para informações sobre os cabeçalhos de solicitação comuns, consulte [Cabeçalhos de solicitação comuns](api-common-request-headers.md).
### Corpo da Solicitação
Essa operação não tem um corpo de solicitação.
## Respostas
### Sintaxe
```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```
### Cabeçalhos de resposta
Essa operação usa somente os cabeçalhos de resposta que são comuns a maioria das respostas. Para informações sobre os cabeçalhos de resposta comuns, consulte [Cabeçalhos de resposta comuns](api-common-response-headers.md).
### Corpo da resposta
Essa operação não retorna um corpo de resposta.
### Erros
Para obter informações sobre exceções e mensagens de erro do Amazon Glacier, consulte [Respostas de erro](api-error-responses.md).
## Exemplo
### Exemplo de solicitação
No exemplo a seguir, uma solicitação `DELETE` é enviada para o URI de um recurso de ID de multipart upload.
```
1. DELETE /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```
### Exemplo de resposta
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
```
## Seções relacionadas
+ [Initiate Multipart Upload (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Upload Part (PUT uploadID)](api-upload-part.md)
+ [Complete Multipart Upload (POST uploadID)](api-multipart-complete-upload.md)
+ [List Multipart Uploads (GET multipart-uploads)](api-multipart-list-uploads.md)
+ [List Parts (GET uploadID)](api-multipart-list-parts.md)
+ [Fazer upload de arquivos grandes em partes (Multipart Upload)](uploading-archive-mpu.md)
+ [Gerenciamento de identidade e acesso para o Amazon Glacier](security-iam.md)
# Complete Multipart Upload (POST uploadID)
## Descrição
Você chama essa operação upload multiparte para informar ao Amazon Glacier que o upload de todas as partes do arquivo foi feito e que o Amazon Glacier agora pode montar o arquivo com base nas partes carregadas.
Para obter informações sobre o multipart upload, consulte [Fazer upload de arquivos grandes em partes (Multipart Upload)](uploading-archive-mpu.md).
Depois da montagem e da gravação do arquivo no cofre, o Amazon Glacier retornará o ID de arquivo do recurso de arquivo recém-criado. Depois de fazer upload de um arquivo, você deve salvar o ID do arquivo retornado para recuperar o arquivo mais tarde.
Na solicitação, você deve incluir o hash de árvore SHA256 computado de todo o arquivo cujo upload foi feito. Para obter informações sobre como computar um hash de árvore SHA256, consulte [Computar somas de verificação](checksum-calculations.md). No lado do servidor, o Amazon Glacier também cria o hash de árvore SHA256 do arquivo montado. Se os valores forem correspondentes, o Amazon Glacier salvará o arquivo no cofre; do contrário, ele retornará um erro e a operação falhará. A operação [List Parts (GET uploadID)](api-multipart-list-parts.md) retorna uma lista de partes cujo upload foi feito para um multipart upload específico. Ela inclui informações da soma de verificação de cada parte carregada que podem ser usadas para depurar um problema de soma de verificação inválida.
Além disso, o Amazon Glacier também verifica se há intervalos de conteúdo não encontrados. Ao fazer upload de partes, você especifica valores de intervalo identificando onde cada parte fica na montagem final do arquivo. Ao montar o arquivo final, o Amazon Glacier verifica se há algum intervalo de conteúdo não encontrado e, se houver algum intervalo de conteúdo não encontrado, o Amazon Glacier retornará um erro e a operação Upload Multiparte Completo falhará.
Complete Multipart Upload é uma operação idempotente. Depois do primeiro complete multipart upload bem-sucedido, se você chamar a operação novamente dentro de um curto período, a operação será bem-sucedida e retornará o mesmo ID do arquivo. Isso será útil se você enfrentar um problema de rede ou receber um erro de servidor 500, quando poderá repetir a solicitação Complete Multipart Upload e obter o mesmo ID de arquivo sem criar arquivos duplicados. No entanto, depois que o multipart upload for concluído, você não poderá chamar a operação List Parts, e o multipart upload não será exibido na resposta List Multipart Uploads, mesmo se for possível uma conclusão idempotente.
## Solicitações
Para concluir um upload multiparte, você envia uma solicitação HTTP POST para o URI do ID de upload criado pelo Amazon Glacier em resposta à solicitação Iniciar Upload Multiparte. Esse é o mesmo URI usado por você ao fazer upload das partes. Além dos cabeçalhos obrigatórios comuns, você deve incluir o resultado do hash de árvore SHA256 de todo o arquivo e o tamanho total do arquivo em bytes.
### Sintaxe
```
1. POST /AccountId/vaults/VaultName/multipart-uploads/uploadID
2. Host: glacier.Region.amazonaws.com
3. Date: date
4. Authorization: SignatureValue
5. x-amz-sha256-tree-hash: SHA256 tree hash of the archive
6. x-amz-archive-size: ArchiveSize in bytes
7. x-amz-glacier-version: 2012-06-01
```
**nota**
O valor de `AccountId` é o ID de Conta da AWS da conta proprietária do cofre. Você pode especificar um ID da Conta da AWS ou, de opcionalmente, um '`-`' (hífen) único. Nesse caso, o Amazon Glacier usa o ID de Conta da AWS associado às credenciais usadas para assinar a solicitação. Se você usar um ID de conta, não inclua nenhum hífen ('-') no ID.
### Parâmetros da solicitação
Essa operação não usa parâmetros de solicitação.
### Cabeçalhos de solicitação
Essa operação usa os seguintes cabeçalhos de solicitação, além dos cabeçalhos de solicitação que são comuns a todas as operações. Para mais informações sobre os cabeçalhos de solicitação comuns, consulte [Cabeçalhos de solicitação comuns](api-common-request-headers.md).
| Nome | Descrição | Obrigatório |
| --- | --- | --- |
| x-amz-archive-size | O tamanho total, em bytes, de todo o arquivo. Esse valor deve ser a soma de todos os tamanhos das partes individuais cujo upload você fez. Tipo: string Padrão: nenhum Restrições: nenhuma | Sim |
| x-amz-sha256-tree-hash | O hash de árvore SHA256 de todo o arquivo. Trata-se do hash de árvore SHA256 das partes individuais. Se o valor especificado por você na solicitação não corresponder ao hash de árvore SHA256 do arquivo montado final computado pelo Amazon Glacier, o Amazon Glacier retornará um erro e a solicitação falhará. Tipo: string Padrão: nenhum Restrições: nenhuma | Sim |
### Elementos da solicitação
Essa operação não usa elementos de solicitação.
## Respostas
O Amazon Glacier cria um hash de árvore SHA256 de todo o arquivo. Se o valor corresponder ao hash de árvore SHA256 de todo o arquivo especificado por você na solicitação, o Amazon Glacier adicionará o arquivo ao cofre. Em resposta, ele retorna o cabeçalho `Location` HTTP com o caminho de URL do recurso de arquivo recém-adicionado. Se o tamanho do arquivo ou SHA256 enviado por você na solicitação não for correspondente, o Amazon Glacier retornará um erro e o upload permanecerá no estado incompleto. Será possível tentar novamente a operação Complete Multipart Upload depois com valores corretos, quando você poderá criar um arquivo com êxito. Se um upload multiparte não for concluído, o Amazon Glacier acabará recuperando o ID do upload.
### Sintaxe
```
HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Location: Location
x-amz-archive-id: ArchiveId
```
### Cabeçalhos de resposta
Uma resposta bem-sucedida inclui os seguintes cabeçalhos de resposta, além dos cabeçalhos de resposta que são comuns a todas as operações. Para mais informações sobre os cabeçalhos de resposta comuns, consulte [Cabeçalhos de resposta comuns](api-common-response-headers.md).
| Nome | Descrição |
| --- | --- |
| Location | O caminho do URI relativo do arquivo recém-criado. Esse URL inclui o ID de arquivo gerado pelo Amazon Glacier. Tipo: string |
| x-amz-archive-id | O ID do arquivo. Esse valor também está incluído como parte do cabeçalho `Location`. Tipo: string |
### Campos de resposta
Essa operação não retorna um corpo de resposta.
## Exemplo
### Exemplo de solicitação
Neste exemplo, uma solicitação HTTP POST é enviada para o URI que foi retornado por uma solicitação Initiate Multipart Upload. A solicitação especifica o hash de árvore SHA256 de todo o arquivo e o tamanho total do arquivo.
```
1. POST /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. z-amz-Date: 20170210T120000Z
4. x-amz-sha256-tree-hash:1ffc0f54dd5fdd66b62da70d25edacd0
5. x-amz-archive-size:8388608
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
```
### Exemplo de resposta
A resposta de exemplo a seguir mostra que o Amazon Glacier criou com êxito um arquivo das partes cujo upload você fez. A resposta inclui o ID de arquivo com caminho completo.
```
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/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
5. x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
```
Agora você pode enviar solicitações HTTP para o URI do recurso/arquivo recém-adicionado. Por exemplo, você pode enviar uma solicitação GET para recuperar o arquivo.
## Seções relacionadas
+ [Initiate Multipart Upload (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Upload Part (PUT uploadID)](api-upload-part.md)
+ [Abort Multipart Upload (DELETE uploadID)](api-multipart-abort-upload.md)
+ [List Multipart Uploads (GET multipart-uploads)](api-multipart-list-uploads.md)
+ [List Parts (GET uploadID)](api-multipart-list-parts.md)
+ [Fazer upload de arquivos grandes em partes (Multipart Upload)](uploading-archive-mpu.md)
+ [Delete Archive (DELETE archive)](api-archive-delete.md)
+ [Gerenciamento de identidade e acesso para o Amazon Glacier](security-iam.md)
# Initiate Multipart Upload (POST multipart-uploads)
## Description
Essa operação inicia um multipart upload (consulte [Fazer upload de arquivos grandes em partes (Multipart Upload)](uploading-archive-mpu.md)). O Amazon Glacier cria um recurso de upload multiparte e retorna o ID na resposta. Você usará esse ID de upload em operações de multipart upload subsequentes.
Ao iniciar um multipart upload, você especifica o tamanho da parte em número de bytes. O tamanho da parte deve ser um mebibyte (MiB) (1024 kibibytes [KiB]) multiplicado por uma potência de 2 — por exemplo, 1048576 (1 MiB), 2097152 (2 MiB), 4194304 (4 MiB), 8388608 (8 MiB) e assim por diante. O tamanho da parte mínimo permitido é 1 MiB, e o máximo é 4 gibibytes (GiB).
Toda parte cujo upload você faz usando esse ID de upload, exceto a última, deve ter o mesmo tamanho. A última pode ser do mesmo tamanho ou menor. Por exemplo, suponhamos que você queira fazer upload de um arquivo de 16,2 MiB. Se iniciar o multipart upload com um tamanho de parte de 4 MiB, você fará upload de quatro partes de 4 MiB cada e uma parte de 0,2 MiB.
**nota**
Você não precisa saber o tamanho do arquivo ao iniciar um upload multiparte porque o Amazon Glacier não exige que especifique o tamanho de todo o arquivo.
Depois de concluir o upload multiparte, o Amazon Glacier removerá o recurso de upload multiparte referenciado pelo ID. O Amazon Glacier também removerá o recurso de upload multiparte se você cancelar o upload multiparte, ou ele poderá ser removido se não houver atividade por um período de 24 horas. O ID ainda poderá estar disponível depois de 24 horas, mas os aplicativos não devem esperar esse comportamento.
## Solicitações
Para iniciar um multipart upload, você envia uma solicitação HTTP `POST` para o URI do sub-recurso `multipart-uploads` do cofre no qual deseja salvar o arquivo. A solicitação deve incluir o tamanho da parte e pode incluir uma descrição do arquivo.
### Sintaxe
```
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
```
**nota**
O `AccountId` valor é o Conta da AWS ID da conta proprietária do cofre. Você pode especificar um Conta da AWS ID ou, opcionalmente, um único '`-`' (hífen). Nesse caso, o Amazon Glacier usa Conta da AWS o ID associado às credenciais usadas para assinar a solicitação. Se você usar um ID de conta, não inclua nenhum hífen ('-') no ID.
### Parâmetros da solicitação
Essa operação não usa parâmetros de solicitação.
### Cabeçalhos de solicitação
Essa operação usa os seguintes cabeçalhos de solicitação, além dos cabeçalhos de solicitação que são comuns a todas as operações. Para mais informações sobre os cabeçalhos de solicitação comuns, consulte [Cabeçalhos de solicitação comuns](api-common-request-headers.md).
| Name (Nome) | Description | Obrigatório |
| --- | --- | --- |
| x-amz-part-size | O tamanho de cada parte, exceto a última, em bytes. A última parte pode ser menor que o tamanho dessa parte. Tipo: string Padrão: nenhum Restrições: o tamanho da parte deve ser um mebibyte (1024 KiB) multiplicado por uma potência de 2 — por exemplo, 1048576 (1 MiB), 2097152 (2 MiB), 4194304 (4 MiB), 8388608 (8 MiB) e assim por diante. O tamanho da parte mínimo permitido é 1 MiB, e o máximo é 4 GiB (4096 MiB). | Sim |
| x-amz-archive-description | Descrição do arquivo cujo upload você está fazendo em partes. Ela pode ser uma descrição em linguagem simples ou algum identificador exclusivo que você opta por atribuir. Quando você recupera um inventário de cofre (consulte [Initiate Job (trabalhos POST)](api-initiate-job-post.md)), o inventário inclui essa descrição para cada um dos arquivos retornados em resposta. Os espaços à esquerda em descrições de arquivo são removidos. Tipo: string Padrão: nenhum Restrições: a descrição deve ser menor que ou igual a 1.024 bytes. Os caracteres permitidos são ASCII 7 bits sem códigos de controle, mais especificamente valores ASCII 32-126 decimais ou 0x20-0x7E hexadecimais. | Não |
### Corpo da Solicitação
Essa operação não tem um corpo de solicitação.
## Respostas
Na resposta, o Amazon Glacier cria um recurso de upload multiparte identificado por um ID e retorna o caminho do URI relativo do ID de upload multiparte.
### Sintaxe
```
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
```
### Cabeçalhos de resposta
Uma resposta bem-sucedida inclui os seguintes cabeçalhos de resposta, além dos cabeçalhos de resposta que são comuns a todas as operações. Para mais informações sobre os cabeçalhos de resposta comuns, consulte [Cabeçalhos de resposta comuns](api-common-response-headers.md).
| Name (Nome) | Description |
| --- | --- |
| Location | O caminho do URI relativo do ID de upload multiparte criado pelo Amazon Glacier. Você pode usar esse caminho do URI para delimitar as solicitações a fim de fazer upload de partes e concluir o multipart upload. Tipo: string |
| x-amz-multipart-upload-id | O ID do multipart upload. Esse valor também está incluído como parte do cabeçalho `Location`. Tipo: string |
### Corpo da resposta
Essa operação não retorna um corpo de resposta.
### Erros
Para obter informações sobre exceções e mensagens de erro do Amazon Glacier, consulte [Respostas de erro](api-error-responses.md).
## Exemplo
### Exemplo de solicitação
O exemplo a seguir inicia um multipart upload enviando uma solicitação HTTP `POST` para o URI do sub-recurso `multipart-uploads` de um cofre chamado `examplevault`. A solicitação inclui cabeçalhos para especificar o tamanho da parte de 4 MiB (4.194.304 bytes) e a descrição de arquivo opcional.
```
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
```
### Exemplo de resposta
O Amazon Glacier cria um recurso de upload multiparte e o adiciona ao sub-recurso `multipart-uploads` do cofre. O cabeçalho de resposta `Location` inclui o caminho do URI relativo para o ID de multipart upload.
```
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
```
Para obter informações sobre como fazer upload de partes individuais, consulte [Upload Part (PUT uploadID)](api-upload-part.md).
## Seções relacionadas
+ [Upload Part (PUT uploadID)](api-upload-part.md)
+ [Complete Multipart Upload (POST uploadID)](api-multipart-complete-upload.md)
+ [Abort Multipart Upload (DELETE uploadID)](api-multipart-abort-upload.md)
+ [List Multipart Uploads (GET multipart-uploads)](api-multipart-list-uploads.md)
+ [List Parts (GET uploadID)](api-multipart-list-parts.md)
+ [Delete Archive (DELETE archive)](api-archive-delete.md)
+ [Fazer upload de arquivos grandes em partes (Multipart Upload)](uploading-archive-mpu.md)
+ [Gerenciamento de identidade e acesso para o Amazon Glacier](security-iam.md)
# List Parts (GET uploadID)
## Description
Essa operação multipart upload lista as partes de um arquivo cujo upload foi feito em um multipart upload específico identificado por um ID de upload. Para obter informações sobre o multipart upload, consulte [Fazer upload de arquivos grandes em partes (Multipart Upload)](uploading-archive-mpu.md).
Você pode fazer essa solicitação a qualquer momento durante um multipart upload em andamento antes de concluir o multipart upload. O Amazon Glacier retorna a lista de partes classificada pelo intervalo especificado em cada upload da parte. Se você enviar uma solicitação List Parts depois de concluir o upload multiparte, o Amazon Glacier retornará um erro.
A operação List Parts dá suporte à paginação. Você deve sempre verificar o campo `Marker` no corpo da resposta para ver se há um marcador no qual continuar a lista. Se não houver mais itens, o campo `marker` será `null`. Se o `marker` não for nulo, para obter o próximo conjunto de partes, envie outra solicitação List Parts com o parâmetro `marker` da solicitação definido como o valor do marcador retornado pelo Amazon Glacier em resposta à solicitação List Parts anterior.
Você também pode limitar o número de partes retornadas na resposta especificando o parâmetro `limit` na solicitação.
## Solicitações
### Sintaxe
Para listar as partes de um multipart upload em andamento, você envia uma solicitação `GET` para o URI do recurso de ID de multipart upload. O ID de multipart upload é retornado quando você inicia um multipart upload ([Initiate Multipart Upload (POST multipart-uploads)](api-multipart-initiate-upload.md)). Você também pode especificar parâmetros `marker` e `limit`.
```
1. GET /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
```
**nota**
O `AccountId` valor é o Conta da AWS ID da conta proprietária do cofre. Você pode especificar um Conta da AWS ID ou, opcionalmente, um único '`-`' (hífen). Nesse caso, o Amazon Glacier usa Conta da AWS o ID associado às credenciais usadas para assinar a solicitação. Se você usar um ID de conta, não inclua nenhum hífen ('-') no ID.
### Parâmetros da solicitação
| Name (Nome) | Description | Obrigatório |
| --- | --- | --- |
| limit | O número máximo de partes a serem retornadas. O limite padrão é 50. O número de partes retornadas pode ser menor que o limite especificado, mas o número de partes retornadas jamais excede o limite. Tipo: string Restrições: valor do inteiro mínimo de `1`. Valor do inteiro máximo de `50`. | Não |
| marker | Uma string invisível usada na paginação. `marker` especifica a parte na qual a listagem de partes deve começar. Obtenha o valor `marker` da resposta de uma resposta List Parts anterior. Você somente precisará incluir o `marker` se continuar a paginação dos resultados iniciada em uma solicitação List Parts anterior. Tipo: string Restrições: nenhuma | Não |
### Cabeçalhos de solicitação
Essa operação usa somente os cabeçalhos de resposta que são comuns a maioria das respostas. Para informações sobre os cabeçalhos de resposta comuns, consulte [Cabeçalhos de resposta comuns](api-common-response-headers.md).
### Corpo da Solicitação
Essa operação não tem um corpo de solicitação.
## Respostas
### Sintaxe
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. Content-Type: application/json
5. Content-Length: Length
6.
7. {
8. "ArchiveDescription" : String,
9. "CreationDate" : String,
10. "Marker": String,
11. "MultipartUploadId" : String,
12. "PartSizeInBytes" : Number,
13. "Parts" :
14. [ {
15. "RangeInBytes" : String,
16. "SHA256TreeHash" : String
17. },
18. ...
19. ],
20. "VaultARN" : String
21. }
```
### Cabeçalhos de resposta
Essa operação usa somente os cabeçalhos de resposta que são comuns a maioria das respostas. Para informações sobre os cabeçalhos de resposta comuns, consulte [Cabeçalhos de resposta comuns](api-common-response-headers.md).
### Corpo da resposta
O corpo da resposta contém os seguintes campos JSON.
**ArchiveDescription**
A descrição do arquivo que tiver sido especificada na solicitação Initiate Multipart Upload. Este campo será `null` se nenhuma descrição de arquivo tiver sido especificada na operação Initiate Multipart Upload.
*Tipo:* string
**CreationDate**
A hora UTC em que o multipart upload foi iniciado.
*Tipo*: string Uma representação de string no formato de data ISO 8601, por exemplo `2013-03-20T17:03:43.221Z`.
**Marker**
Uma string invisível que representa onde continuar a paginação dos resultados. Você usa o `marker` em uma nova solicitação List Parts para obter mais trabalhos na lista. Se não houver partes, esse valor será `null`.
*Tipo:* string
**MultipartUploadId**
O ID do upload ao qual as partes estão associadas.
*Tipo:* string
**PartSizeInBytes**
O tamanho da parte em bytes. Trata-se do mesmo valor especificado por você na solicitação Initiate Multipart Upload.
*Tipo*: número
**Partes**
A lista dos tamanhos de partes do multipart upload. Cada objeto na matriz contém um `RangeBytes` e um par de nome/valor `sha256-tree-hash`.
*Tipo*: matriz
**RangeInBytes**
O intervalo de bytes de uma parte, inclusive do valor máximo do intervalo.
*Tipo:* string
**SHA256TreeHash**
O valor de hash da SHA256 árvore que o Amazon Glacier calculou para a peça. Esse campo jamais será `null`.
*Tipo:* string
**VaultARN**
O nome do recurso da Amazon (ARN) do cofre para o qual o multipart upload foi iniciado.
*Tipo:* string
### Erros
Para obter informações sobre exceções e mensagens de erro do Amazon Glacier, consulte [Respostas de erro](api-error-responses.md).
## Exemplos
### Exemplo: List Parts de um multipart upload
O exemplo a seguir lista todas as partes de um upload. O exemplo envia uma solicitação `GET` HTTP para o URI do ID de multipart upload específico de um multipart upload em andamento e retorna até 1.000 partes.
#### Exemplo de solicitação
```
1. GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```
#### Exemplo de resposta
Na resposta, o Amazon Glacier retorna uma lista de partes cujo upload foi feito associadas ao ID de upload multiparte especificado. Neste exemplo, existem apenas duas partes. O campo `Marker` é `null`, o que indica não haver mais partes do multipart upload.
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Type: application/json
5. Content-Length: 412
6.
7. {
8. "ArchiveDescription" : "archive description",
9. "CreationDate" : "2012-03-20T17:03:43.221Z",
10. "Marker": null,
11. "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
12. "PartSizeInBytes" : 4194304,
13. "Parts" :
14. [ {
15. "RangeInBytes" : "0-4194303",
16. "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
17. },
18. {
19. "RangeInBytes" : "4194304-8388607",
20. "SHA256TreeHash" : "0195875365afda349fc21c84c099987164"
21. }],
22. "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
23. }
```
### Exemplo: List Parts de um multipart upload (especificar o marcador e limitar os parâmetros de solicitação)
O exemplo a seguir demonstra como usar a paginação para obter um número limitado de resultados. O exemplo envia uma solicitação `GET` HTTP para o URI do ID de multipart upload específico de um multipart upload em andamento para retornar uma parte. Um parâmetro `marker` de partida especifica em qual parte a lista de partes deve ser iniciada. Você pode obter o valor `marker` da resposta de uma solicitação anterior para uma lista de partes. Além disso, neste exemplo, o parâmetro `limit` é definido como 1 e retorna uma parte. O campo `Marker` não é `null`, o que indica haver pelo menos mais uma parte a ser obtida.
#### Exemplo de solicitação
```
1. GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE?marker=1001&limit=1 HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```
#### Exemplo de resposta
Na resposta, o Amazon Glacier retorna uma lista de partes cujo upload foi feito associadas ao ID de upload multiparte em andamento especificado.
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Type: text/json
5. Content-Length: 412
6.
7. {
8. "ArchiveDescription" : "archive description 1",
9. "CreationDate" : "2012-03-20T17:03:43.221Z",
10. "Marker": "MfgsKHVjbQ6EldVl72bn3_n5h2TaGZQUO-Qb3B9j3TITf7WajQ",
11. "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
12. "PartSizeInBytes" : 4194304,
13. "Parts" :
14. [ {
15. "RangeInBytes" : "4194304-8388607",
16. "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
17. }],
18. "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
19. }
```
## Seções relacionadas
+ [Initiate Multipart Upload (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Upload Part (PUT uploadID)](api-upload-part.md)
+ [Complete Multipart Upload (POST uploadID)](api-multipart-complete-upload.md)
+ [Abort Multipart Upload (DELETE uploadID)](api-multipart-abort-upload.md)
+ [List Multipart Uploads (GET multipart-uploads)](api-multipart-list-uploads.md)
+ [Fazer upload de arquivos grandes em partes (Multipart Upload)](uploading-archive-mpu.md)
+ [Gerenciamento de identidade e acesso para o Amazon Glacier](security-iam.md)
# List Multipart Uploads (GET multipart-uploads)
## Description
Esta operação de multipart upload lista multipart uploads em andamento para o cofre. Multipart upload em andamento é um multipart upload que foi iniciado por uma solicitação [Initiate Multipart Upload (POST multipart-uploads)](api-multipart-initiate-upload.md), mas que ainda não foi concluído ou foi interrompido. A lista retornada na resposta List Multipart Upload não tem ordem garantida.
A operação List Multipart Uploads dá suporte à paginação. Por padrão, essa operação retorna até 50 multipart uploads na resposta. Você deve sempre verificar o campo `marker` no corpo da resposta para um marcador no qual continuar a lista; se não houver mais itens, o campo `marker` será `null`.
Se o `marker` não for nulo, para obter o próximo conjunto de uploads multiparte, envie outra solicitação Listar Uploads Multiparte com o parâmetro da solicitação `marker` definido como o valor do marcador retornado pelo Amazon Glacier em resposta à solicitação Listar Uploads Multiparte.
Observe a diferença entre essa operação e a operação [List Parts (GET uploadID)](api-multipart-list-parts.md). A operação List Multipart Uploads lista todos os multipart uploads para um cofre. A operação List Parts retorna partes de um multipart upload específico identificado por um ID de upload.
Para obter informações sobre o multipart upload, consulte [Fazer upload de arquivos grandes em partes (Multipart Upload)](uploading-archive-mpu.md).
## Solicitações
### Sintaxe
Para listar multipart uploads, envie uma solicitação `GET` para o URI do sub-recurso `multipart-uploads` do cofre. Você também pode especificar parâmetros `marker` e `limit`.
```
1. GET /AccountId/vaults/VaultName/multipart-uploads HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
```
**nota**
O `AccountId` valor é o Conta da AWS ID da conta proprietária do cofre. Você pode especificar um Conta da AWS ID ou, opcionalmente, um único '`-`' (hífen). Nesse caso, o Amazon Glacier usa Conta da AWS o ID associado às credenciais usadas para assinar a solicitação. Se você usar um ID de conta, não inclua nenhum hífen ('-') no ID.
### Parâmetros da solicitação
| Name (Nome) | Description | Obrigatório |
| --- | --- | --- |
| limit | Especifica o número máximo de uploads retornados no corpo da resposta. Se não for especificado, a operação List Uploads retornará até 50 uploads. Tipo: string Restrições: valor do inteiro mínimo de `1`. Valor do inteiro máximo de `50`. | Não |
| marker | Uma string invisível usada na paginação. `marker` especifica o upload no qual a listagem de uploads deve começar. Obtenha o valor `marker` de uma resposta List Uploads anterior. Você somente precisará incluir o `marker` se continuar a paginação dos resultados iniciada em uma solicitação List Uploads anterior. Tipo: string Restrições: nenhuma | Não |
### Cabeçalhos de solicitação
Essa operação usa somente os cabeçalhos de resposta que são comuns a maioria das respostas. Para informações sobre os cabeçalhos de resposta comuns, consulte [Cabeçalhos de resposta comuns](api-common-response-headers.md).
### Corpo da Solicitação
Essa operação não tem um corpo de solicitação.
## Respostas
### Sintaxe
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. Content-Type: application/json
5. Content-Length: Length
6.
7. {
8. "Marker": String,
9. "UploadsList" : [
10. {
11. "ArchiveDescription": String,
12. "CreationDate": String,
13. "MultipartUploadId": String,
14. "PartSizeInBytes": Number,
15. "VaultARN": String
16. },
17. ...
18. ]
19. }
```
### Cabeçalhos de resposta
Essa operação usa somente os cabeçalhos de resposta que são comuns a maioria das respostas. Para informações sobre os cabeçalhos de resposta comuns, consulte [Cabeçalhos de resposta comuns](api-common-response-headers.md).
### Corpo da resposta
O corpo da resposta contém os seguintes campos JSON.
**ArchiveDescription**
A descrição do arquivo que tiver sido especificada na solicitação Initiate Multipart Upload. Este campo será `null` se nenhuma descrição de arquivo tiver sido especificada na operação Initiate Multipart Upload.
*Tipo:* string
**CreationDate**
A hora UTC em que o multipart upload foi iniciado.
*Tipo*: string Uma representação de string no formato de data ISO 8601, por exemplo `2013-03-20T17:03:43.221Z`.
**Marker**
Uma string invisível que representa onde continuar a paginação dos resultados. Você usa o `marker` em uma nova solicitação List Multipart Uploads para obter mais uploads na lista. Se não houver uploads, esse valor será `null`.
*Tipo:* string
**PartSizeInBytes**
O tamanho da parte especificado na solicitação [Initiate Multipart Upload (POST multipart-uploads)](api-multipart-initiate-upload.md). Este é o tamanho de todas as partes no upload, exceto a última parte, que pode ser menor do que esse tamanho.
*Tipo*: número
**MultipartUploadId**
O ID do multipart upload.
*Tipo:* string
**UploadsList**
Uma lista de metadados sobre objetos de multipart upload. Cada item na lista contém um conjunto de pares nome/valor para o upload correspondente, inclusive `ArchiveDescription`, `CreationDate`, `MultipartUploadId`, `PartSizeInBytes` e `VaultARN`.
*Tipo*: matriz
**VaultARN**
O Amazon Resource Name (ARN – Nome de recurso da Amazon) do cofre que contém o arquivo.
*Tipo:* string
### Erros
Para obter informações sobre exceções e mensagens de erro do Amazon Glacier, consulte [Respostas de erro](api-error-responses.md).
## Exemplos
### Exemplo: listar todos os multipart uploads
O exemplo a seguir lista todos os multipart uploads em andamento para o cofre. O exemplo mostra uma solicitação `GET` HTTP para o URI do sub-recurso `multipart-uploads` de um cofre especificado. Como os parâmetros `marker` e `limit` não são especificados na solicitação, até 1.000 multipart uploads em andamento são retornados.
#### Exemplo de solicitação
```
1. GET /-/vaults/examplevault/multipart-uploads HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```
#### Exemplo de resposta
Na resposta, o Amazon Glacier retorna uma lista de todos os uploads multiparte em andamento para o cofre especificado. O campo `marker` é `null`, o que indica que não há mais uploads a serem listados.
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Type: application/json
5. Content-Length: 1054
6.
7. {
8. "Marker": null,
9. "UploadsList": [
10. {
11. "ArchiveDescription": "archive 1",
12. "CreationDate": "2012-03-19T23:20:59.130Z",
13. "MultipartUploadId": "xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev",
14. "PartSizeInBytes": 4194304,
15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
16. },
17. {
18. "ArchiveDescription": "archive 2",
19. "CreationDate": "2012-04-01T15:00:00.000Z",
20. "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
21. "PartSizeInBytes": 4194304,
22. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
23. },
24. {
25. "ArchiveDescription": "archive 3",
26. "CreationDate": "2012-03-20T17:03:43.221Z",
27. "MultipartUploadId": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
28. "PartSizeInBytes": 4194304,
29. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
30. }
31. ]
32. }
```
### Exemplo: lista parcial de multipart uploads
O exemplo a seguir demonstra como usar a paginação para obter um número limitado de resultados. O exemplo mostra uma solicitação `GET` HTTP para o URI do sub-recurso `multipart-uploads` de um cofre especificado. Neste exemplo, o parâmetro `limit` é definido como 1, o que significa que somente um upload é retornado na lista, e o parâmetro `marker` indica o ID de multipart upload no qual a lista retornada começa.
#### Exemplo de solicitação
```
1. GET /-/vaults/examplevault/multipart-uploads?limit=1&marker=xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```
#### Exemplo de resposta
Na resposta, o Amazon Glacier retorna uma lista de não mais do que dois uploads multiparte em andamento para o cofre especificado, começando pelo marcador especificado e retornando dois resultados.
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Type: application/json
5. Content-Length: 470
6.
7. {
8. "Marker": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
9. "UploadsList" : [
10. {
11. "ArchiveDescription": "archive 2",
12. "CreationDate": "2012-04-01T15:00:00.000Z",
13. "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
14. "PartSizeInBytes": 4194304,
15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
16. }
17. ]
18. }
```
## Seções relacionadas
+ [Initiate Multipart Upload (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Upload Part (PUT uploadID)](api-upload-part.md)
+ [Complete Multipart Upload (POST uploadID)](api-multipart-complete-upload.md)
+ [Abort Multipart Upload (DELETE uploadID)](api-multipart-abort-upload.md)
+ [List Parts (GET uploadID)](api-multipart-list-parts.md)
+ [Fazer upload de arquivos grandes em partes (Multipart Upload)](uploading-archive-mpu.md)
+ [Gerenciamento de identidade e acesso para o Amazon Glacier](security-iam.md)
# Upload Part (PUT uploadID)
## Descrição
Esta operação de multipart upload faz upload de uma parte de um arquivo. Você pode fazer upload de partes de arquivo em qualquer ordem porque, na solicitação Upload Part, especifica o intervalo de bytes no arquivo montado cujo upload será feito nessa parte. Você também pode fazer upload dessas partes em paralelo. Você pode fazer upload de até 10.000 partes de um multipart upload.
Para obter informações sobre o multipart upload, consulte [Fazer upload de arquivos grandes em partes (Multipart Upload)](uploading-archive-mpu.md).
O Amazon Glacier rejeita a parte do upload se qualquer uma das seguintes condições for verdadeira:
+ **Hash de árvore SHA256 não correspondente:** para garantir que dados da parte não sejam corrompidos na transmissão, você computa um hash de árvore SHA256 da parte e o inclui na solicitação. Mediante o recebimento dos dados da parte, o Amazon Glacier também computa um hash de árvore SHA256. Se os dois valores de hash não forem correspondentes, a operação vai falhar. Para obter informações sobre como computar um hash de árvore SHA256, consulte [Computar somas de verificação](checksum-calculations.md).
+ **Hash linear SHA256 não correspondente:** obrigatório para autorização, você computa o hash linear SHA256 de toda a carga útil cujo upload foi feito e o inclui na solicitação. Para obter informações sobre como computar um hash linear SHA256, consulte [Computar somas de verificação](checksum-calculations.md).
+ **Tamanho da parte não correspondente:** o tamanho de cada parte, exceto a última, deve corresponder ao tamanho especificado na solicitação [Initiate Multipart Upload (POST multipart-uploads)](api-multipart-initiate-upload.md) correspondente. O tamanho da última parte deve ser igual a ou menor que o tamanho especificado.
**nota**
Se fizer upload de uma parte cujo tamanho seja menor que o tamanho especificado por você na solicitação de multipart upload de iniciação e que a parte não seja a última, a solicitação upload part será bem-sucedida. No entanto, a solicitação Complete Multipart Upload subsequente falhará.
+ **Intervalo não alinhado:** o valor do intervalo de bytes na solicitação não se alinha ao tamanho da parte especificado na solicitação de iniciação correspondente. Por exemplo, se você especificar um tamanho de parte de 4.194.304 bytes (4 MB), então, de 0 a 4.194.303 bytes (4 MB —1) e de 4.194.304 (4 MB) a 8.388.607 (8 MB —1) serão intervalos de partes válidos. No entanto, se você definir um valor de intervalo de 2 MB a 6 MB, o intervalo não se alinhará ao tamanho da parte, e o upload falhará.
Essa operação é idempotente. Se você fizer upload da mesma parte várias vezes, os dados incluídos na solicitação mais recente substituirão os dados cujo upload foi feito anteriormente.
## Solicitações
Você envia essa solicitação `PUT` HTTP para o URI do ID de upload retornado pela solicitação Initiate Multipart Upload. O Amazon Glacier usa o ID de upload para associar uploads de partes a um upload multiparte específico. A solicitação deve incluir um hash de árvore SHA256 dos dados da parte (cabeçalho `x-amz-SHA256-tree-hash`), um hash linear SHA256 de toda a carga útil (cabeçalho `x-amz-content-sha256`), o intervalo de bytes (cabeçalho `Content-Range`) e o tamanho da parte em bytes (cabeçalho `Content-Length`).
### Sintaxe
```
1. PUT /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. Content-Range: ContentRange
6. Content-Length: PayloadSize
7. Content-Type: application/octet-stream
8. x-amz-sha256-tree-hash: Checksum of the part
9. x-amz-content-sha256: Checksum of the entire payload
10. x-amz-glacier-version: 2012-06-01
```
**nota**
O valor de `AccountId` é o ID de Conta da AWS da conta proprietária do cofre. Você pode especificar um ID da Conta da AWS ou, de opcionalmente, um '`-`' (hífen) único. Nesse caso, o Amazon Glacier usa o ID de Conta da AWS associado às credenciais usadas para assinar a solicitação. Se você usar um ID de conta, não inclua nenhum hífen ('-') no ID.
### Parâmetros da solicitação
Essa operação não usa parâmetros de solicitação.
### Cabeçalhos de solicitação
Essa operação usa os seguintes cabeçalhos de solicitação, além dos cabeçalhos de solicitação que são comuns a todas as operações. Para mais informações sobre os cabeçalhos de solicitação comuns, consulte [Cabeçalhos de solicitação comuns](api-common-request-headers.md).
| Nome | Descrição | Obrigatório |
| --- | --- | --- |
| Content-Length | Identifica o tamanho da parte em bytes. Tipo: string Padrão: nenhum Restrições: nenhuma | Não |
| Content-Range | Identifica o intervalo de bytes no arquivo montado cujo upload será feito nessa parte. O Amazon Glacier usa essas informações para montar o arquivo na sequência apropriada. O formato desse cabeçalho segue [RFC 2616](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.16). Um cabeçalho de exemplo é `Content-Range:bytes 0-4194303/*`. Tipo: string Padrão: nenhum Restrições: o intervalo não pode ser maior que o tamanho da parte especificado por você quando iniciou o multipart upload. | Sim |
| x-amz-content-sha256 | A soma de verificação SHA256 (um hash linear) da carga útil cujo upload foi feito. Ele não é o mesmo valor especificado por você no cabeçalho `x-amz-sha256-tree-hash`. Tipo: string Padrão: nenhum Restrições: nenhuma | Sim |
| x-amz-sha256-tree-hash | Especifica um hash de árvore SHA256 dos dados cujo upload está sendo feito. Para obter informações sobre como computar um hash de árvore SHA256, consulte [Computar somas de verificação](checksum-calculations.md). Tipo: string Padrão: nenhum Restrições: nenhuma | Sim |
### Corpo da Solicitação
O corpo da solicitação contém os dados cujo upload deve ser feito.
## Respostas
Mediante um upload da parte bem-sucedido, o Amazon Glacier retorna uma resposta `204 No Content`.
### Sintaxe
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier
```
### Cabeçalhos de resposta
Uma resposta bem-sucedida inclui os seguintes cabeçalhos de resposta, além dos cabeçalhos de resposta que são comuns a todas as operações. Para mais informações sobre os cabeçalhos de resposta comuns, consulte [Cabeçalhos de resposta comuns](api-common-response-headers.md).
| Nome | Descrição |
| --- | --- |
| x-amz-sha256-tree-hash | O hash de árvore SHA256 computado pelo Amazon Glacier para a parte cujo upload foi feito. Tipo: string |
### Corpo da resposta
Essa operação não retorna um corpo de resposta.
## Exemplo
A solicitação a seguir faz upload de uma parte de 4 MB. A solicitação define o intervalo de bytes para fazer dessa a primeira parte no arquivo.
### Exemplo de solicitação
O exemplo envia uma solicitação `PUT` HTTP para fazer upload de uma parte de 4 MB. A solicitação é enviada para o URI do ID de upload retornado pela solicitação Initiate Multipart Upload. O cabeçalho `Content-Range` identifica a parte como a primeira parte dos 4 MB de dados do arquivo.
```
1. PUT /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Range:bytes 0-4194303/*
5. x-amz-sha256-tree-hash:c06f7cd4baacb087002a99a5f48bf953
6. x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628
7. Content-Length: 4194304
8. Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version,Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace
```
Para fazer upload da próxima parte, o procedimento é o mesmo; no entanto, você deve calcular um novo hash de árvore SHA256 da parte cujo upload está sendo feito e também especificar um novo intervalo de bytes onde a parte entrará no conjunto final. A solicitação a seguir faz upload de outra parte usando o mesmo ID de upload. A solicitação especifica os próximos 4 MB do arquivo após a solicitação anterior e um tamanho da parte de 4 MB.
```
1. PUT /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Range:bytes 4194304-8388607/*
5. Content-Length: 4194304
6. x-amz-sha256-tree-hash:f10e02544d651e2c3ce90a4307427493
7. x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628
8. x-amz-glacier-version: 2012-06-01
9. Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20120525/us-west-2/glacier/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version, Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace
```
O upload das partes pode ser feito em qualquer ordem; o Amazon Glacier usa a especificação do intervalo para cada parte a fim de determinar a ordem na qual montá-las.
### Exemplo de resposta
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. x-amz-sha256-tree-hash: c06f7cd4baacb087002a99a5f48bf953
4. Date: Wed, 10 Feb 2017 12:00:00 GMT
```
## Seções relacionadas
+ [Initiate Multipart Upload (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Upload Part (PUT uploadID)](#api-upload-part)
+ [Complete Multipart Upload (POST uploadID)](api-multipart-complete-upload.md)
+ [Abort Multipart Upload (DELETE uploadID)](api-multipart-abort-upload.md)
+ [List Multipart Uploads (GET multipart-uploads)](api-multipart-list-uploads.md)
+ [List Parts (GET uploadID)](api-multipart-list-parts.md)
+ [Fazer upload de arquivos grandes em partes (Multipart Upload)](uploading-archive-mpu.md)
+ [Gerenciamento de identidade e acesso para o Amazon Glacier](security-iam.md)