Object Storage Service:Métodos para upload de objetos no OSS

Métodos de upload

O OSS oferece seis métodos de upload. Escolha com base no tamanho do arquivo, nas condições da rede e em quem inicia o upload.

• Simple upload: Envie arquivos de até 5 GB com uma única chamada de API PutObject. Não requer configuração adicional. Use este método para uploads rotineiros em que o tamanho do arquivo e a estabilidade da rede não são preocupações.

• Multipart upload: Transfira arquivos de até 48,8 TB dividindo-os em partes e enviando-as em paralelo. Execute as chamadas InitiateMultipartUpload, UploadPart e CompleteMultipartUpload em sequência; o OSS monta as partes em um único objeto. Se o upload for interrompido, o cliente registra as partes com falha e tenta novamente apenas essas. Ideal para arquivos grandes que exigem alto throughput paralelo.

• Append upload: Acrescente dados a um objeto existente usando a API AppendObject. Cada acréscimo pode ter até 5 GB, e os dados adicionados ficam imediatamente disponíveis para leitura. Use este método para streams de vídeo ou arquivos de log com conteúdo em crescimento contínuo. Apenas objetos do tipo appendable oferecem suporte a esse recurso.

• Resumable upload: Carregue arquivos de até 48,8 TB em conexões não confiáveis. Os SDKs do OSS, como o método uploadFile no OSS SDK for Java, salvam automaticamente pontos de verificação para que o upload continue de onde parou. Prefira esta opção ao upload multipart quando houver probabilidade de interrupções de rede e você desejar recuperação automática sem lógica de nova tentativa no lado do cliente.

• Form upload: Permita que usuários enviem objetos de até 5 GB diretamente de uma página HTML via HTTP POST. Uma política gerada pelo servidor controla restrições como tamanho e tipo do objeto. Adequado para aplicações web em que o navegador inicia o upload.

• Object uploads by using presigned URLs: Autorize terceiros a enviar objetos menores que 5 GB sem compartilhar seu par de AccessKey. Gere uma URL pré-assinada com janela de expiração definida; a URL torna-se inválida automaticamente após esse período. Utilize quando precisar de acesso delegado e limitado por tempo para uploads.

Recursos relacionados

• Use a barra de progresso dos SDKs do OSS para exibir o andamento do upload e o tempo restante estimado. Para mais informações, consulte Upload progress bar.

• Configure callbacks de upload para acionar uma notificação no servidor da aplicação após a conclusão do envio. Para mais informações, consulte Upload callbacks.

• Defina metadados do objeto durante o upload para controlar comportamentos de cache, download e processamento, incluindo cabeçalhos HTTP padrão como Content-Type. Para mais informações, consulte Gerencie metadados do objeto.

• Envie arquivos diretamente do cliente para o OSS a fim de reduzir a carga no servidor da aplicação e aumentar a velocidade de upload. Para mais informações, consulte Overview.

• Para operações com imagens, como marca d'água, conversão de formato e consulta de metadados, consulte Image processing methods.

• Para transcodificação de vídeo e captura de quadros após o upload, consulte Audio and video processing.

• Para visualização online e edição de documentos PowerPoint e Word, consulte WebOffice online preview e WebOffice online editing.

• Para compartilhar um objeto enviado com terceiros, adicione informações de assinatura à URL do objeto e distribua a URL assinada. Para mais informações, consulte Using presigned URLs to baixe or preview files.