O OSS aceita qualquer tipo de arquivo — imagens, documentos, vídeos e muito mais. Faça upload de objetos individualmente ou em lote, utilizando o método que melhor se adapta ao tamanho do arquivo, às condições de rede e à origem do upload.
Métodos de upload
O OSS oferece seis métodos de upload. Escolha com base no tamanho do arquivo, nas condições de rede e em quem inicia o upload.
|
Método |
Tamanho máximo |
Mais adequado para |
|
Upload simples |
5 GB |
Arquivos pequenos em uma conexão estável |
|
Upload multipart |
48,8 TB |
Arquivos grandes que se beneficiam de uploads paralelos |
|
Upload por append |
5 GB por append |
Dados de streaming gravados incrementalmente |
|
Upload resumível |
48,8 TB |
Arquivos grandes em redes instáveis |
|
Upload baseado em formulário |
5 GB |
Uploads pelo navegador a partir de uma página HTML |
|
Upload por URL pré-assinada |
Menos de 5 GB |
Uploads de terceiros sem expor pares de AccessKey |
Upload simples: faça upload de arquivos de até 5 GB com uma única chamada de API
PutObject. Não requer configuração. Use este método para uploads de rotina em que o tamanho do arquivo e a estabilidade da rede não são preocupações.Upload multipart: faça upload de arquivos de até 48,8 TB dividindo-os em partes e carregando em paralelo. Chame
InitiateMultipartUpload,UploadParteCompleteMultipartUploadem sequência; o OSS monta as partes em um único objeto. Se o upload for interrompido, o cliente registra quais partes falharam e tenta novamente apenas essas. Ideal para arquivos grandes em que o throughput paralelo é importante.Upload por append: adicione dados a um objeto existente usando a API
AppendObject. Cada operação de append pode ter até 5 GB. Os dados adicionados ficam imediatamente legíveis. Indicado para fluxos de vídeo ou arquivos de log em que o conteúdo cresce continuamente. Apenas objetos do tipo appendable oferecem suporte a este método.Upload resumível: faça upload de arquivos de até 48,8 TB em conexões instáveis. Os SDKs do OSS — como o método
uploadFileno SDK do OSS para Java — criam checkpoints de progresso automaticamente para que o upload continue de onde parou. Prefira este método ao upload multipart quando interrupções de rede forem prováveis e você quiser recuperação automática sem lógica de retry no lado do cliente.Upload por formulário: permite que os usuários façam upload de objetos de até 5 GB diretamente de uma página HTML via HTTP POST. Uma política gerada pelo servidor controla as restrições de upload, como tamanho e tipo do objeto. Mais adequado para aplicações web em que o navegador inicia o upload.
Upload de objetos por URLs pré-assinadas: conceda a terceiros permissão para fazer upload de objetos com menos de 5 GB sem compartilhar seu par de AccessKey. Gere uma URL pré-assinada com um período de validade definido; a URL se torna inválida automaticamente após expirar. Recomendado quando você precisa conceder acesso temporário e delegado para upload.
Recursos relacionados
Use a barra de progresso de upload nos SDKs do OSS para exibir o progresso do upload e o tempo restante estimado. Para mais informações, consulte Barra de progresso de upload.
Acione um callback para o servidor de aplicação após um upload usando callbacks de upload. Para mais informações, consulte Callbacks de upload.
Para controlar o comportamento de cache, download e processamento, defina metadados do objeto — incluindo cabeçalhos HTTP padrão como Content-Type — no momento do upload. Para mais informações, consulte Gerenciar metadados de objetos.
Faça upload de arquivos diretamente do seu cliente para o OSS para reduzir a carga no servidor de aplicação e melhorar a velocidade de upload. Para mais informações, consulte Visão geral.
Para operações com imagens, como marca d'água, conversão de formato e consultas de metadados, consulte Métodos de processamento de imagens.
Para transcodificação de vídeo e captura de quadros após o upload, consulte Processamento de áudio e vídeo.
Para pré-visualização e edição online de documentos PowerPoint e Word, consulte Pré-visualização online do WebOffice e Edição online do WebOffice.
Para compartilhar um objeto com terceiros após o upload, adicione informações de assinatura à URL do objeto e distribua a URL assinada. Para mais informações, consulte Usar URLs pré-assinadas para baixar ou pré-visualizar arquivos.