Anexar e gerenciar tags em recursos do AlloyDB

Nesta página, descrevemos como anexar, desanexar 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 ter as permissões necessárias para visualizar e definir tags em recursos do AlloyDB, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

  • Administrador do Cloud AlloyDB (roles/alloydb.admin): atribua para definir e ver tags
  • Leitor do Cloud AlloyDB (roles/alloydb.viewer): atribuir 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 papéis personalizados ou outros papéis predefinidos.

Trabalhar com tags

Depois de criar e definir uma tag usando o Resource Manager, você pode começar a usar tags com recursos de cluster e backup do AlloyDB. Para mais informações sobre os comandos da CLI do Google Cloud 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 backup ou recurso do 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 do projeto.

    • environment é a chave de 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