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 o marker não for nulo, para obter o próximo conjunto de multipart uploads, envie outra solicitação de listar multipart uploads com o parâmetro da solicitação marker definido como o valor do marcador retornado pelo Amazon S3 Glacier (S3 Glacier) em resposta à solicitação Listar 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 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	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 S3 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 S3 Glacier retorna uma lista de todos os multipart uploads 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 S3 Glacier (S3 Glacier) retorna uma lista de não mais do que dois multipart uploads 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"
    }
  ]
}   

Seções relacionadas

• Initiate Multipart Upload (POST multipart-uploads)

• Upload Part (PUT uploadID)

• Complete Multipart Upload (POST uploadID)

• Abort Multipart Upload (DELETE uploadID)

• List Parts (GET uploadID)

• Fazer upload de arquivos grandes em partes (Multipart Upload)

• Gerenciamento de identidade e acesso para o Amazon S3 Glacier