Veja nesta página como criar buckets do Cloud Storage. Se não for
especificado de outra forma na sua solicitação, os buckets serão criados no
US
multirregional com uma classe de armazenamento padrão do
Standard Storage e terão uma duração de retenção de exclusão reversível de sete dias.
Funções exigidas
Para ter as permissões necessárias para criar um bucket do Cloud Storage, peça ao administrador para conceder a você o papel do IAM de Administrador do Storage
(roles/storage.admin
) no projeto.
Esse papel predefinido contém a permissão necessária para criar um bucket. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
storage.buckets.create
storage.buckets.enableObjectRetention
(necessário apenas se ativar as configurações de retenção de objetos para o bucket)storage.buckets.list
(obrigatório apenas ao criar um bucket usando o console do Google Cloud)resourcemanager.projects.get
(obrigatório apenas ao criar um bucket usando o console do Google Cloud)
Essas permissões também podem ser concedidas com papéis personalizados ou outros papéis predefinidos. Para conferir quais papéis estão associados a quais permissões, consulte Papéis do IAM para o Cloud Storage.
Para instruções sobre como conceder papéis a projetos, consulte Gerenciar o acesso aos projetos.
Criar um novo bucket
Console
- No Console do Google Cloud, acesse a página Buckets do Cloud Storage.
- Clique em + Criar.
- Na página Criar um bucket, insira as informações do seu bucket. Para ir à próxima
etapa, clique em Continuar.
- Em Nomear o bucket, insira um nome que atenda aos requisitos de nome de bucket.
- Em Escolha onde armazenar os dados, selecione o Tipo de local e o Local onde os dados do bucket serão armazenados permanentemente.
- Em Escolha uma classe de armazenamento para seus dados, selecione uma
classe de armazenamento padrão para o bucket ou selecione
Classe automática para gerenciamento automático da classe de armazenamento dos dados do
bucket.
Observação: o painel Estimativa de custo mensal no painel direito estima os custos mensais do bucket com base na classe e no local de armazenamento selecionados, bem como no tamanho e nas operações dos dados.
- Em Escolha como controlar o acesso a objetos, selecione se o bucket
aplica a prevenção de acesso público e
um modelo de Controle de acesso para os
objetos do bucket.
Observação: se a prevenção de acesso público já estiver aplicada pela política da organização do projeto, a opção Impedir acesso público ficará bloqueada.
- Em Escolher como proteger os dados do objeto, configure Ferramentas de proteção se quiser e selecione um método de Criptografia de dados.
- Clique em Criar.
Para saber como acessar informações detalhadas de erro sobre operações do Cloud Storage com falha no console do Google Cloud, consulte Solução de problemas.
Linha de comando
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
-
No ambiente de desenvolvimento, execute o comando
gcloud storage buckets create
:gcloud storage buckets create gs://BUCKET_NAME --location=BUCKET_LOCATION
Em que:
BUCKET_NAME
é o nome que você quer dar ao bucket, sujeito a requisitos de nomenclatura. Por exemplo,my-bucket
.BUCKET_LOCATION
é o local do bucket. Por exemplo,us-east1
.
Se a solicitação for bem-sucedida, o comando retornará a seguinte mensagem:
Creating gs://BUCKET_NAME/...
Para ter mais controle sobre a criação do bucket, defina as seguintes flags:
--project
: especifique o ID ou o número do projeto ao qual seu bucket será associado. Por exemplo,my-project
.--default-storage-class
: especifique a classe de armazenamento padrão do bucket. Por exemplo,STANDARD
.--soft-delete-duration
: especifique a duração da retenção da exclusão reversível do seu bucket. Por exemplo,2w1d
.--uniform-bucket-level-access
: ative o acesso uniforme no nível do bucket para seu bucket.
Para ver uma lista completa de opções de criação de buckets da gcloud, consulte opções de
buckets create
.Exemplo:
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_ID --default-storage-class=STORAGE_CLASS --location=BUCKET_LOCATION --uniform-bucket-level-access
Bibliotecas de cliente
C++
Para mais informações, consulte a documentação de referência da API Cloud Storage C++.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
C#
Para mais informações, consulte a documentação de referência da API Cloud Storage C#.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Para mais informações, consulte a documentação de referência da API Cloud Storage Go.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Para mais informações, consulte a documentação de referência da API Cloud Storage Java.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Para mais informações, consulte a documentação de referência da API Cloud Storage Node.js.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
PHP
Para mais informações, consulte a documentação de referência da API Cloud Storage PHP.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para mais informações, consulte a documentação de referência da API Cloud Storage Python.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Para mais informações, consulte a documentação de referência da API Cloud Storage Ruby.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Terraform
É possível usar um recurso Terraform para criar um bucket de armazenamento.
APIs REST
API JSON
Ter a gcloud CLI instalada e inicializadapara gerar um token de acesso para o cabeçalho
Authorization
.Como alternativa, é possível criar um token de acesso usando o OAuth 2.0 Playground e incluí-lo no cabeçalho
Authorization
.- Crie um arquivo JSON com as configurações do bucket, incluindo um
name
para o bucket. Consulte a documentação Buckets:Insert para ver uma lista completa de configurações. Veja a seguir configurações comuns a serem incluídas: BUCKET_NAME
é o nome que você quer dar ao bucket, sujeito a requisitos de nomenclatura. Por exemplo,my-bucket
.BUCKET_LOCATION
é o local em que você quer armazenar os dados de objeto do intervalo. Por exemplo,US-EAST1
.STORAGE_CLASS
é a classe de armazenamento padrão do bucket. Por exemplo,STANDARD
.- Use
cURL
para chamar a API JSON:curl -X POST --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b?project=PROJECT_IDENTIFIER"
Em que:
JSON_FILE_NAME
é o nome do arquivo JSON criado na Etapa 2.PROJECT_IDENTIFIER
é o ID ou o número do projeto ao qual seu bucket será associado. Por exemplo,my-project
.
{ "name": "BUCKET_NAME", "location": "BUCKET_LOCATION", "storageClass": "STORAGE_CLASS", "iamConfiguration": { "uniformBucketLevelAccess": { "enabled": true }, } }
Em que:
API XML
Ter a gcloud CLI instalada e inicializadapara gerar um token de acesso para o cabeçalho
Authorization
.Como alternativa, é possível criar um token de acesso usando o OAuth 2.0 Playground e incluí-lo no cabeçalho
Authorization
.- Crie um arquivo XML contendo as configurações do bucket. Consulte a documentação XML: criar um bucket para conferir uma lista completa de configurações. Veja a seguir configurações comuns a serem incluídas:
BUCKET_LOCATION
é o local em que você quer armazenar os dados de objeto do intervalo. Por exemplo,US-EAST1
.STORAGE_CLASS
é a classe de armazenamento padrão do bucket. Por exemplo,STANDARD
.- Use
cURL
para chamar a API XML:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "x-goog-project-id: PROJECT_ID" \ "https://storage.googleapis.com/BUCKET_NAME"
Em que:
XML_FILE_NAME
é o nome do arquivo XML criado na Etapa 2.PROJECT_ID
é o ID do projeto ao qual o bucket será associado. Por exemplo,my-project
.BUCKET_NAME
é o nome que você quer dar ao bucket, sujeito a requisitos de nomenclatura. Por exemplo,my-bucket
.
<CreateBucketConfiguration> <LocationConstraint>BUCKET_LOCATION</LocationConstraint> <StorageClass>STORAGE_CLASS</StorageClass> </CreateBucketConfiguration>
Em que:
A seguir
- Liste buckets de um projeto.
- Acesse informações sobre os metadados de um bucket.
- Receber informações sobre o layout de armazenamento de um bucket
- Mova ou renomeie um bucket.
- Exclua um bucket.
- Faça o upload de um objeto para seu bucket.
- Gerencie a criação e a configuração dos buckets com o Kubernetes Config Connector.
Faça um teste
Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho do Cloud Storage em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
Faça uma avaliação gratuita do Cloud Storage