Tags e rótulos

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Nesta página, você verá as tags e os identificadores que podem ser definidos nos recursos do Cloud Storage.

Visão geral

As tags do Google Cloud e os rótulos de bucket do Cloud Storage são duas maneiras de organizar os recursos do Cloud Storage.

Tags e rótulos funcionam independentemente uns dos outros e é possível usar ambos no mesmo bucket.

Tags

Tags são pares de chave-valor que podem ser aplicadas aos recursos para controle de acesso detalhado.

As tags são criadas no nível da organização e gerenciadas com o Resource Manager, que é usado no Google Cloud. Depois de anexar uma tag a um bucket do Cloud Storage, use a tag com Condições de IAM para conceder acesso aos recursos do Cloud Storage ou com políticas da organização para aplicar restrições aos recursos do Cloud Storage.

As tags são gerenciadas com o Resource Manager, mas as seguintes permissões do IAM do Cloud Storage são necessárias para visualizar e definir tags nos buckets do Cloud Storage:

  • storage.buckets.listTagBindings
  • storage.buckets.createTagBinding
  • storage.buckets.deleteTagBinding

Essas permissões podem ser herdadas por papéis do IAM, como resourcemanager.tagUser e storage.admin.

Lembre-se destas restrições para a Visualização:

  • As tags só podem ser anexadas a um bucket depois que ele é criado.

  • As tags não estão disponíveis para buckets localizados nas regiões us-east2, us-east3 e us-south1.

  • As tags são ignoradas pela restrição de compartilhamento restrito de domínio. Por exemplo, digamos que você use a restrição para especificar que apenas usuários de exampledomain.com poderão ser adicionados à política do IAM de um bucket se uma tag estiver anexada ao bucket. No entanto, mesmo quando uma tag está anexada ao bucket, os usuários de fora do exampledomain.com ainda podem ser adicionados à política do IAM do bucket.

  • Em casos raros, é possível que haja altas latências ao ler ou modificar tags anexadas a buckets.

As tags não podem ser aplicadas a objetos do Cloud Storage.

Exemplos para anexar tags a buckets do Cloud Storage

Depois de criar e definir uma tag, é possível anexá-la ao bucket do Cloud Storage.

Pense no seguinte cenário:

  • O valor da tag tem um nome de namespace 815471563813/color/blue.
  • Seu bucket é chamado de my-bucket.
  • Seu bucket está localizado em us-central1.

O comando gcloud a seguir anexa a tag a my-bucket:

gcloud alpha resource-manager tags bindings create \
--tag-value=815471563813/color/blue \
--parent=//storage.googleapis.com/projects/_/buckets/my-bucket
--location=us-central1

O comando gcloud a seguir separa a tag de my-bucket:

gcloud alpha resource-manager tags bindings delete \
--tag-value=815471563813/color/blue \
--parent=//storage.googleapis.com/projects/_/buckets/my-bucket \
--location=us-central1

O comando gcloud a seguir lista todas as tags anexadas diretamente a my-bucket, exceto aquelas herdadas por my-bucket:

gcloud alpha resource-manager tags bindings list \
    --parent=//storage.googleapis.com/projects/_/buckets/my-bucket \
    --location=us-central1

Para ver instruções mais detalhadas, consulte Como anexar tags a recursos.

Detalhes do preço

As tags para os buckets do Cloud Storage terão 100% de desconto até 15 de setembro de 2022. Após 15 de setembro de 2022, as tags para os buckets do Cloud Storage estarão sujeitas a preços.

Rótulos de intervalos

Os rótulos do bucket permitem criar pares de chave-valor arbitrários que são armazenados como parte dos metadados do bucket. É possível usar rótulos para organizar os buckets com outros recursos do Google Cloud, como instâncias de máquina virtual e discos permanentes. Por exemplo, digamos que você queira uma chave chamada team que tenha os valores alpha, beta e delta, que será usada para indicar a qual equipe está associada. determinados recursos do Google Cloud. É possível aplicar os rótulos team:alpha, team:beta e team:delta aos recursos desejados para fazer isso.

Ao trabalhar com rótulos de bucket, tenha em mente que:

  • Chaves e valores não podem ter mais de 63 caracteres.
  • Chaves e valores podem conter apenas letras minúsculas, caracteres numéricos, sublinhados e travessões. Caracteres internacionais são permitidos.
  • As chaves dos rótulos precisam começar com uma letra minúscula. É permitido usar caracteres internacionais.
  • As chaves do rótulo não podem estar vazias.
  • Cada bucket pode ter no máximo 64 rótulos ativamente aplicados a ele.
  • Como geralmente acontece com metadados de bucket, os rótulos do bucket não são associados a objetos individuais ou metadados de objetos.

Para um exemplo geral de uso de rótulos para organizar seus recursos no faturamento, consulte Exemplos de consulta de exportação de faturamento para o BigQuery.

Detalhes do preço

O uso de identificadores de bucket é gratuito.

A seguir