Anexar e gerenciar tags em recursos do AlloyDB

As tags do Resource Manager permitem organizar clusters e backups do AlloyDB para PostgreSQL, controlar condicionalmente o acesso do Identity and Access Management (IAM) e acompanhar o uso nas exportações do Cloud Billing. É possível anexar, remover e listar tags em recursos do AlloyDB usando a Google Cloud CLI. As tags anexadas a um recurso de cluster são herdadas automaticamente por recursos filhos, como instâncias, e não podem ser substituídas nesses recursos.

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 com papéis personalizados ou outros papéis predefinidos.

Como 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 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 do 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