Anexar e gerenciar tags em recursos do AlloyDB

Nesta página, descrevemos como anexar, remover e listar tags em recursos do AlloyDB para PostgreSQL. Para uma visão geral das tags no AlloyDB, consulte Organizar recursos do AlloyDB usando tags.

As tags anexadas aos recursos do cluster do AlloyDB são herdadas por recursos filhos, como instâncias. Não é possível substituir as tags desses recursos filhos. Para mais informações, consulte Herança de tags.

Antes de começar

Para receber as permissões necessárias para visualizar e definir tags em recursos do AlloyDB, peça para o administrador conceder a você os seguintes papéis do IAM no projeto:

  • Administrador do Cloud AlloyDB (roles/alloydb.admin): atribua para definir e visualizar tags
  • Leitor do Cloud AlloyDB (roles/alloydb.viewer): atribua para visualizar tags

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando personalizados papéis ou outros predefinidos papéis.

Como trabalhar com tags

Depois de criar e definir uma tag usando o Resource Manager, é possível começar a usar tags com recursos de cluster e backup do AlloyDB. Para mais informações sobre os comandos da Google Cloud CLI para usar vinculações de tags, consulte gcloud resource-manager tags bindings.

Para todos os comandos nesta página, substitua o seguinte:

  • PARENT_PATH: o caminho completo para o recurso de backup ou cluster. Por exemplo, //alloydb.googleapis.com/projects/my-project/locations/us-central1/backups/my-backup.
  • TAG_VALUE: o valor da tag que você quer anexar ao recurso. Por exemplo, o valor da tag definido como 815471563813/environment/development inclui os seguintes componentes:

    • 815471563813 é o ID da organização ou o ID do projeto.

    • environment é a chave da tag.

    • development é o valor da tag.

  • LOCATION: a região em que o cluster ou backup está localizado. Por exemplo, us-central1.

Anexar tags a recursos do AlloyDB

gcloud resource-manager tags bindings create \
--parent=PARENT_PATH \
--tag-value=TAG_VALUE \
--location=LOCATION

Remover tags de recursos do AlloyDB

gcloud resource-manager tags bindings delete \
--parent=PARENT_PATH \
--tag-value=TAG_VALUE \
--location=LOCATION

Listar tags em recursos do AlloyDB

gcloud resource-manager tags bindings list \
--parent=PARENT_PATH \
--location=LOCATION

A seguir