Use Armazenamento do App para armazenar, organizar e gerenciar arquivos usados pelo seu app em execução, incluindo imagens, vídeos, documentos e uploads de usuários.

Antes de usar o Armazenamento do App, conecte o projeto ao Atoms Cloud. Se ele não estiver conectado, peça ao Agente para conectar o Atoms Cloud ou siga Atoms Cloud.

Entenda o Armazenamento do App no Atoms Cloud

Armazenamento do App armazena arquivos que seu projeto precisa manter e acessar. Ele é separado dos dados estruturados armazenados no seu Banco de Dados, dos arquivos enviados no Chat e dos arquivos que compõem o código do seu projeto.

Termos-chave

• Bucket: O contêiner principal usado para armazenar e agrupar arquivos relacionados. Você pode pensar em um bucket como uma área de armazenamento para uma categoria de arquivos. Cada bucket é definido como Public ou Private, o que controla quem pode acessar os arquivos dentro dele.
• Folder: Uma forma opcional de organizar arquivos dentro de um bucket. As pastas funcionam como as pastas no seu computador e podem ajudar a manter coleções maiores de arquivos mais fáceis de gerenciar.
• Object: Um arquivo individual armazenado em um bucket ou pasta, como uma imagem, documento, vídeo ou outro arquivo enviado.
• Object key: O caminho exclusivo usado para identificar onde um arquivo está armazenado dentro de um bucket. Por exemplo, images/profile/avatar.png pode ser a object key de uma imagem armazenada dentro de uma pasta images/profile.

Escolha Public ou Private

Escolha o tipo de bucket antes de criá-lo:

Tipo de bucket	Use para
Private	Arquivos sensíveis, específicos da conta ou enviados por usuários.
Public	Arquivos não sensíveis que são intencionalmente seguros para exposição pública.

Use Private para arquivos sensíveis ou específicos do usuário. Se você encontrar um erro de acesso, não altere o bucket para Public apenas para tornar o arquivo acessível. Em vez disso, certifique-se de que seu app verifica se a pessoa que está solicitando o arquivo tem permissão para acessá-lo.

Abra o Armazenamento do App no Atoms Cloud

1. Abra seu projeto em um dispositivo desktop.
2. Na mesma barra de ferramentas do espaço de trabalho onde está o Visualizador de App , selecione Atoms Cloud.
3. Selecione Armazenamento do App na barra lateral do Atoms Cloud.

Permissões no Armazenamento do App

O Armazenamento do App usa sua função no espaço de trabalho. Tanto Editors quanto workspace owners podem gerenciar o armazenamento dos projetos que conseguem abrir. Pessoas que não são membros do espaço de trabalho não podem abrir nem gerenciar o Armazenamento do App do projeto.

A configuração Public ou Private do bucket não altera quem pode gerenciá-lo no Atoms Cloud. Essa configuração controla como o app em execução pode fornecer acesso aos arquivos; as permissões do espaço de trabalho controlam quem pode gerenciar o armazenamento a partir do espaço de trabalho do Atoms Cloud.

Crie um bucket

Um app pode ter até 10 buckets. Crie buckets separados quando diferentes grupos de arquivos precisarem de configurações de acesso diferentes ou precisarem ser mantidos separados para facilitar a organização.

1. Na página Armazenamento do App, selecione Create Bucket.
2. Em Bucket Name, insira um nome exclusivo para o bucket. O nome deve:
   • conter de 3 a 63 caracteres;
   • usar apenas letras minúsculas, números e hífens; e
   • começar e terminar com uma letra ou número.
3. Em Bucket Type, escolha Private ou Public. Public é selecionado por padrão, então certifique-se de escolher o nível de acesso desejado antes de continuar.
4. Selecione Create.

O novo bucket aparece na página Armazenamento do App com seu nome, tipo e data de criação. Selecione o bucket para abri-lo e visualizar seu conteúdo.

Selecione Create Bucket no Armazenamento do App.

Os nomes dos buckets não podem ser alterados após a criação, então escolha um nome claro que você não precisará mudar depois. Se o seu app já tiver 10 buckets, Create Bucket não estará mais disponível.

Envie e organize arquivos

Dentro de um bucket, você pode enviar arquivos diretamente ou criar uma pasta vazia sem enviar nenhum arquivo primeiro.

Crie uma nova pasta

