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á.

Faça upload de arquivos para um bucket do Lightsail com upload de várias partes

Com o carregamento multiparte, você pode carregar um arquivo único para seu bucket como um conjunto de partes. Cada parte é uma parte contígua de dados do arquivo. O carregamento dessas partes de arquivos pode ser feito de maneira independente e em qualquer ordem. Se a transmissão de alguma parte falhar, você poderá retransmitir essa parte sem afetar outras partes. Depois que todas as partes do seu arquivo são carregadas, o Amazon S3 monta essas partes e cria o objeto em seu bucket no Amazon Lightsail. Geralmente, quando seu objeto alcança 100 MB de tamanho, você deve considerar o uso de multipart uploads em vez de fazer upload do objeto em uma única operação. Para obter mais informações sobre buckets, consulte Armazenamento de objetos.

Usar o multipart upload fornece as seguintes vantagens:

Recomendamos que você use o carregamento fracionado das seguintes maneiras:

Índice

Processo de carregamento fracionado

O upload de várias partes é um processo de três etapas que usa ações do Amazon S3 para fazer upload de arquivos para seu bucket no Lightsail:

Quando a solicitação de carregamento multiparte for concluída, o Amazon Simple Storage Service constrói o objeto com base nas partes carregadas. Em seguida, você pode acessar o objeto da mesma maneira que você acessaria qualquer outro objeto em seu bucket.

Você pode listar todos os seus multipart uploads em andamento ou obter uma lista das partes que carregou para um multipart upload específico. Cada uma dessas operações é explicada nesta seção.

Iniciação de carregamento fracionado

Quando você envia uma solicitação para iniciar um carregamento multiparte, o Amazon Simple Storage Service retorna uma resposta com um ID de carregamento. Este é um identificador exclusivo para o carregamento fracionado. É necessário incluir esse ID de carregamento sempre que fizer o carregamento de partes, listar as partes, concluir um carregamento ou interromper um carregamento. Se você desejar fornecer metadados que descrevem o objeto que está sendo carregado, deverá especificá-los na solicitação para iniciar o carregamento fracionado.

Carregamento de partes

Ao fazer upload de uma parte, além do ID de upload, você deve especificar um número de parte. Você pode escolher qualquer número de parte entre 1 e 10.000. Um número de parte identifica com exclusividade a parte e sua posição no objeto do qual você está fazendo upload. O número de parte que você escolheu não precisa estar em uma sequência consecutiva (por exemplo, pode ser 1, 5 e 14). Se você fizer upload de uma nova parte usando o mesmo número da parte anteriormente carregada, a parte anteriormente carregada será substituída.

Sempre que você carrega uma peça, o Amazon Simple Storage Service retorna um ETag cabeçalho em sua resposta. Para cada upload de peça, você deve registrar o número da peça e o ETag valor. Você tem que incluir esses valores na solicitação subsequente para concluir o multipart upload.

Conclusão de carregamento fracionado

Quando você concluir um carregamento multiparte, o Amazon Simple Storage Service criará um objeto concatenando as partes em ordem crescente com base no número da parte. Se algum metadado de objeto for fornecido na solicitação iniciar carregamento multiparte, o Amazon Simple Storage Service associará esses metadados ao objeto. Depois de uma solicitação de conclusão bem-sucedida, as partes não existem mais.

Sua solicitação completa de upload em várias partes deve incluir o ID de upload e uma lista dos números de peça e dos ETag valores correspondentes. A resposta do Amazon Simple Storage Service inclui uma ETag que identifica de forma exclusiva os dados combinados do objeto. Isso não ETag é necessariamente um MD5 hash dos dados do objeto.

Se preferir, você poderá interromper o multipart upload. Depois de interromper um multipart upload, você não pode fazer upload de nenhuma parte usando esse ID de upload novamente. Todo o armazenamento de qualquer parte do multipart upload cancelado é então liberado. Se algum upload de parte estiver em andamento, ele ainda poderá ser bem-sucedido ou falhar mesmo depois da interrupção. Para liberar todo o armazenamento consumido por todas as partes, é necessário interromper um multipart upload somente depois que todos os uploads de parte tiverem sido concluídos.

Listagens de carregamento fracionado

Você pode listar as partes de um multipart upload específico ou de todos os multipart uploads em andamento. A operação de listagem de partes retorna as informações das partes que você fez upload em um multipart upload específico. Para cada solicitação de listagem de partes, o Amazon Simple Storage Service retorna informações das partes do carregamento multiparte especificado, até no máximo mil partes. Se houver mais de 1.000 partes no multipart upload, você deverá enviar uma série de solicitações de listagem para recuperar todas as partes. Observe que a lista de partes retornada não inclui partes que ainda estão sendo carregadas. Usando a operação listar carregamento fracionados, você pode obter uma lista de carregamento fracionados em andamento.

