**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 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)