Tovanix
Tovanix

Usar o armazenamento de objetos

Este guia trata da ativação e do uso do armazenamento de objetos da Tovanix:

  • Compatível com S3, sem cobrança adicional pelo tráfego de saída; a assinatura é por conta, a mensalidade inclui um volume de armazenamento e de requisições, e o excedente é cobrado diariamente do saldo.
  • Ao criar um bucket, escolha a localização e a classe de armazenamento; o sistema acrescenta automaticamente um prefixo ao nome para torná-lo único globalmente.
  • Cada bucket pode ter várias chaves de acesso de somente leitura ou de leitura e escrita; o Secret só aparece uma vez, e chaves novas levam algum tempo para sincronizar.
  • No console, você envia e baixa arquivos, com envio automático em partes para arquivos grandes, e configura acesso público, CORS, ciclo de vida, migração e bloqueio.
  • A partir do dia do vencimento, os buckets ficam somente leitura e as chaves emitidas são revogadas; se não houver renovação em 7 dias, os dados são esvaziados e excluídos.

O que é e como é cobrado

O armazenamento de objetos é compatível com S3: cada bucket recebe chaves de acesso próprias, e os SDKs e ferramentas S3 que você já usa se conectam diretamente; o tráfego de saída não tem cobrança adicional. Em Serviços em nuvem → Buckets, escolha o período de compra (1, 3, 6 ou 12 meses) e clique em “Ativar agora”; a assinatura é por conta, e depois da ativação você pode criar vários buckets.

  • A mensalidade inclui um volume de armazenamento e um número de requisições por mês, e há um limite de buckets; o que passar disso é cobrado pelo armazenamento e pelas requisições (das classes A e B). Os números exatos são os mostrados na página de ativação.
  • O uso é coletado uma vez por dia (por dia UTC); o “Excedente neste mês (estimativa)” é calculado com o uso já coletado e não inclui a mensalidade.
  • O excedente é cobrado diariamente do saldo da conta, que pode ficar negativo por causa disso; quando isso acontece, você recebe um aviso — mantenha saldo suficiente.

Criar um bucket

Na página Buckets, clique em “Criar bucket”: o nome só pode ter letras minúsculas, números e hífens, e o sistema acrescenta automaticamente um prefixo para torná-lo único globalmente — você sempre vê o nome que escolheu; a localização pode ser “Automático” (o sistema escolhe a mais próxima) ou uma região definida; a classe de armazenamento pode ser “Padrão” ou “Acesso infrequente”.

A lista de buckets mostra o espaço ocupado, a localização e a classe de armazenamento de cada um. Clique no nome para abrir os detalhes, divididos em quatro abas: “Objetos”, “Chaves de acesso”, “Métricas” e “Configurações”.

Chaves de acesso

  • Na aba “Chaves de acesso” do bucket, clique em “Emitir chave” e escolha a permissão “Leitura e escrita” ou “Somente leitura”. A chave emitida só acessa esse bucket e pode ser usada em qualquer SDK ou ferramenta S3; um bucket pode ter várias chaves.
  • A Secret Access Key só aparece uma vez, na emissão, e não pode ser vista de novo depois que a janela é fechada; copie e guarde na hora, ou use “Copiar como configuração”.
  • Uma chave nova leva algum tempo para ser sincronizada com os nós de armazenamento, e a página informa quantos segundos, aproximadamente; nesse intervalo, as chamadas retornam 401 — isso não significa que a chave está errada; basta esperar um pouco e tentar de novo.
  • Em “Geral”, nas “Configurações” do bucket, ficam o endpoint S3 e o nome completo do bucket, necessários para a integração; use “Revogar” nas chaves que não usa mais. A forma de integração e exemplos de código estão na documentação da API de armazenamento de objetos (/docs/objstore).

Gerenciar arquivos no console

Na aba “Objetos” do bucket, você pode usar “Nova pasta”, “Enviar” arquivos ou “Enviar pasta”, além de baixar, copiar o link, excluir e filtrar por prefixo do nome; arquivos grandes são enviados automaticamente em partes, e o caminho do arquivo pode ter até 1024 bytes. Marque vários arquivos ou pastas para excluí-los juntos.

Na primeira vez que você abre um bucket, é preciso preparar credenciais de acesso temporárias, o que leva cerca de meio minuto e continua sozinho ao terminar. A aba “Métricas” mostra o uso desse bucket, com dados atualizados uma vez por dia; buckets novos só têm dados a partir do dia seguinte.

Configurações do bucket

