Fazer upload de arquivos grandes em partes (Multipart Upload)

Tópicos

• Processo Multipart Upload

• Fatos rápidos

• Fazer upload de arquivos grandes usando AWS CLI

• Fazer upload de arquivos grandes em partes usando o Amazon SDK para Java

• Carregando arquivos grandes usando o AWS SDK para .NET

• Fazer upload de arquivos grandes em partes usando a API REST

Processo Multipart Upload

Conforme descrito emFazendo o upload de um arquivo no Amazon Glacier, incentivamos os clientes do Amazon Glacier (Amazon Glacier) a usar o Multipart Upload para fazer upload de arquivos com mais de 100 mebibytes (MiB).

1. Iniciar multipart upload

   Quando você envia uma solicitação para iniciar um upload de várias partes, o Amazon Glacier retorna uma ID de upload de várias partes, que é um identificador exclusivo para seu upload de várias partes. Todas as operações de multipart upload subsequentes exigirão esse ID. Essa ID não expira por pelo menos 24 horas após 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.

2. 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. Posteriormente, o Amazon Glacier usa as informações do intervalo de conteúdo para montar o arquivo na sequência correta. 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.

3. 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 na faixa de conteúdo que você forneceu. A resposta do Amazon Glacier a uma solicitação de upload completo de várias partes inclui um ID de arquivamento para o arquivo recém-criado. Se você forneceu uma descrição de arquivo opcional na solicitação Iniciar upload de várias partes, 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 (Amazon Glacier) fornece as seguintes chamadas adicionais de API de upload em várias partes.

• 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 lista de peças, o Amazon Glacier retorna informações de até 1.000 peças. 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, 1048576 (1 MiB), 2097152 (2 MiB), 4194304 (4 MiB), 8388608 (8 MiB).
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