List Parts (GET uploadID) - Amazon Glacier
DescriçãoSolicitaçõesRespostasExemplosSeções relacionadas

Esta página é somente para clientes atuais do serviço Amazon Glacier que usam Vaults e a API REST original de 2012.

Se você estiver procurando por soluções de armazenamento de arquivos, recomendamos usar as classes de armazenamento Amazon Glacier no 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 as classes de armazenamento do Amazon Glacier.

O Amazon Glacier (serviço autônomo original baseado em cofre) não aceitará mais novos clientes a partir de 15 de dezembro de 2025, sem impacto para os clientes existentes. 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, 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 AWS nossa orientação de soluções para transferir dados dos cofres do Amazon Glacier para as classes de armazenamento do Amazon S3 Glacier.

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)

Descrição

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

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 de List Parts após concluir o upload de várias partes, o Amazon Glacier (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 não marker for nulo, para buscar o próximo conjunto de peças, você enviou outra solicitação de List Parts com o parâmetro de solicitação definido para o valor do marcador que o Amazon Glacier retornou em resposta à sua marker solicitação anterior de List Parts.

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)). Você também pode especificar parâmetros marker e limit.

GET /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
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) Descrição 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.

Corpo da Solicitação

Essa operação não tem um corpo de solicitação.

Respostas

Sintaxe

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length

{
    "ArchiveDescription" : String,
    "CreationDate" : String,
    "Marker": String,
    "MultipartUploadId" : String,
    "PartSizeInBytes" : Number,
    "Parts" : 
    [ {
      "RangeInBytes" : String,
      "SHA256TreeHash" : String
      },
      ...
     ],
    "VaultARN" : String
}

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.

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

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

GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
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 peças carregadas associadas à ID de upload de várias partes especificada. Neste exemplo, existem apenas duas partes. O campo Marker é null, o que indica não haver mais partes do multipart upload.

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: application/json
Content-Length: 412
      
{
    "ArchiveDescription" : "archive description",
    "CreationDate" : "2012-03-20T17:03:43.221Z",
    "Marker": null,
    "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
    "PartSizeInBytes" : 4194304,
    "Parts" : 
    [ {
      "RangeInBytes" : "0-4194303",
      "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
      },
      {
      "RangeInBytes" : "4194304-8388607",
      "SHA256TreeHash" : "0195875365afda349fc21c84c099987164"
      }],
    "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
}

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

GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE?marker=1001&limit=1 HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
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 peças carregadas que estão associadas à ID de upload de várias partes em andamento especificada.

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: text/json
Content-Length: 412
      
{
    "ArchiveDescription" : "archive description 1",
    "CreationDate" : "2012-03-20T17:03:43.221Z",
    "Marker": "MfgsKHVjbQ6EldVl72bn3_n5h2TaGZQUO-Qb3B9j3TITf7WajQ",
    "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
    "PartSizeInBytes" : 4194304,
    "Parts" : 
    [ {
      "RangeInBytes" : "4194304-8388607",
      "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
      }],
    "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
}