List Parts (GET uploadID) - Amazon S3 Glacier

Se você é novato no Amazon Simple Storage Service (Amazon S3), recomendamos que comece aprendendo mais sobre as classes de armazenamento S3 Glacier no Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Para obter mais informações, consulte Classes de armazenamento S3 Glacier e Classes de armazenamento para arquivamento de objetos no Guia do usuário do 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)

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 S3 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 multipart upload, o Amazon S3 Glacier (S3 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 S3 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)). 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 valor de AccountId é o ID de Conta da AWS da conta proprietária do cofre. Você pode especificar um ID de Conta da AWS ou, de forma opcional, um '-' (hífen) único; nesse caso, o Amazon S3 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 de 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 do hash de árvore SHA256 que o S3 Glacier calculou para a parte. 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 S3 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 S3 Glacier retorna uma lista de partes cujo upload foi feito associadas ao ID de multipart upload especificado. 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 S3 Glacier retorna uma lista de partes cujo upload foi feito associadas ao ID de multipart upload em andamento especificado.

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" }