Enviar um arquivo para o Blob Storage
Envie um arquivo de até 100 MB para o Blob Storage com POST /v1/objects: público ou privado, com opções de expiração, cache, metadados e checksum.
A chave da API para sua conta. Você pode encontrá-la nas configurações da conta.
id e, para arquivos públicos, uma url da CDN que você pode incorporar ou compartilhar diretamente. Ele dá suporte a anexos, exportações geradas e mídias enviadas por usuários em aplicações hospedadas na plataforma.
Uma única requisição aceita arquivos de 512 bytes até 100 MB. Arquivos maiores, até 10 GiB, passam pelo fluxo de upload em partes ou pelo gateway S3. Exige o escopo blob:write, ou um token de upload enviado em Authorization, e um plano ativo.
Trate o
id retornado como opaco: guarde-o como veio e envie-o de volta às outras rotas. Ele começa com pub/ ou prv/ e pode mudar quando o arquivo muda de visibilidade ou de expiração.Parâmetros
Use FormData (
Envie um nome de arquivo real: a extensão armazenada vem dele (
multipart/form-data), exatamente um arquivo por requisição.Envie um nome de arquivo real: a extensão armazenada vem dele (
reads.fastq.gz continua .fastq.gz).O nome do arquivo, sem extensão. De 1 a 128 caracteres: letras, dígitos,
_, . e -, começando com uma letra, um dígito ou _. Não pode conter ...O caminho da pasta do arquivo, com até 8 segmentos separados por
/ e 256 caracteres no total. Cada segmento segue o mesmo padrão de name, com até 64 caracteres. Uma / no final é ignorada.true armazena o arquivo sem URL pública. Leia-o pelo Download de Objeto, por um link de compartilhamento ou pelo gateway S3. Quando omitido, a regra do prefixo decide.Exclui o arquivo automaticamente depois desse tempo:
30 ou 30d para dias, 6h para horas. De 1 hora a 1825 dias (5 anos). Expirações abaixo de 7 dias exigem o plano Enterprise. Quando omitido, a regra do prefixo decide.true adiciona um sufixo aleatório ao nome, para que a URL não possa ser adivinhada e um novo upload nunca substitua um antigo. Arquivos privados sempre o recebem (false junto com private=true é recusado).Sem security hash, um novo upload com o mesmo nome e prefixo substitui o arquivo.
false o recusa com 409 OBJECT_ALREADY_EXISTS.true faz os navegadores baixarem o arquivo em vez de abri-lo, seja qual for o tipo.Por quanto tempo a CDN e os navegadores mantêm o arquivo:
immutable (1 ano), max-age=N com N de 60 a 31536000 segundos (fora do Enterprise, um valor abaixo de 86400 sobe para 1 dia), ou no-cache (toda leitura vai ao armazenamento; somente Enterprise). Sem ele, um arquivo público sai com public, max-age=31536000 (1 ano), e um arquivo com security hash, com immutable. O cache nunca dura mais que a expiração do arquivo. Sobrescrever um arquivo com o mesmo nome limpa a CDN, mas um navegador que já o baixou pode manter a cópia até ela vencer: para um arquivo que muda, use security hash, um nome novo ou um max-age curto.Um objeto JSON de valores string, retornado pelo Informações do Objeto. As chaves usam
a-z, 0-9 e - (até 64 caracteres). Até 5 chaves e 512 bytes no total. Somente Pro e Enterprise.O SHA-256 do arquivo. Quando não corresponde, o upload é recusado com
CHECKSUM_MISMATCH e nada é armazenado.Limites de taxa e concorrência
- Cada conta pode ter no máximo 4 uploads em andamento ao mesmo tempo (
TOO_MANY_CONCURRENT_UPLOADS, 429). - Os planos Hobby e Standard são limitados a 1 upload por segundo (
RATE_LIMITED, 429). Pro e Enterprise são isentos. - Uploads que passariam do limite de armazenamento da conta (a cota incluída, mais o teto do excedente quando ele está ligado) são recusados com
STORAGE_QUOTA_EXCEEDED.
Tipos de arquivo
Praticamente qualquer extensão é aceita, incluindo formatos sem tipo MIME registrado (.bam, .vcf, .fasta, .parquet, .h5, .npy e assim por diante).
- O
Content-Typeservido é derivado no servidor a partir da extensão. Formatos desconhecidos são servidos comoapplication/octet-stream. - Formatos que um navegador renderiza (
.html,.svg,.xmle similares) são sempre servidos como download. - Executáveis e instaladores são recusados com
BLOCKED_FILE_TYPE:exe,msi,dll,bat,cmd,com,scr,cpl,pif,hta,vbs,vbe,jse,wsf,wsh,msc,reg,lnk,sys,drv,ps1,apk,xpi. - Uma regra do prefixo ou um token de upload pode restringir as extensões e o tamanho aceitos.
Resposta
Erros
Veja Erros para a lista completa.
Relacionados
- SDK do Blob:
blob.put()