A aba “Configurações” dos detalhes do bucket tem os itens abaixo:

  • Geral — Mostra o nome completo do bucket, o endpoint S3, a localização, a classe de armazenamento e a data de criação.
  • Acesso público — Com ele ativado, todos os objetos do bucket podem ser lidos publicamente por qualquer pessoa. A “URL pública de desenvolvimento” serve só para testes; para uso real, vincule um “Domínio personalizado”, que só pode ser um domínio da sua conta com DNS hospedado.
  • CORS — É preciso configurar o CORS quando páginas da web leem e gravam direto neste bucket (envio e leitura diretos pelo front-end); a origem não pode ser o curinga *.
  • Ciclo de vida — Exclui objetos automaticamente, os move para acesso infrequente ou limpa uploads em partes não concluídos, conforme o prefixo e o número de dias; recomendamos adicionar a todos os buckets uma regra que limpe as partes não concluídas.
  • Migração — Traz aos poucos, conforme o acesso, os dados de um bucket S3 que você tem em outro lugar: quando é lido um arquivo que este bucket ainda não tem, ele é buscado na hora no bucket de origem e guardado aqui, sem interromper o serviço. Informe o nome, a região e a chave de acesso do bucket de origem — basta permissão de leitura; a plataforma usa essa chave só para ler o bucket de origem e não a guarda. Os dados migrados ocupam o armazenamento deste bucket e contam nas requisições; ao desativar a migração, os arquivos já migrados continuam neste bucket.
  • Bloqueio — Durante o período de retenção, os arquivos que correspondem ao prefixo não podem ser excluídos nem sobrescritos — nem por você nem pelo suporte da plataforma —, e a cobrança continua normalmente nesse período. O prazo é definido em dias, com o máximo mostrado na página; não há bloqueio permanente.
  • Uploads incompletos — Quando o envio de um arquivo grande é interrompido, as partes já enviadas ficam guardadas e são cobradas como armazenamento, mas não aparecem na lista de arquivos; aqui você as vê e pode limpar as partes com mais de 24 horas.
  • Zona de perigo — “Esvaziar bucket” exclui todos os arquivos do bucket, sem possibilidade de recuperação; o bucket precisa ser esvaziado antes de ser excluído, e, ao excluí-lo, todas as chaves desse bucket são revogadas junto.

Renovação e vencimento

  • Na página Buckets, clique em “Renovar”, escolha a duração e pague. No momento não há renovação automática; a plataforma envia lembretes antes do vencimento.
  • A partir do dia do vencimento, os buckets ficam somente leitura: ainda é possível navegar, baixar, excluir e esvaziar, mas não enviar arquivos, alterar configurações, criar buckets nem emitir chaves novas.
  • Depois do vencimento, as chaves de acesso emitidas são revogadas; depois da renovação, é preciso emiti-las de novo.

Se não houver renovação até 7 dias depois do vencimento, a plataforma esvazia e exclui os dados dos buckets, sem possibilidade de recuperação, e avisa você depois da exclusão. Baixe os dados que quiser guardar ou renove antes disso.

Diagnóstico

  • Uma chave recém-emitida retorna 401 — A chave nova ainda está sendo sincronizada com os nós de armazenamento — Espere o tempo indicado na página e tente de novo, sem recriar a chave várias vezes.
  • A fatura cobra armazenamento, mas o bucket não mostra tantos arquivos — Há partes de envios interrompidos, que não aparecem na lista de arquivos — Veja e limpe em Configurações → Uploads incompletos.
  • Não é possível excluir o bucket — O bucket ainda tem arquivos, ou há arquivos dentro do período de bloqueio — Use antes “Esvaziar bucket”; se houver aviso de bloqueio, confira as regras em Configurações → Bloqueio — os arquivos no período de retenção só podem ser excluídos depois que ele terminar.
  • Ao abrir o bucket, aparece o aviso de que as credenciais de acesso temporárias estão sendo preparadas — Na primeira abertura, é preciso preparar credenciais temporárias — Leva cerca de meio minuto e continua sozinho ao terminar, sem precisar atualizar a página.
  • Aviso de que o limite de buckets foi atingido — A conta chegou ao limite de buckets — Exclua buckets que não usa mais e crie o novo.
  • O saldo da conta ficou negativo — O que passa do volume incluído é cobrado diariamente do saldo — Recarregue para cobrir o saldo; o excedente previsto do mês aparece na página Buckets.

Perguntas frequentes

Baixar arquivos tem cobrança extra de tráfego?

Não, o tráfego de saída não tem cobrança adicional. A cobrança vem da mensalidade e do armazenamento e das requisições que passam do volume incluído.

Os dados são excluídos assim que o serviço vence?

Não. A partir do dia do vencimento, os buckets ficam somente leitura, e você pode baixar e limpar os dados; só depois de 7 dias sem renovação eles são esvaziados e excluídos, sem possibilidade de recuperação.

E se eu perder a Secret Access Key?

Ela só aparece uma vez, na emissão, e não pode ser recuperada. Revogue a chave antiga e emita uma nova.

Páginas relacionadas: Central de Ajuda · Guias e perguntas frequentes · Armazenamento de objetos compatível com S3 · API de armazenamento de objetos

Carregando…