> ## Documentation Index > Fetch the complete documentation index at: https://docs.replit.com/llms.txt > Use this file to discover all available pages before exploring further. # App Storage > Aprenda como usar o App Storage para hospedar e gerenciar uploads de arquivos como imagens, vídeos e documentos. O App Storage é o armazenamento de objetos integrado do Replit que permite que seu app hospede e salve facilmente uploads como imagens, vídeos e documentos. Buckets são contêineres para armazenar objetos, como arquivos. Eles incluem políticas de acesso para limitar quais ações usuários ou aplicações podem executar sobre seu conteúdo. Renomeamos o Object Storage para App Storage. A funcionalidade não mudou e seus buckets, permissões e acesso programático existentes devem continuar funcionando. Com o App Storage, você pode criar apps como: * **Plataformas de compartilhamento de fotos**: permita que criadores façam upload, armazenem e exibam imagens * **Serviços de streaming de vídeo**: gerencie uploads de vídeo e forneça conteúdo aos espectadores * **Sistemas de gerenciamento de documentos**: armazene e organize arquivos de criadores com acesso seguro * **Sites de portfólio**: exiba trabalhos com arquivos de mídia que carregam de forma confiável * **Serviços de backup de arquivos**: forneça aos criadores armazenamento em nuvem para seus arquivos importantes captura de tela da ferramenta App Storage Peça ao **Agent** para adicionar App Storage ao seu app com detalhes sobre quais tipos de arquivo seu app deve gerenciar. O Agent configurará a integração, criará os buckets necessários e atualizará seu app para fazer upload, armazenar e recuperar arquivos com recursos avançados como autenticação e controles de acesso. A ferramenta App Storage permite que você compartilhe dados perfeitamente entre seus ambientes de desenvolvimento e produção ou com outros Replit Apps. ## Recursos O App Storage é baseado no Google Cloud Storage (GCS). Isso significa que você recebe os benefícios de disponibilidade, tempo de atividade e segurança líderes do setor. O App Storage oferece os seguintes recursos para seus Replit Apps: * **Armazenamento em nuvem persistente**: armazene arquivos que permanecem acessíveis ao seu app publicado e aos usuários * **Gerenciamento de arquivos escalável**: atenda às necessidades crescentes de dados sem se preocupar com limites de armazenamento * **Compartilhamento de dados entre apps**: compartilhe buckets entre vários Replit Apps para arquiteturas distribuídas * **Acesso programático**: faça upload, download e gerencie arquivos usando APIs intuitivas * **Integração avançada com o Agent**: deixe o Agent configurar o App Storage com configurações avançadas, inspecionar configurações existentes e gerar código completo de back-end e front-end com autenticação e controles de acesso Aqui estão algumas maneiras de usar o App Storage nos seus Replit Apps: * Armazenar fotos de perfil de criadores e uploads de mídia * Servir imagens de produtos para sites de e-commerce * Gerenciar uploads de documentos para envios de formulários * Criar recursos de compartilhamento e colaboração de arquivos * Criar sistemas de gerenciamento de conteúdo com bibliotecas de mídia **Integração avançada com o Agent**: você pode pedir ao [Replit Agent](/pt/features/agent/overview) para adicionar automaticamente o App Storage aos seus apps! O Agent agora pode configurar o armazenamento de objetos, inspecionar configurações e gerar código completo de back-end e front-end com recursos avançados como autenticação e controles de acesso. Basta mencionar "App Storage" ou "armazenamento de arquivos" no seu prompt. Add App Storage to my app to store files Create a photo gallery app with App Storage for images Set up App Storage with authentication for user file uploads Saiba mais sobre [integrações do Agent](/pt/features/integrations/overview#data-storage--management) e veja todos os prompts de App Storage disponíveis. ## Uso Seu Replit App precisa se autenticar com o Google Cloud Storage para acessar um bucket e seus objetos. Use as bibliotecas de cliente oficiais do App Storage do Replit para autenticar automaticamente. Você pode acessar a ferramenta App Storage diretamente no seu Project Editor. No **Tool dock** à esquerda: 1. Selecione Ícone de todas as ferramentas **All tools** para ver uma lista das ferramentas do Project Editor. 2. Selecione Ícone do App Storage **App Storage**. Na **barra de pesquisa**: 1. Selecione a ícone de lupa lupa no topo para abrir a ferramenta de pesquisa. 2. Digite "App Storage" para localizar a ferramenta e selecione-a nos resultados. Para associar um novo bucket de armazenamento ao seu Replit App, crie um bucket. Na ferramenta **App Storage**: 1. Clique em **Create new bucket**. 2. Digite um nome para o bucket no campo **Name** e selecione **Create bucket**. A aba App Storage deve se parecer com a captura de tela a seguir: captura de tela da ferramenta App Storage Para criar buckets adicionais, abra o menu suspenso de buckets no canto superior esquerdo da aba **App Storage** e selecione **Create new bucket**. As seções a seguir explicam as opções de gerenciamento de buckets e objetos na ferramenta App Storage. ### Selecionar um bucket Para alternar entre seus buckets de armazenamento, selecione o menu suspenso no canto superior esquerdo da aba **App Storage**. O bucket selecionado exibe uma marca de seleção ao lado do seu nome, como mostrado na captura de tela abaixo: captura de tela do menu de seleção de bucket ### Acessar o ID do bucket Para visualizar o **Bucket ID**, selecione a visualização **Settings** no menu suspenso no topo da aba **App Storage**. O Bucket ID identifica exclusivamente o bucket, que seu código deve referenciar para realizar uma operação. Se você tiver vários buckets, selecione o bucket correto no menu suspenso no canto superior esquerdo. A captura de tela a seguir mostra o Bucket ID do bucket "FileVault Bucket One": captura de tela da ferramenta App Storage ### Fazer upload ou download de objetos Para fazer upload de um objeto para o bucket selecionado: 1. Navegue até a visualização **Objects** na aba **App Storage**. 2. Selecione ícone de upload de arquivo **Upload files**, ou ícone de upload de pasta **Upload folder** para fazer upload de todos os arquivos de uma pasta. Em seguida, selecione um ou mais arquivos para fazer upload na caixa de diálogo de arquivos. Alternativamente, arraste um arquivo ou pasta para a área que lista o conteúdo do bucket. Para fazer download de um objeto do bucket selecionado: 1. Navegue até a visualização **Objects** na aba **App Storage**. 2. Selecione o ícone ícone de download de download à direita do arquivo para baixá-lo. ### Organizar objetos em pastas Para criar uma pasta no bucket selecionado: 1. Navegue até a visualização **Objects** na aba **App Storage**. 2. Selecione ícone de criar pasta **Create Folder** na visualização **Objects**. 3. Digite um nome para a pasta. Para adicionar objetos a uma pasta na visualização **Objects**, arraste um objeto até a pasta de destino. Para mover o objeto para uma pasta pai, arraste-o sobre o cabeçalho até o nome da pasta acima da lista de objetos. A animação a seguir mostra a movimentação do arquivo "product\_demo.mov" da pasta "videos" para a pasta pai "Objects": animação mostrando a movimentação de um arquivo para uma pasta pai ### Excluir objetos ou buckets A ação de exclusão é irreversível. Certifique-se de fazer backup de qualquer dado essencial antes de continuar. Para excluir um objeto permanentemente: 1. Navegue até a visualização **Objects** na aba **App Storage**. 2. Selecione o ícone ícone de lixeira de lixeira ao lado do objeto que você deseja excluir. 3. Confirme a exclusão na caixa de diálogo de confirmação. Para excluir um bucket e todos os objetos que ele contém: 1. Navegue até a visualização **Settings** na aba **App Storage**. 2. Certifique-se de selecionar o bucket que deseja excluir no menu suspenso de buckets no canto superior esquerdo. 3. Selecione ícone de lixeira **Delete Bucket**. 4. Confirme a exclusão na caixa de diálogo de confirmação. ### Gerenciamento de acesso a buckets O Replit conecta todos os buckets que você cria à sua conta e os disponibiliza para todos os seus Replit Apps. O Replit App a partir do qual você cria o bucket recebe acesso automaticamente. Você pode controlar quais dos seus Replit Apps têm acesso a um bucket específico, o que permite compartilhar dados de forma eficiente e segura. Para conceder ao seu Replit App acesso a um bucket de outro app na sua conta: 1. Selecione ícone de lupa **Add an existing bucket** no menu de buckets no canto superior esquerdo da aba App Storage. 2. Na caixa de diálogo **Choose a Bucket**, escolha o bucket que deseja adicionar e selecione **Add Bucket to Repl**. captura de tela da caixa de diálogo de escolha de bucket Para revogar o acesso do seu Replit App a um bucket: 1. Navegue até a visualização **Settings** na aba **App Storage**. 2. No menu suspenso de buckets no canto superior esquerdo da aba, selecione o nome do bucket. 3. Selecione **Remove Bucket from Repl** e confirme a remoção na caixa de diálogo de confirmação. ### Acesso programático ao App Storage Para acessar o App Storage a partir do seu Replit App, use uma das seguintes bibliotecas: * SDK de App Storage do Replit, disponível para JavaScript e Python * Biblioteca de cliente do Google Cloud Storage Para instruções sobre como usar as bibliotecas de cliente, veja os seguintes recursos: * [JavaScript App Storage SDK](/pt/features/sdks/object-storage-javascript-sdk/): referência de cliente para o SDK de JavaScript * [Python App Storage SDK](/pt/features/sdks/object-storage-python-sdk/): referência de cliente para o SDK de Python * [Google Cloud Python SDK example app](https://replit.com/@matt/GCS-Python-Uploads?v=1): faça remix deste app para gerenciar objetos usando o SDK Python do Google Cloud ## Faturamento e uso de recursos Para monitorar seu uso de App Storage, navegue até a página Usage. Para saber mais sobre os preços do App Storage, veja [App Storage Billing](/pt/billing/object-storage-billing).