Esta página mostra-lhe como adicionar, modificar, remover e ver as etiquetas definidas num contentor no Cloud Storage.
Funções necessárias
Para receber as autorizações necessárias para adicionar e gerir etiquetas de contentores,
peça ao seu administrador que lhe conceda a função do IAM de administrador do armazenamento
(roles/storage.admin
) no contentor.
Esta função predefinida contém as autorizações necessárias para adicionar e gerir etiquetas de contentores. Para ver as autorizações exatas necessárias, expanda a secção Autorizações necessárias:
Autorizações necessárias
storage.buckets.get
storage.buckets.list
- Esta autorização só é necessária se planear usar a Trusted Cloud consola para executar as instruções nesta página.
storage.buckets.update
Também pode conseguir estas autorizações com funções personalizadas.
Para obter instruções sobre como conceder funções em contentores, consulte o artigo Use o IAM com contentores.
Adicione, modifique ou remova as etiquetas de um contentor
Consola
- Na Trusted Cloud consola, aceda à página Recipientes do Cloud Storage.
Na lista de contentores, clique no nome do contentor ao qual quer adicionar, modificar ou remover etiquetas.
Na página Detalhes do contentor, clique no separador Configuração.
Clique no ícone Editar (edit) para Etiquetas.
É apresentada a janela do editor de etiquetas.
Para adicionar uma etiqueta, clique no botão add_box Adicionar etiqueta e especifique um
key
e umvalue
para a etiqueta.Para modificar uma etiqueta existente, clique no respetivo Valor e introduza um novo valor.
Para remover uma etiqueta, clique no ícone de lixo associado à etiqueta que quer remover.
Clique em Guardar.
Para saber como obter informações detalhadas sobre erros relativos a operações do Cloud Storage falhadas na Trusted Cloud consola, consulte a secção Resolução de problemas.
Linha de comandos
Para adicionar uma nova etiqueta ou atualizar uma etiqueta existente, use o comando gcloud storage buckets update
com a flag --update-labels
. Por exemplo:
gcloud storage buckets update gs://BUCKET_NAME --update-labels=KEY_1=VALUE_1
Onde
BUCKET_NAME
é o nome do contentor ao qual a etiqueta se aplica. Por exemplo,my-bucket
.KEY_1
é o nome da chave da sua etiqueta. Por exemplo,pet
.VALUE_1
é o valor da sua etiqueta. Por exemplo,dog
.
Para remover uma etiqueta existente, use a flag -remove-labels
. Por exemplo:
gcloud storage buckets update gs://BUCKET_NAME --remove-labels=KEY_1
Pode alterar várias etiquetas através dos comandos anteriores, incluindo as etiquetas numa lista separada por vírgulas na flag relevante. Por exemplo,
--update-labels=blue-key=cyan,red-key=ruby
.
Para remover todas as etiquetas associadas a um contentor, use o seguinte comando:
gcloud storage buckets update gs://BUCKET_NAME --clear-labels
Bibliotecas cliente
C++
Para mais informações, consulte a documentação de referência da API C++ do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
O exemplo seguinte adiciona a etiqueta especificada a um contentor ou modifica a etiqueta se já existir para o contentor:
O exemplo seguinte remove a etiqueta especificada de um segmento:
C#
Para mais informações, consulte a documentação de referência da API C# do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
O exemplo seguinte adiciona a etiqueta especificada a um contentor ou modifica a etiqueta se já existir para o contentor:
O exemplo seguinte remove a etiqueta especificada de um segmento:
Go
Para mais informações, consulte a documentação de referência da API Go do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
O exemplo seguinte adiciona a etiqueta especificada a um contentor ou modifica a etiqueta se já existir para o contentor:
O exemplo seguinte remove a etiqueta especificada de um segmento:
Java
Para mais informações, consulte a documentação de referência da API Java do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
O exemplo seguinte adiciona a etiqueta especificada a um contentor ou modifica a etiqueta se já existir para o contentor:
O exemplo seguinte remove a etiqueta especificada de um segmento:
Node.js
Para mais informações, consulte a documentação de referência da API Node.js do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
O exemplo seguinte adiciona a etiqueta especificada a um contentor ou modifica a etiqueta se já existir para o contentor:
O exemplo seguinte remove a etiqueta especificada de um segmento:
PHP
Para mais informações, consulte a documentação de referência da API PHP do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
O exemplo seguinte adiciona a etiqueta especificada a um contentor ou modifica a etiqueta se já existir para o contentor:
O exemplo seguinte remove a etiqueta especificada de um segmento:
Python
Para mais informações, consulte a documentação de referência da API Python do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
O exemplo seguinte adiciona a etiqueta especificada a um contentor ou modifica a etiqueta se já existir para o contentor:
O exemplo seguinte remove a etiqueta especificada de um segmento:
Ruby
Para mais informações, consulte a documentação de referência da API Ruby do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
O exemplo seguinte adiciona a etiqueta especificada a um contentor ou modifica a etiqueta se já existir para o contentor:
O exemplo seguinte remove a etiqueta especificada de um segmento:
APIs REST
API JSON
Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho
Authorization
.Crie um ficheiro JSON que contenha as seguintes informações:
{ "labels": { "KEY_1": "VALUE_1" } }
Onde
KEY_1
é o nome da chave da sua etiqueta. Por exemplo,pet
.VALUE_1
é o valor da sua etiqueta. Por exemplo,dog
. Se quiser remover uma chave, usenull
em vez de"<var>VALUE_1</var>"
.
Use
cURL
para chamar a API JSON com um pedido dePATCH
contentor:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME?fields=labels"
Onde:
JSON_FILE_NAME
é o caminho para o ficheiro JSON que criou no passo 2.BUCKET_NAME
é o nome do grupo ao qual a etiqueta se aplica. Por exemplo,my-bucket
.
Pode adicionar, editar ou remover vários pares key:value
num pedido.
API XML
Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho
Authorization
.Crie um ficheiro XML que contenha as seguintes informações:
<Tagging> <TagSet> <Tag> <Key>KEY_1</Key> <Value>VALUE_1</Value> </Tag> </TagSet> </Tagging>
Onde:
KEY_1
é o nome da chave da sua etiqueta. Por exemplo,pet
.VALUE_1
é o valor da sua etiqueta. Por exemplo,dog
.
Tenha em atenção que pode adicionar vários elementos
<Tag>
num pedido. Se quiser remover todas as etiquetas num contentor, use um único elemento<Tag>
vazio no ficheiro:<Tagging> <TagSet> <Tag> </Tag> </TagSet> </Tagging>
Use
cURL
para chamar a API XML com um pedido dePUT
contentor e o parâmetro de string de consultatagging
:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/BUCKET_NAME?tagging"
Onde:
XML_FILE_NAME
é o caminho para o ficheiro XML que criou no passo 2.BUCKET_NAME
é o nome do grupo ao qual a etiqueta se aplica. Por exemplo,my-bucket
.
Veja as etiquetas de contentores
Consola
- Na Trusted Cloud consola, aceda à página Recipientes do Cloud Storage.
Clique no nome do contentor cujas etiquetas quer ver.
Clique no separador Configuração.
As etiquetas definidas no contentor são apresentadas no campo Etiquetas.
Para saber como obter informações detalhadas sobre erros relativos a operações do Cloud Storage falhadas na Trusted Cloud consola, consulte a secção Resolução de problemas.
Linha de comandos
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 contentor cujas etiquetas quer ver. Por exemplo, my-bucket
.
Se for bem-sucedido e existirem etiquetas para o contentor, a resposta é semelhante à seguinte:
labels: red-key: ruby blue-key: cyan
Se for bem-sucedido e não existirem etiquetas para o contentor, a resposta é semelhante à seguinte:
null
Bibliotecas cliente
C++
Para mais informações, consulte a documentação de referência da API C++ do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
C#
Para mais informações, consulte a documentação de referência da API C# do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
Go
Para mais informações, consulte a documentação de referência da API Go do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
Java
Para mais informações, consulte a documentação de referência da API Java do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
Node.js
Para mais informações, consulte a documentação de referência da API Node.js do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
PHP
Para mais informações, consulte a documentação de referência da API PHP do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
Python
Para mais informações, consulte a documentação de referência da API Python do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
Ruby
Para mais informações, consulte a documentação de referência da API Ruby do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
APIs REST
API JSON
Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho
Authorization
.Use
cURL
para chamar a API JSON com um pedido deGET
Bucket que inclua o parâmetro de string de consultafields=labels
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME?fields=labels"
Em que
BUCKET_NAME
é o nome do contentor cujas etiquetas quer ver. Por exemplo,my-bucket
.
A resposta tem o seguinte aspeto:
{ "labels" : { (your_label_key): your_label_value }, }
API XML
Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho
Authorization
.Use
cURL
para chamar a API XML com um pedido deGET
contentor e o parâmetro de string de consultatagging
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/BUCKET_NAME?tagging"
Em que
BUCKET_NAME
é o nome do contentor cujas etiquetas quer ver. Por exemplo,my-bucket
.
A resposta tem o seguinte aspeto:
<Tagging> <TagSet> <Tag> <Key>your_label_key</Key> <Value>your_label_value</Value> </Tag> </TagSet> </Tagging>
O que se segue?
- Saiba mais sobre as etiquetas de contentores.
- Obtenha metadados de contentores adicionais.