List Multipart Uploads (GET multipart-uploads) - 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 Multipart Uploads (GET multipart-uploads)

Descrição

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), 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 não marker for nulo, para obter o próximo conjunto de uploads de várias partes, você enviou outra solicitação de List Multipart Uploads com o parâmetro de solicitação definido para o valor do marcador que o Amazon Glacier (Amazon Glacier) retornou em resposta à sua marker solicitação anterior de List Multipart Uploads.

Observe a diferença entre essa operação e a operação List Parts (GET uploadID). 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).

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.

GET /AccountId/vaults/VaultName/multipart-uploads 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

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.

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

{
  "Marker": String,
  "UploadsList" : [ 
    {
      "ArchiveDescription": String,
      "CreationDate": String,
      "MultipartUploadId": String,
      "PartSizeInBytes": Number,
      "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 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). 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

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

GET /-/vaults/examplevault/multipart-uploads 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 todos os uploads de várias partes em andamento para o cofre especificado. O campo marker é null, o que indica que não há mais uploads a serem listados. 

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: 1054
      
{
  "Marker": null, 
  "UploadsList": [ 
    {
      "ArchiveDescription": "archive 1",
      "CreationDate": "2012-03-19T23:20:59.130Z",
      "MultipartUploadId": "xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev",
      "PartSizeInBytes": 4194304,
      "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
    }, 
    {
      "ArchiveDescription": "archive 2",
      "CreationDate": "2012-04-01T15:00:00.000Z",
      "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
      "PartSizeInBytes": 4194304,
      "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
    },
    {
      "ArchiveDescription": "archive 3",
      "CreationDate": "2012-03-20T17:03:43.221Z",
      "MultipartUploadId": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
      "PartSizeInBytes": 4194304,
      "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
    } 
  ]
}

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

GET /-/vaults/examplevault/multipart-uploads?limit=1&marker=xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev 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 (Amazon Glacier) retorna uma lista de no máximo dois uploads de várias partes em andamento para o cofre especificado, começando pelo marcador especificado e retornando dois resultados. 

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: 470

{
  "Marker": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
  "UploadsList" : [ 
    {
      "ArchiveDescription": "archive 2",
      "CreationDate": "2012-04-01T15:00:00.000Z",
      "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
      "PartSizeInBytes": 4194304,
      "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
    }
  ]
}