Esta página destina-se somente a clientes atuais do serviço Amazon Glacier que usam cofres e a API REST original de 2012.
Se você estiver procurando soluções de armazenamento de arquivos do Amazon Glacier, recomendamos usar as classes de armazenamento do 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 do Amazon Glacier
O Amazon Glacier (serviço autônomo original baseado em cofre) não está mais aceitando novos clientes. 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
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á.
Fazer upload de arquivos grandes em partes (Multipart Upload)
Tópicos
Processo Multipart Upload
Conforme descrito em Carregar um arquivo no Amazon Glacier, recomendamos que os clientes do Amazon Glacier usem upload multiparte para fazer upload de arquivos maiores que 100 mebibytes (MiB).
-
Iniciar multipart upload
Quando você envia uma solicitação para iniciar um upload multiparte, o Amazon Glacier retorna um ID desse upload, que é um identificador exclusivo. Todas as operações de multipart upload subsequentes exigirão esse ID. Esse ID não vai expirar por pelo menos 24 horas depois que o Amazon Glacier concluir o trabalho.
Na solicitação para iniciar um multipart upload, especifique o tamanho da parte em número de bytes. Cada parte do upload, exceto a última, deve ser desse tamanho.
nota
Você não precisa saber o tamanho do arquivo geral ao usar o multipart upload. Isso significa que é possível usar multipart uploads nos casos em que, ao começar a carregar o arquivo, o tamanho do arquivo não é conhecido. É necessário decidir apenas o tamanho da parte ao iniciar o multipart upload.
Na solicitação de multipart upload de iniciação, você também pode fornecer uma descrição de arquivo opcional.
-
Partes de upload
Para cada solicitação de upload da parte, você deve incluir o ID de multipart upload obtido na etapa 1. Na solicitação, você também deve especificar o intervalo de conteúdo, em bytes, identificando a posição da parte no arquivo final. O Amazon Glacier usará as informações do intervalo de conteúdo para montar o arquivo na sequência apropriada. Como você fornece o intervalo de conteúdo para cada parte do upload, ele determina a posição da parte na montagem final do arquivo e, assim, pode fazer upload de partes em qualquer ordem. Você também pode fazer upload de partes em paralelo. Se você fizer upload de uma nova parte usando o mesmo intervalo de conteúdo como uma parte carregada anteriormente, a parte cujo upload foi feito anteriormente será substituída.
-
Concluir (ou anular) o Multipart Upload
Depois de fazer upload de todas as partes do arquivo, você usará a operação completa. Mais uma vez, você deve especificar o ID de upload na solicitação. O Amazon Glacier cria um arquivo concatenando partes em ordem crescente com base no intervalo de conteúdo fornecido por você. A resposta do Amazon Glacier a uma solicitação para upload multiparte completo inclui um ID do arquivo recém-criado. Caso uma descrição de arquivo opcional tenha sido fornecida na solicitação Iniciar Upload Multiparte, o Amazon Glacier a associará ao arquivo montado. Depois de concluir com êxito um multipart upload, você não poderá se referir ao ID de multipart upload. Isso significa você não pode acessar partes associadas ao ID de multipart upload.
Se anular um multipart upload, você não poderá fazer mais upload de partes usando esse ID de upload multipartes. Todo o armazenamento consumido por todas as partes associadas ao multipart upload anulado é liberado. Se algum upload de parte estiver em andamento, ele ainda poderá ser bem-sucedido ou falhar mesmo depois da interrupção.
Operações de multipart upload adicionais
O Amazon Glacier fornece as seguintes chamadas adicionais de API de upload multiparte.
-
List Parts: usando essa operação, você pode listar as partes de um multipart upload. Isso retorna informações sobre as partes cujo upload você fez para um multipart upload. Para cada solicitação de partes da lista, o Amazon Glacier retorna informações para até 1.000 partes. Se houver mais partes a serem listadas para o multipart upload, o resultado será paginado, e um marcador será retornado na resposta na qual a lista deve continuar. Você precisa enviar solicitações adicionais para recuperar partes subsequentes. Observe que a lista de partes retornada não inclui partes que não tiveram o upload concluído.
-
List Multipart Uploads: usando essa operação, você pode obter uma lista de multipart upload em andamento. Um multipart upload em andamento é um upload que você iniciou, mas que ainda não concluiu nem interrompeu. Para cada solicitação de multipart uploads da lista, o Amazon Glacier retorna até 1.000 multipart uploads. Se houver mais multipart uploads a serem listadas, o resultado será paginado, e um marcador será retornado na resposta na qual a lista deve continuar. Você precisa enviar solicitações adicionais para recuperar os multipart uploads restantes.
Fatos rápidos
A tabela a seguir fornece especificações básicas do multipart upload.
| Item | Especificação |
|---|---|
| Tamanho de arquivo máximo | 10.000 x 4 gibibytes (GiB) |
| Número máximo de partes por upload | 10.000 |
| Tamanho da parte | De 1 MiB a 4 GiB, a última parte pode ser < 1 MiB. Você especifica o valor de tamanho em bytes. O tamanho da peça deve ser um mebibyte (1024 kibibytes [KiB]) multiplicado por uma potência de 2. Por exemplo, |
| Número máximo de partes retornadas em uma solicitação de listagem de partes | 1.000 |
| Número máximo de multipart uploads retornados em uma solicitação de listagem de multipart uploads | 1.000 |
