Galerias pelo painel
Pelo painel você cria galerias, envia arquivos arrastando-os para a tela, copia a URL pronta e apaga o que não quer mais. O que o painel faz é o mesmo que a API de galerias, com as mesmas regras de varredura e de limites. Para automatizar, veja Galerias e arquivos.
Antes de começar
Seção intitulada “Antes de começar”- Você precisa ser membro do time (ou ter papel acima) para criar galerias e enviar arquivos. Quem só visualiza vê a lista, mas não vê os botões de criar e enviar.
- Excluir uma galeria exige papel de administrador e confirmação de identidade.
- O item Galerias só aparece quando o recurso está ligado na plataforma. Se aparecer “Galerias não estão disponíveis”, ele ainda não foi ligado.
Criar uma galeria
Seção intitulada “Criar uma galeria”- No menu do time, abra Galerias.
- Clique em Nova galeria (ou em Criar a primeira galeria, se a lista estiver vazia).
- Em Nome, escreva até 80 caracteres.
- Se quiser, escolha um Projeto (opcional). Isso só organiza a lista por projeto e não muda as URLs.
- Clique em Criar galeria.
A galeria ganha uma chave pública (por exemplo marcas-k7p2) que vai nas URLs. Você pode mudar o nome depois em Renomear / mover, mas a chave nunca muda.
Acompanhar a cota
Seção intitulada “Acompanhar a cota”No alto da lista, o cartão Uso da cota mostra duas barras: Armazenamento e Arquivos. A cota é do time, somando todas as galerias dele. Com 80% de uso aparece um aviso. Com a cota cheia, aparece “Cota cheia: novos envios serão recusados até liberar espaço.” e você precisa apagar arquivos antes de enviar novos.
Os valores padrão e outros limites estão em Limites e cotas. Os números exatos do seu time são os que as barras mostram.
Enviar arquivos
Seção intitulada “Enviar arquivos”- Clique em Abrir na galeria.
- Arraste arquivos para a área Arraste arquivos aqui ou clique para escolher, ou clique nela para escolher no computador. Pode enviar vários de uma vez.
- Para enviar um arquivo com outro nome, preencha antes Nome do arquivo (opcional, para envio de um arquivo só), com até 120 caracteres. Sem isso, vale o nome do arquivo, normalizado.
- Acompanhe a Fila de envio: Na fila, Enviando e Enviado · em análise. Clique em Limpar lista para esvaziar a fila.
Limites do envio pelo painel: 25 MB por arquivo, qualquer tipo, e imagens de até 40 megapixels. Todo arquivo passa por varredura de segurança antes de ser publicado.
Nomes de arquivo e versões
Seção intitulada “Nomes de arquivo e versões”O nome pode ter pastas separadas por / (por exemplo logos/acme.png) e é único dentro da galeria. Se você enviar outro arquivo com o mesmo nome, nasce uma nova versão e a URL alias passa a apontar para ela. Enviar o mesmo conteúdo no mesmo nome não cria versão nova.
A Nebular guarda as 5 versões mais recentes de cada arquivo; versões mais antigas só são removidas depois de 30 dias. A versão atual nunca é removida. Por isso, não dependa de uma URL fixa muito antiga: use a URL fixa de uma versão que você ainda considera atual.
URL imutável ou alias
Seção intitulada “URL imutável ou alias”Cada arquivo tem dois botões de cópia:
| Botão | O que copia | Quando usar |
|---|---|---|
| Copiar URL | O alias, que sempre aponta para a versão atual. Cache de 60 segundos. | Em sites: trocar a imagem não exige trocar o endereço. |
| Copiar URL fixa | O endereço com o hash da versão. O conteúdo não muda, cache de 1 ano. | Quando algo não pode mudar sozinho, como um e-mail já enviado. |
Clique em Detalhes para ver o Histórico de versões: a URL alias, a URL fixa de cada versão, as dimensões e o hash. Mais sobre o cache em Cache e purge.
Estados da varredura
Seção intitulada “Estados da varredura”Cada arquivo mostra um selo. O painel consulta sozinho os arquivos em análise por até 2 minutos.
| Selo | Significado | O que fazer |
|---|---|---|
| Verificado | Passou na varredura e está publicado. | Copie a URL e use. |
| Em análise | Ainda não foi publicado, o URL ainda não existe. | Espere. Não envie de novo. Se aparecer “Ainda em análise; volte mais tarde.”, reabra a galeria depois. |
| Recusado | A varredura detectou problema. O selo mostra o motivo. | Veja Classes de arquivo e varredura. Em SVG, reexporte como SVG estático. |
| Em quarentena | Estava publicado, mas uma nova varredura diária o detectou. Saiu do ar (a CDN responde 451). | Não insista. Se for falso positivo, avise o suporte. |
Mensagens de erro no envio
Seção intitulada “Mensagens de erro no envio”| Mensagem (resumo) | O que fazer |
|---|---|
| Passa do tamanho máximo por arquivo (25 MB) | Comprima ou divida o arquivo. |
| A cota de armazenamento do time acabou | Apague arquivos que não usa. |
| Tipo não aceito, extensão diferente do conteúdo, classe não permitida | Confira se a extensão corresponde ao conteúdo real. |
| Detecção de ameaça (com o nome da assinatura) | Verifique o arquivo. Pode ser falso positivo. |
| SVG recusado | Siga a tabela em Classes de arquivo e varredura. |
| Compactado com senha, ou formato 7z, rar, xz, bzip2 | Envie uma versão sem senha, em .zip ou .tar.gz. |
| Muitas requisições | Espere um instante e tente de novo. |
| Varredura temporariamente indisponível | É seguro tentar de novo em alguns minutos. |
- Arquivo: em Excluir, confirme em Excluir arquivo. O arquivo e todas as versões saem do ar, as URLs deixam de funcionar e o cache da CDN é limpo. Quem tem papel de membro pode apagar arquivos.
- Galeria: em Excluir, na galeria, que precisa estar vazia. Só administradores, com confirmação de identidade. Se ainda houver arquivos, aparece “Essa galeria ainda tem arquivos” e você deve apagá-los primeiro.
Tokens de API para mídia
Seção intitulada “Tokens de API para mídia”Para enviar arquivos por script ou por um agente, crie um token em Configurações do time, Tokens de API, com as permissões Ler arquivos (assets:read), Enviar e excluir arquivos (assets:write) e Gerenciar galerias (galleries:manage). Você pode restringir o token a galerias específicas; um token restrito não cria galerias novas. Detalhes em Tokens e escopos.
Se algo der errado
Seção intitulada “Se algo der errado”| Sintoma | O que fazer |
|---|---|
| Não vejo Nova galeria | Seu papel é de visualização. Peça a um membro ou administrador. |
| O selo fica em Em análise | O scanner pode estar ocupado. Não reenvie; volte mais tarde. |
| A URL copiada ainda mostra a imagem antiga | Cache de 60 s do alias. Use a URL fixa da nova versão. |
| Não consigo excluir a galeria | Apague os arquivos dela primeiro. |
Próximos passos
Seção intitulada “Próximos passos”- Galerias e arquivos para automatizar pela API.
- Transformar imagens para redimensionar e escolher formato.
- Limites e cotas.