**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á.
# 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)