ArmazémCopy Anchor Link

O Armazém é o armazenamento de objetos da Zenifra. Ele guarda imagens, vídeos, documentos, backups e qualquer outro arquivo das suas aplicações, com acesso pelo console ou pelas ferramentas e SDKs que você já usa. Você paga pelo espaço ocupado e pelas requisições, sem plano mínimo.

O Armazém está em beta e, por enquanto, é liberado para organizações convidadas. Se a sua organização ainda não tem acesso, abra o menu Armazém no console, conte como pretende usar e clique em Quero participar do beta. Quando a organização for liberada, o owner e quem fez o pedido recebem um e-mail.

Como funcionaCopy Anchor Link

1. Crie o Armazém. Cada organização tem um Armazém, criado no menu Armazém do console. Ele é permanente: não é possível removê-lo, só os buckets dentro dele.
2. Crie buckets. Um bucket agrupa arquivos, como fotos, documentos ou backups.
3. Envie arquivos ou conecte uma aplicação. Use o console para enviar e baixar arquivos, ou crie uma chave de acesso e conecte sua aplicação. Veja Conectar aplicações.

BucketsCopy Anchor Link

O nome de um bucket é único em todo o Armazém e segue estas regras:

• de 3 a 63 caracteres;
• apenas letras minúsculas, números, ponto e hífen;
• começa e termina com letra ou número, sem dois pontos seguidos;
• não pode ter formato de endereço IP;
• admin é reservado.

Cada organização pode ter até 10 buckets. Veja Limites e cobrança para pedir mais.

Excluir um bucketCopy Anchor Link

Um bucket vazio é excluído na hora. Um bucket com arquivos só é excluído depois de uma confirmação de quem está conectado ao console:

• contas com verificação em duas etapas digitam o código do aplicativo autenticador;
• as demais contas recebem por e-mail um código de 6 dígitos, válido por 15 minutos.

Depois da confirmação, o bucket e todos os arquivos são apagados em segundo plano. Arquivos apagados não podem ser recuperados. Chaves de acesso e API Keys não excluem buckets com arquivos.

Arquivos no consoleCopy Anchor Link

Ao abrir um bucket, você navega pelas pastas e pode:

• Enviar arquivos para a pasta atual, até 20 GB por arquivo, e cancelar o envio enquanto ele acontece;
• Criar pastas com Nova pasta, inclusive várias de uma vez, como documentos/2026;
• Excluir uma pasta vazia;
• Baixar um arquivo direto do Armazém;
• Copiar link de um arquivo, válido por 7 dias para qualquer pessoa que o tiver;
• Ver detalhes ao clicar no nome: caminho, tamanho, tipo, data de envio, ETag e metadados;
• Editar os metadados de um arquivo no painel de detalhes;
• Excluir um arquivo.

Os arquivos vão direto do seu navegador para o Armazém, sem passar por outros servidores.

Pastas e nomesCopy Anchor Link

As pastas organizam os arquivos dentro de um bucket: documentos/2026/contrato.pdf é o arquivo contrato.pdf dentro da pasta 2026, que fica dentro de documentos. Nos envios pelo console e pelos links de envio da Zenifra:

Uma pasta criada pelo console continua aparecendo mesmo vazia. Para excluí-la, apague antes os arquivos dentro dela.

MetadadosCopy Anchor Link

Metadados são pares de nome e valor guardados junto com o arquivo, como nota-fiscal: 123 ou origem: app-pedidos. Eles voltam em toda leitura do arquivo e ajudam a identificar e organizar o conteúdo. No console, abra os detalhes do arquivo e clique em Editar metadados. Pela API, envie os metadados junto com o arquivo, como cabeçalhos x-amz-meta-<nome>, que os SDKs preenchem com o campo Metadata.

Salvar novos metadados substitui todos os anteriores e mantém o conteúdo, o tipo e as demais informações do arquivo. Se o arquivo mudar enquanto você edita, o console avisa e pede para abrir os detalhes de novo.

Chaves de acessoCopy Anchor Link

Aplicações se conectam ao Armazém com uma chave de acesso (ID e segredo):

• crie uma chave por aplicação, com um nome que identifique quem a usa;
• o segredo aparece uma única vez, na criação; guarde-o em uma variável de ambiente;
• escolha os buckets da chave (todos ou até 10) e o nível de acesso: Somente leitura (listar e baixar), Leitura e envio (também enviar arquivos) ou Completo (tudo, inclusive apagar; com todos os buckets, também criar e excluir buckets). O próprio Armazém recusa o que estiver fora do escopo;
• limite a chave às redes da aplicação: até 20 endereços IPv4 ou IPv6, com ou sem CIDR. Requisições de outras redes são recusadas;
• revogue a chave quando ela não for mais usada.

Cada organização pode ter até 10 chaves. Você só consegue dar a uma chave o acesso que você mesmo tem nos mesmos buckets.

PrivacidadeCopy Anchor Link

Nada no Armazém fica público. Não é possível tornar um bucket ou arquivo público, e todo acesso exige uma assinatura válida, seja de uma chave de acesso, seja de um link que expira. Para compartilhar um arquivo, use Copiar link no console ou gere um link assinado na sua aplicação.

PermissõesCopy Anchor Link

As permissões do Armazém podem ser dadas para o Armazém inteiro ou bucket por bucket. Para valer em todos os buckets, inclusive os criados depois, escolha Todos os buckets.

Quem tem permissão em algum bucket já vê o Armazém, e a lista mostra só os buckets em que a pessoa pode fazer algo. O console esconde os botões das ações que a pessoa não pode fazer. owner tem acesso completo; assistant, member e API Keys precisam das permissões. Veja Organizações.

Modelos de políticaCopy Anchor Link

Ao criar uma política na tela de membros, escolha um Modelo do Armazém e os buckets (todos ou alguns). O modelo preenche as permissões, e você ainda pode ajustar antes de salvar.

FAQCopy Anchor Link

Posso ter mais de um Armazém?Copy Anchor Link

Não. Cada organização tem um Armazém e organiza os arquivos em buckets.

Posso mudar o nome de um bucket?Copy Anchor Link

Não. Crie outro bucket, copie os arquivos e exclua o anterior.

O Armazém funciona com aplicações fora da Zenifra?Copy Anchor Link

Sim. Qualquer aplicação com uma chave de acesso, a partir de uma rede permitida, se conecta pelo endereço público.

Próximos passosCopy Anchor Link

• Conectar aplicações
• Limites e cobrança
• Limites e quotas da Zenifra