Buckets
A API de S3 da Magalu cloud oferece acesso programático a uma variedade de funcionalidades, expostas como endpoints REST, acessíveis via HTTPS e compatíveis com o MGCCLI e outras CLIs. Com esta API você pode:
- Criar e gerenciar buckets
- Armazenar com segurança objetos de qualquer formato e tamanho
- Baixar objetos previamente armazenados
- Gerenciar seus arquivos objetos na nuvem de forma segura
Ao criar um bucket é atribuído um URL no formato:
https://br-ne1.magaluobjects.com/mgc-bucket-1
Para acesso ao URL do Bucket é necessário definir a ACL do Bucket.
Criar Buckets
Existem dois principais métodos para se criar um bucket na Magalu Cloud, por meio do console ou por meio de CLI, como o MGC-CLI.
Ao criar um bucket, você poderá armazenar e gerenciar seus objetos de forma eficiente e segura. Os buckets servem como contêineres que organizam seus dados, permitindo um acesso rápido e estruturado.
- 🖥️ Console
- MGC-CLI
- AWS-CLI
- RCLONE
Na página de Armazenamento de Objetos, clique no botão para Criar bucket.
-
Escolha a Região: Selecione a região de hospedagem mais próxima de sua aplicação para otimizar o acesso aos dados. Se os dados forem acessados de uma localização geográfica específica, escolha a região de hospedagem correspondente.
-
Configuração de Permissão: Por padrão, o bucket é configurado como Privado. Escolha a opção de permissão desejada:
-
Privado: Somente usuários que se conectam ao bucket usando API Keys poderão listar seu conteúdo. Após a criação do bucket, você pode configurar Listas de Controle de Acesso (ACL) para autorizar usuários específicos a acessá-lo.
-
Público: Permite que qualquer pessoa possa listar os objetos armazenados no bucket. Note que o acesso será somente para leitura dos dados.
-
mgc object-storage buckets create NOME_DO_BUCKET
aws s3 mb s3://NOME_DO_BUCKET
Utilizando o AWS s3api:
aws s3api create-bucket --bucket NOME_DO_BUCKET
rclone mkdir NOME_DO_REMOTO:NOME_DO_BUCKET
Escolha um nome único para o seu bucket. Sugerimos um nome que atenda às regras de nomenclatura dos buckets. O nome do bucket será validado, e se o nome desejado não estiver disponível, a criação do bucket não será permitida.
Listar Buckets
Para recuperar os nomes e datas de criação dos buckets, existem os métodos abaixo.
- 🖥️ Console
- MGC-CLI
- AWS-CLI
- RCLONE
Na página de Object Storage, você pode visualizar todos os buckets para cada região. A listagem exibe informações básicas sobre cada bucket, facilitando o gerenciamento.
mgc object-storage buckets list
aws s3 ls
Utilizando o AWS s3api:
aws s3api list-buckets
rclone lsd NOME_DO_REMOTO:
Apagar Bucket
Apagar buckets é um processo que deve apresentar cuidado, pois, é irreversível.
Além disso, é necessário que o bucket esteja vazio para que ele seja deletado. Todavia, caso a operação ocorra via console, então todos os objetos serão automaticamente deletados.
Bucket Vazio
- 🖥️ Console
- MGC-CLI
- AWS-CLI
- RCLONE
-
Na página de Armazenamento de Objetos, você pode visualizar todos os buckets para cada região. Encontre o bucket desejado e selecione a opção de gerenciamento, clicando em Excluir Bucket.
-
Confirme a exclusão reescrevendo o nome do bucket que deseja excluir.
# Apaga o bucket
mgc object-storage buckets delete NOME_BUCKET
# Apaga o bucket
aws s3 rb s3://NOME_BUCKET
Utilizando o AWS s3api:
# Apaga o bucket
aws s3api create-bucket --bucket NOME_DO_BUCKET
# Apaga o bucket
rclone rmdir NOME_DO_REMOTO:NOME_BUCKET
Bucket com Objetos
- 🖥️ Console
- MGC-CLI
- AWS-CLI
- RCLONE
-
Na página de Armazenamento de Objetos, você pode visualizar todos os buckets para cada região. Encontre o bucket desejado e selecione a opção de gerenciamento, clicando em Excluir Bucket.
-
Confirme a exclusão reescrevendo o nome do bucket que deseja excluir.
# Remove todos os objetos presentes no bucket
mgc os objects delete-all NOME_BUCKET
# Apaga o bucket
mgc object-storage buckets delete NOME_BUCKET
# Remove todos os objetos presentes no bucket
aws s3 rm s3://NOME_BUCKET --recursive
# Apaga o bucket vazio
aws s3 rb s3://NOME_BUCKET
Utilizando o AWS s3api:
# Lista todos objetos no bucket
aws s3api list-objects --bucket NOME_BUCKET --query "Contents[].Key"
# Remove todos objetos presentes
aws s3api delete-objects --bucket NOME_BUCKET --delete "Objects=[{Key=OBJECT_KEY}]"
# Apaga o bucket vazio
aws s3api delete-bucket --bucket NOME_BUCKET
# Deleta todos os objetos em conjunto ao bucket
rclone purge REMOTO:NOME_BUCKET
A exclusão do bucket irá remover permanentemente todo o seu conteúdo, incluindo objetos armazenados. Esta ação é irreversível.