1. Abra o bucket ou a folder onde você deseja criar a nova pasta.
2. Selecione Add Folder.
3. Digite um nome para a pasta e selecione Create. Os nomes das pastas podem conter letras, números, pontos (.), hífens (-) e sublinhados (_), e não podem ter mais de 100 caracteres. Os nomes das pastas não podem ser alterados após a criação.

Dê um nome à pasta e selecione Create.

Envie arquivos

1. Abra o bucket ou a folder onde você deseja armazenar os arquivos.
2. Selecione Upload e depois escolha um ou mais arquivos do seu dispositivo. Cada arquivo pode ter até 100 MB.
3. Aguarde a conclusão do upload e verifique se os arquivos aparecem na lista.

A lista de arquivos mostra o Name, Type, Size, a data de Last Modified e as Actions disponíveis de cada item. Se você precisar recarregar o conteúdo da pasta atual, selecione o botão refresh.

Envie arquivos para o bucket ou pasta selecionado.

Visualize e gerencie arquivos

Selecione um arquivo para abrir File Details. Imagens e vídeos compatíveis podem ser visualizados no painel. Outros tipos de arquivo mostram seus detalhes disponíveis e ainda podem ser baixados. Se todos os créditos forem usados, File Details mostra um estado de créditos esgotados, e Download de arquivo único direciona você para Atualizar em vez de baixar.

Gerencie um arquivo

Abra ... na coluna Actions do arquivo e escolha:

• Download para salvar uma cópia local quando houver créditos disponíveis. Se todos os créditos forem usados, essa ação direcionará você para Atualizar.
• Rename para alterar o nome do arquivo. O novo nome pode usar letras, números, pontos, hífens e sublinhados.
• Delete para remover o arquivo após a confirmação.

Use o menu de ações do arquivo para baixá-lo, renomeá-lo ou excluí-lo.

Gerencie vários arquivos

1. Selecione a caixa de seleção ao lado de cada arquivo. Pastas não são incluídas na seleção em lote.
2. Selecione Download para baixar os arquivos selecionados juntos ou selecione Delete.
3. Se estiver excluindo, revise o número de arquivos selecionados e confirme Delete.

A exclusão não pode ser desfeita no Armazenamento do App. Antes de renomear ou excluir um arquivo, verifique se o app ainda usa sua object key. Atualize quaisquer referências armazenadas depois disso para que o app não continue solicitando a chave antiga.

Use um arquivo armazenado no seu app

Seu app identifica cada arquivo armazenado usando seu bucket name e sua object key. A object key mostra onde o arquivo está localizado dentro do bucket. Por exemplo, images/profile/avatar.png pode ser a object key de uma imagem armazenada dentro de uma pasta images/profile.

Armazene o bucket name e a object key no banco de dados do seu app para que ele possa localizar o arquivo depois. Quando seu app precisar exibir ou baixar o arquivo, ele poderá usar esses detalhes para solicitar uma URL de acesso.

As URLs de acesso podem ser temporárias. Não as salve como dados permanentes do app, não as codifique diretamente no seu app nem as compartilhe no Chat, em capturas de tela, logs ou mensagens de suporte. Em vez disso, armazene a object key e solicite uma nova URL de acesso quando o arquivo precisar ser acessado.

Não armazene chaves de API, senhas ou outras credenciais no Armazenamento do App. Armazene credenciais privadas de runtime em Chaves and secrets. Somente o proprietário do espaço de trabalho pode gerenciar credenciais privadas de runtime lá. Se você for um Editor, peça ao proprietário do espaço de trabalho para adicionar ou atualizar a credencial.

Limites atuais

Limite	Valor atual
Buckets por app	10
Tamanho de cada arquivo enviado	100 MB

Para informações atuais de uso e capacidade do Cloud, consulte Cloud & AI Wallet.

FAQ

Meu espaço em disco está cheio. Como libero armazenamento?

1. Verifique o uso atual de armazenamento e identifique os maiores chats, projetos ou arquivos.
2. Baixe ou faça backup de tudo o que você possa precisar depois.
3. Exclua apenas os itens de que você não precisa mais. Se excluir um chat apresentar uma opção para remover dados de disco associados, selecione-a somente após confirmar que os dados podem ser descartados.
4. Remova arquivos grandes desnecessários, depois atualize e verifique novamente o espaço disponível.

A exclusão pode ser permanente e pode afetar um projeto que faz referência ao arquivo removido. Se o uso não diminuir após a limpeza, entre em contato com o Suporte com uma captura de tela do armazenamento, seu plano e a conta ou espaço de trabalho afetado. Não envie o conteúdo dos arquivos, a menos que seja solicitado por um canal aprovado.