O OSS aceita qualquer tipo de arquivo — imagens, documentos, vídeos, entre outros. Envie objetos individualmente ou em massa com o método mais adequado ao tamanho do arquivo, às condições de rede e à source do envio.
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 envio.
|
Método |
Tamanho máximo |
Mais indicado para |
|
Upload simples |
5 GB |
Arquivos pequenos em conexões estáveis |
|
Upload multipart |
48,8 TB |
Arquivos grandes que se beneficiam de envios paralelos |
|
Upload append |
5 GB por anexação |
Dados em streaming gravados de forma incremental |
|
Upload retomável |
48,8 TB |
Arquivos grandes em redes instáveis |
|
Upload baseado em formulário |
5 GB |
Envios pelo navegador a partir de uma página HTML |
|
Upload por URL pré-assinada |
Menos de 5 GB |
Envios de terceiros sem expor pares de AccessKey |
Simple upload: Envie arquivos de até 5 GB com uma única chamada de API
PutObject. Não requer configuração. Utilize este método para envios de rotina nos quais o tamanho do arquivo e a estabilidade da rede não sejam preocupações.Multipart upload: Envie arquivos de até 48,8 TB dividindo-os em partes para envio em paralelo. Invoque
InitiateMultipartUpload,UploadParteCompleteMultipartUploadem sequência; o OSS une as partes em um único objeto. Se o envio for interrompido, o cliente registra quais partes falharam e reenvia apenas essas. Essa abordagem é ideal para arquivos grandes nos quais o throughput paralelo é fundamental.Append upload: Anexe dados a um objeto existente com a API
AppendObject. Cada anexação admite até 5 GB. A leitura dos dados anexados é imediata. Ideal para streams de vídeo ou arquivos de log cujo conteúdo cresce continuamente. Apenas objetos anexáveis são compatíveis com este método.Resumable upload: Envie arquivos de até 48,8 TB em conexões pouco confiáveis. Os SDK do OSS — como o método
uploadFileno OSS SDK for Java — registram o progresso automaticamente, permitindo retomar o envio de onde parou. Prefira esta opção ao upload multipart quando houver risco de interrupções de rede e você precisar de recuperação automática, sem lógica de repetição no lado do cliente.Form upload: Permita que os usuários enviem objetos de até 5 GB diretamente a partir de uma página HTML via HTTP POST. Uma política gerada pelo servidor controla as restrições de envio, como o tamanho e o tipo do objeto. Ideal para aplicações web nas quais o navegador inicia o envio.
Object uploads by using presigned URL: Conceda permissão a terceiros para enviar objetos com menos de 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 esta alternativa quando precisar de acesso de envio delegado e com limite de tempo.
Recursos relacionados
Utilize a barra de progresso de envio nos SDK do OSS para exibir o progresso e o tempo restante estimado. Para mais informações, consulte Upload progress bar.
Acione um callback no servidor de aplicações após o envio utilizando os callbacks de upload. Para obter mais informações, consulte Upload callbacks.
Para controlar o comportamento de cache, baixe e processamento, defina os metadados do objeto — incluindo cabeçalhos HTTP padrão, como Content-Type — durante o envio. Para mais detalhes, consulte gerencie object metadata.
Envie arquivos diretamente do cliente para o OSS a fim de reduzir a carga do servidor de aplicações e aumentar a velocidade de envio. Para saber mais, consulte Overview.
Para operações de imagem, como marca d'água, conversão de formato e consultas de metadados, consulte Image processing methods.
Para transcodificação de vídeo e captura de quadros após o envio, consulte Audio and video processing.
Para visualização e edição online de documentos do 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 URL to baixe or preview files.