Um multipart upload em andamento é um upload que você iniciou, mas que ainda não concluiu nem interrompeu. Cada solicitação retorna no máximo 1.000 multipart uploads. Se houver mais de 1.000 carregamento fracionados em andamento, você precisará enviar solicitações adicionais para recuperar os carregamento fracionados restantes. Use a listagem retornada apenas para verificação. Não use o resultado dessa listagem ao enviar uma solicitação de conclusão de carregamento fracionado. Em vez disso, mantenha sua própria lista dos números de peça que você especificou ao fazer o upload das peças e os ETag valores correspondentes que o Amazon Simple Storage Service retorna.

Operações simultâneas de multipart upload

Em um ambiente de desenvolvimento distribuído, é possível que seu aplicativo inicie várias atualizações no mesmo objeto ao mesmo tempo. Seu aplicativo pode iniciar vários multipart uploads usando a mesma chave de objeto. Para cada um desses carregamentos, a aplicação pode carregar as partes e enviar uma solicitação de conclusão de carregamento ao Amazon Simple Storage Service para criar o objeto. Quando os buckets têm o versionamento habilitado, concluir um multipart upload sempre cria uma nova versão. Para os buckets que não têm o versionamento habilitado, outras solicitações podem ter precedência, como as solicitações que são recebidas depois que um carregamento fracionado é iniciado e antes de ele ser concluído.

Retenção do carregamento fracionado

Todas as partes carregadas de um carregamento fracionado são armazenadas em seu bucket. Elas consomem o espaço de armazenamento do bucket até que você conclua o carregamento, interrompa o carregamento ou chegue ao tempo limite de carregamento. Um carregamento fracionado expira e o carregamento fracionado é excluído, após 24 horas a partir de quando foi criado. Quando você interrompe um carregamento fracionado ou o tempo limite, todas as partes carregadas são excluídas e o espaço de armazenamento usado para consumir em seu bucket é liberado.

Limites de carregamento multiparte do Amazon Simple Storage Service

A tabela a seguir fornece especificações básicas do multipart upload.

Dividir o arquivo a carregar

Use o comando split no sistema operacional Linux ou Unix para dividir um arquivo em várias partes que você então carrega para seu bucket. Existem aplicações freeware semelhantes que você pode usar no sistema operacional Windows para dividir um arquivo. Depois de dividir o arquivo em várias partes, continue para a seção Iniciar um carregamento fracionado deste guia.

Iniciar um carregamento multiparte usando a AWS CLI

Conclua o procedimento a seguir para iniciar um carregamento multiparte usando a AWS Command Line Interface (AWS CLI). Faça isso usando o comando create-multipart-upload. Para obter mais informações, consulte create-multipart-uploadna Referência de AWS CLI Comandos.

Faça o upload de uma peça usando o AWS CLI

Conclua o procedimento a seguir para listar uma parte de um carregamento multiparte usando a AWS Command Line Interface (AWS CLI). Faça isso usando o comando upload-part. Para obter mais informações, consulte upload-part na AWS CLI Command Reference.

Liste partes de um upload de várias partes usando o AWS CLI

Conclua o procedimento a seguir para listar partes de um carregamento multiparte usando a AWS Command Line Interface (AWS CLI). Faça isso usando o comando list-parts. Para obter mais informações, consulte list-parts na AWS CLI Command Reference.

Conclua este procedimento para obter os valores ETag para todas as partes carregadas em um carregamento fracionado. Você precisará desses valores para concluir o carregamento fracionado mais adiante neste guia. No entanto, se você gravou todos os valores ETag a partir da resposta de seus carregamentos de partes, então você pode ignorar este procedimento e continuar para a seção do arquivo Criar um carregamento fracionado .json deste guia.

Criar um carregamento fracionado do arquivo .json

Conclua o procedimento a seguir para criar um arquivo .json de carregamento fracionado que define todas as partes que você carregou e seus valores ETag. Isso é necessário mais adiante neste guia para concluir o carregamento fracionado.

Conclua um upload de várias partes usando o AWS CLI

Conclua o procedimento a seguir para concluir um carregamento multiparte usando a AWS Command Line Interface (AWS CLI). Faça isso usando o comando complete-multipart-upload. Para obter mais informações, consulte complete-multipart-uploadna Referência de AWS CLI Comandos.

Liste os uploads de várias partes para um bucket usando a AWS CLI

Conclua o procedimento a seguir para listar todos os carregamentos multiparte para um bucket usando a AWS Command Line Interface (AWS CLI). Faça isso usando o comando list-multipart-uploads. Para obter mais informações, consulte list-multipart-uploadsna Referência de AWS CLI Comandos.

Interrompa um upload de várias partes usando o AWS CLI

Conclua o procedimento a seguir para interromper um upload de várias partes usando o AWS Command Line Interface (AWS CLI). Faça isso se tiver iniciado um carregamento fracionado, mas não quiser continuar. Faça isso usando o comando abort-multipart-upload. Para obter mais informações, consulte abort-multipart-uploadna Referência de AWS CLI Comandos.