Nesta página, mostramos como adicionar, modificar, remover e ver os rótulos definidos em um bucket no Cloud Storage.
Funções exigidas
Para receber as permissões necessárias para adicionar e gerenciar rótulos de bucket, peça ao administrador para conceder a você o papel do IAM de Administrador do Storage (roles/storage.admin
) no bucket.
Esse papel predefinido contém as permissões necessárias para adicionar e gerenciar rótulos de bucket. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
storage.buckets.get
storage.buckets.list
- Essa permissão só é necessária ao usar o console do Google Cloud para executar as instruções nesta página.
storage.buckets.update
Talvez você também consiga receber essas permissões com papéis personalizados.
Para instruções sobre como conceder papéis nos buckets, consulte Usar o IAM com buckets.
Adicionar, modificar ou remover rótulos de um bucket
Console
- No Console do Google Cloud, acesse a página Buckets do Cloud Storage.
Na lista de buckets, clique no nome do bucket para o qual você quer adicionar, modificar ou remover rótulos.
Na página Detalhes do bucket, clique na guia Configuração.
Clique no ícone Editar (edit) em Rótulos.
A janela do editor de rótulos é exibida.
Para adicionar um rótulo, clique no botão add_boxAdicionar rótulo e especifique um
key
e umvalue
para o rótulo.Para modificar um rótulo atual, clique no Valor dele e insira um novo valor.
Para remover um rótulo, clique no ícone da lixeira associado ao rótulo.
Clique em Salvar.
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
Para adicionar ou atualizar um rótulo, use o comando
gcloud storage buckets update
com a sinalização
--update-labels
. Exemplo:
gcloud storage buckets update gs://BUCKET_NAME --update-labels=KEY_1=VALUE_1
Onde
BUCKET_NAME
é o nome do bucket a que o rótulo se aplica. Por exemplo,my-bucket
.KEY_1
é o nome da chave para seu rótulo. Por exemplo,pet
.VALUE_1
é o valor para seu rótulo. Por exemplo,dog
.
Para remover um rótulo já existente, use a flag -remove-labels
. Exemplo:
gcloud storage buckets update gs://BUCKET_NAME --remove-labels=KEY_1
Para alterar vários rótulos usando os comandos anteriores, inclua-os em uma lista separada por vírgulas na flag relevante. Por exemplo, --update-labels=blue-key=cyan,red-key=ruby
.
Para remover todos os rótulos anexados a um bucket, use o seguinte comando:
gcloud storage buckets update gs://BUCKET_NAME --clear-labels
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.
Veja no exemplo a seguir como adicionar o rótulo especificado a um bucket ou modificá-lo se ele já existir no bucket:
Veja no exemplo a seguir como remover o rótulo especificado a partir de um bucket:
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.
Veja no exemplo a seguir como adicionar o rótulo especificado a um bucket ou modificá-lo se ele já existir no bucket:
Veja no exemplo a seguir como remover o rótulo especificado a partir de um bucket:
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.
Veja no exemplo a seguir como adicionar o rótulo especificado a um bucket ou modificá-lo se ele já existir no bucket:
Veja no exemplo a seguir como remover o rótulo especificado a partir de um bucket:
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.
Veja no exemplo a seguir como adicionar o rótulo especificado a um bucket ou modificá-lo se ele já existir no bucket:
Veja no exemplo a seguir como remover o rótulo especificado a partir de um bucket:
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.
Veja no exemplo a seguir como adicionar o rótulo especificado a um bucket ou modificá-lo se ele já existir no bucket:
Veja no exemplo a seguir como remover o rótulo especificado a partir de um bucket:
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.
Veja no exemplo a seguir como adicionar o rótulo especificado a um bucket ou modificá-lo se ele já existir no bucket:
Veja no exemplo a seguir como remover o rótulo especificado a partir de um bucket:
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.
Veja no exemplo a seguir como adicionar o rótulo especificado a um bucket ou modificá-lo se ele já existir no bucket:
Veja no exemplo a seguir como remover o rótulo especificado a partir de um bucket:
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.
Veja no exemplo a seguir como adicionar o rótulo especificado a um bucket ou modificá-lo se ele já existir no bucket:
Veja no exemplo a seguir como remover o rótulo especificado a partir de um bucket:
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 informações a seguir:
{ "labels": { "KEY_1": "VALUE_1" } }
Onde
KEY_1
é o nome da chave para seu rótulo. Por exemplo,pet
.VALUE_1
é o valor para seu rótulo. Por exemplo,dog
. Se você quiser remover uma chave, usenull
em vez de"<var>VALUE_1</var>"
.
Use
cURL
para chamar a API JSON com uma solicitação bucketPATCH
:curl -X PATCH --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/BUCKET_NAME?fields=labels"
Em que:
JSON_FILE_NAME
é o caminho para o arquivo JSON criado na Etapa 2.BUCKET_NAME
é o nome do bucket a que o rótulo se aplica. Por exemplo,my-bucket
.
É possível adicionar, editar ou remover vários pares de key:value
em uma solicitação.
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 que contenha as seguintes informações:
<Tagging> <TagSet> <Tag> <Key>KEY_1</Key> <Value>VALUE_1</Value> </Tag> </TagSet> </Tagging>
Em que:
KEY_1
é o nome da chave para seu rótulo. Por exemplo,pet
.VALUE_1
é o valor para seu rótulo. Por exemplo,dog
.
É possível adicionar vários elementos de
<Tag>
em uma solicitação. Para remover todos os rótulos de um bucket, use um único elemento<Tag>
vazio no arquivo:<Tagging> <TagSet> <Tag> </Tag> </TagSet> </Tagging>
Use
cURL
para chamar a API XML com uma solicitação de bucketPUT
e um parâmetro de string de consultatagging
:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?tagging"
Em que:
XML_FILE_NAME
é o caminho para o arquivo XML criado na Etapa 2.BUCKET_NAME
é o nome do bucket a que o rótulo se aplica. Por exemplo,my-bucket
.
Ver rótulos de bucket
Console
- No Console do Google Cloud, acesse a página Buckets do Cloud Storage.
Clique no nome do bucket cujos rótulos você quer ver.
Clique na guia Configuração.
Os rótulos definidos no bucket são listados no campo Rótulos.
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
Use o comando gcloud storage buckets describe
com a flag --format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(labels)"
Em que BUCKET_NAME
é o nome do bucket
com o status que você quer visualizar. Por exemplo, my-bucket
.
Se der tudo certo e houver rótulos para o bucket, a resposta será semelhante a esta:
labels: red-key: ruby blue-key: cyan
Se der tudo certo e não houver rótulos para o bucket, a resposta será semelhante a esta:
null
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.
Para visualizar os rótulos de um bucket, siga as instruções para exibir os metadados de um bucket e procure o campo de rótulo na resposta.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.
Para visualizar os rótulos de um bucket, siga as instruções para exibir os metadados de um bucket e procure o campo de rótulo na resposta.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.
Para visualizar os rótulos de um bucket, siga as instruções para exibir os metadados de um bucket e procure o campo de rótulo na resposta.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.
Para visualizar os rótulos de um bucket, siga as instruções para exibir os metadados de um bucket e procure o campo de rótulo na resposta.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.
Para visualizar os rótulos de um bucket, siga as instruções para exibir os metadados de um bucket e procure o campo de rótulo na resposta.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.
Para visualizar os rótulos de um bucket, siga as instruções para exibir os metadados de um bucket e procure o campo de rótulo na resposta.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.
Para visualizar os rótulos de um bucket, siga as instruções para exibir os metadados de um bucket e procure o campo de rótulo na resposta.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.
Para visualizar os rótulos de um bucket, siga as instruções para exibir os metadados de um bucket e procure o campo de rótulo na resposta.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
.Use
cURL
(em inglês) para chamar a API JSON com uma solicitação de bucketGET
que inclua o parâmetro de string de consultafields=labels
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=labels"
Em que
BUCKET_NAME
é o nome do bucket com o status que você quer visualizar. Por exemplo,my-bucket
.
A resposta terá esta aparência:
{ "labels" : { (your_label_key): your_label_value }, }
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
.Use
cURL
para chamar a API XML com uma solicitação de bucketGET
e um parâmetro de string de consultatagging
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?tagging"
Em que
BUCKET_NAME
é o nome do bucket com o status que você quer visualizar. Por exemplo,my-bucket
.
A resposta terá esta aparência:
<Tagging> <TagSet> <Tag> <Key>your_label_key</Key> <Value>your_label_value</Value> </Tag> </TagSet> </Tagging>
A seguir
- Saiba mais sobre tags de bucket.
- Acesse outros metadados do bucket.