# 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](/cdn/galerias/).

## 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

1. No menu do time, abra **Galerias**.
2. Clique em **Nova galeria** (ou em **Criar a primeira galeria**, se a lista estiver vazia).
3. Em **Nome**, escreva até 80 caracteres.
4. Se quiser, escolha um **Projeto (opcional)**. Isso só organiza a lista por projeto e não muda as URLs.
5. 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

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](/operacao/limites-e-cotas/). Os números exatos do seu time são os que as barras mostram.

## Enviar arquivos

1. Clique em **Abrir** na galeria.
2. 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.
3. 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.
4. 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

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

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](/cdn/cache-e-purge/).

## 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](/cdn/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

| 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](/cdn/classes-de-arquivo-e-varredura/#por-que-meu-svg-foi-recusado-e-como-reexportar). |
| 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. |

## Apagar

- **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

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](/seguranca/tokens-e-escopos/).

## 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

- [Galerias e arquivos](/cdn/galerias/) para automatizar pela API.
- [Transformar imagens](/cdn/transformar-imagens/) para redimensionar e escolher formato.
- [Limites e cotas](/operacao/limites-e-cotas/).
