Este tutorial descreve como usar o console do OSS para criar um bucket, fazer upload, baixe e compartilhamento de um objeto e, em seguida, exclua o objeto e o bucket.
Pré-requisitos
O Object Storage Service (OSS) está ativado.
A ativação do OSS é gratuita. A compra de um plano de recursos do OSS não ativa o service automaticamente. É necessário realizar a ativação manualmente.
As operações deste tutorial podem gerar taxas de armazenamento, solicitações de API e tráfego de saída para a Internet. Os valores reais dependem do tamanho do objeto, da duração do armazenamento e do volume de tráfego de saída. Para mais informações, consulte Billing overview e Preços do OSS.
Crie um bucket
Um bucket funciona como um contêiner para armazenar objetos. Após a criação do bucket, é possível fazer upload e gerenciar objetos dentro dele.
Acesse a página Buckets e clique em Create Bucket.
-
Configure os parâmetros abaixo e mantenha as configurações padrão para os demais.
Parâmetro
Valor de exemplo
Descrição
Bucket Name
my-project-singapore-a1b2c3d4
Insira um nome globalmente único.
Region
Singapore
Selecione uma região próxima aos usuários do service para reduzir a latência de acesso. Não é possível alterar a região após a criação do bucket. Para mais informações, consulte Regions and endpoints.
ImportanteUpload, baixe, compartilhamento e exclusão de objetos são considerados operações de dados. Se o seu bucket estiver localizado na China continental, aplica-se a seguinte restrição:
Devido a uma alteração de política visando maior conformidade e segurança, a partir de 20 de março de 2025, novos usuários do OSS devem use a custom domain name (CNAME) para executar operações de api de dados em buckets do OSS localizados em regiões da China continental. Os endpoints públicos padrão têm uso restrito para essas operações. Consulte o comunicado oficial para obter a lista completa das operações afetadas. Caso acesse seus dados via HTTPS, você deve bind a valid SSL Certificate ao seu domínio personalizado. Isso é obrigatório para acesso pelo Console do OSS, pois o console exige HTTPS.
Clique em Create e confirme a criação do bucket.
Clique em Go to Bucket para acessar o bucket recém-criado.
Operações com objetos
No OSS, cada arquivo é armazenado como um objeto, que representa a unidade básica de dados dentro de um bucket. Siga as etapas abaixo para fazer upload, baixe e compartilhar um objeto.
Fazer upload de um objeto
Faça upload de um arquivo local para o bucket criado na seção anterior.
O console permite uploads de até 5 GB por vez. Para objetos maiores, recomendamos o uso de ossutil.
Clique em Upload Object.
Clique em Select Files e escolha um arquivo local.
Se o bucket estiver na China continental, selecione Custom Domain Name. Para buckets em outras regiões, mantenha a opção padrão Public Domain Name.
Clique em Upload Object e aguarde a conclusão do upload.
Após a conclusão, a lista de objetos exibirá o nome, o tamanho, a classe de armazenamento e outras informações sobre o item.
Fazer baixe de um objeto
Na página Objects, clique no nome do objeto enviado ou em View Details.
Clique em Download para salve o objeto no seu computador local.
Compartilhar um objeto
É possível compartilhar objetos de um bucket privado por meio de uma URL assinada com período de validade definido.
Limpar recursos
Caso não precise mais dos recursos criados neste tutorial, exclua o objeto antes de remover o bucket. Recursos excluídos não podem ser recuperados.
Exclua o objeto
Na página Objects, selecione o objeto que você enviou.
Clique em Permanently Delete e siga as instruções na tela para confirme a operação.
Exclua o bucket
Após exclua um bucket, é preciso aguardar algumas horas (geralmente entre quatro e oito) antes de poder crie outro com o mesmo nome.
Na barra de menus do bucket, clique em Delete Bucket.
Clique em Delete.