Esta página é somente para clientes existentes do serviço S3 Glacier que usam o Vaults e o original de 2012. REST API
Se você estiver procurando por soluções de armazenamento de arquivamento, sugerimos usar as classes de armazenamento S3 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 Classes de armazenamento S3 Glacier e Armazenamento de dados de longo prazo usando classes
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 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 |
Não |
marker
|
Uma string invisível usada na paginação. 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
eVaultARN
.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