Anexe e faça a gestão de etiquetas em recursos do AlloyDB

Esta página descreve como anexar, desanexar e listar etiquetas em recursos do AlloyDB para PostgreSQL. Para uma vista geral das etiquetas no AlloyDB, consulte o artigo Organize os recursos do AlloyDB com etiquetas.

As etiquetas anexadas aos recursos do cluster do AlloyDB são herdadas pelos recursos secundários, como as instâncias. Não pode substituir as etiquetas desses recursos secundários. Para mais informações, consulte o artigo Herança de etiquetas.

Antes de começar

Para receber as autorizações de que precisa para ver e definir etiquetas em recursos do AlloyDB, peça ao seu administrador para lhe conceder as seguintes funções de IAM no seu projeto:

  • Administrador do Cloud AlloyDB (roles/alloydb.admin): atribua para definir e ver etiquetas
  • Leitor do Cloud AlloyDB (roles/alloydb.viewer): atribuir para ver etiquetas

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Trabalhe com etiquetas

Depois de criar e definir uma etiqueta através do Resource Manager, pode começar a usar etiquetas com recursos de clusters e cópias de segurança do AlloyDB. Para mais informações sobre os comandos da CLI do Google Cloud para usar associações de etiquetas, 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 cópia de segurança ou cluster, por exemplo, //alloydb.googleapis.com/projects/my-project/locations/us-central1/backups/my-backup.

  • TAG_VALUE: o valor da etiqueta que quer anexar ao seu recurso. Por exemplo, o valor da etiqueta definido como 815471563813/environment/development inclui os seguintes componentes:

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

    • environment é a chave da etiqueta.

    • development é o valor da etiqueta.

  • LOCATION: a região onde o cluster ou a cópia de segurança está localizado, por exemplo, us-central1.

Anexe etiquetas a recursos do AlloyDB

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

Desassocie etiquetas de recursos do AlloyDB

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

Liste etiquetas em recursos do AlloyDB

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

O que se segue?