Etiquete recursos do Cloud Workstations

Este documento descreve como usar etiquetas para aplicar condicionalmente políticas de gestão de identidade e acesso (IAM) a clusters do Cloud Workstations.

Uma etiqueta é um par de chave-valor que pode anexar diretamente a um cluster do Cloud Workstations. Um cluster do Cloud Workstations também pode herdar uma etiqueta de outrosGoogle Cloud recursos. Pode aplicar condicionalmente políticas com base no facto de um recurso ter ou não uma etiqueta específica. Por exemplo, pode conceder condicionalmente a função de criador de estações de trabalho na nuvem a um principal em qualquer cluster de estações de trabalho na nuvem com a etiqueta environment:dev.

Para mais informações sobre a utilização de etiquetas na hierarquia de recursos, consulte o artigo Vista geral das etiquetas. Google Cloud

Antes de começar

Tem de conceder funções de IAM que dão aos utilizadores as autorizações necessárias para realizar cada tarefa neste documento. Também tem de criar chaves e valores de etiquetas para anexar aos recursos.

Funções necessárias

As seguintes funções fornecem as autorizações necessárias para etiquetar recursos do Cloud Workstations:

Anexe uma etiqueta a um cluster do Cloud Workstations

Para receber as autorizações de que precisa para anexar uma etiqueta a um cluster do Cloud Workstations, peça ao seu administrador que lhe conceda as seguintes funções da IAM:

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.

Estas funções predefinidas contêm as autorizações necessárias para anexar uma etiqueta a um cluster do Cloud Workstations. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

São necessárias as seguintes autorizações para anexar uma etiqueta a um cluster do Cloud Workstations:

  • workstations.workstationClusters.createTagBinding no cluster
  • resourcemanager.tagValueBindings.create no valor da etiqueta
  • workstations.workstationClusters.create no cluster para anexar uma etiqueta ao criar um cluster
  • workstations.workstationClusters.update no cluster para anexar uma etiqueta ao atualizar um cluster

Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.

Remova uma etiqueta de um cluster do Cloud Workstations

Para receber as autorizações de que precisa para remover uma etiqueta de um cluster do Cloud Workstations, peça ao seu administrador para lhe conceder as seguintes funções da IAM:

Estas funções predefinidas contêm as autorizações necessárias para remover uma etiqueta de um cluster do Cloud Workstations. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

São necessárias as seguintes autorizações para remover uma etiqueta de um cluster de estações de trabalho na nuvem:

  • workstations.workstationClusters.deleteTagBinding no cluster
  • resourcemanager.tagValueBindings.delete no valor da etiqueta
  • workstations.workstationClusters.update no cluster para remover uma etiqueta ao atualizar um cluster

Liste as etiquetas anexadas a um cluster de estações de trabalho na nuvem

Para receber as autorizações de que precisa para listar as etiquetas anexadas a um cluster do Cloud Workstations, peça ao seu administrador que lhe conceda as seguintes funções da IAM:

Estas funções predefinidas contêm as autorizações necessárias para listar as etiquetas anexadas a um cluster do Cloud Workstations. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

São necessárias as seguintes autorizações para listar as etiquetas anexadas a um cluster do Cloud Workstations:

  • resourcemanager.tagKeys.list no elemento principal da chave da etiqueta
  • resourcemanager.tagKeys.get na chave da etiqueta
  • resourcemanager.tagValues.list no elemento principal do valor da etiqueta
  • resourcemanager.tagValues.get no valor da etiqueta
  • workstations.workstationClusters.listTagBindings no cluster
  • workstations.workstationClusters.listEffectiveTags no cluster

Crie chaves e valores de etiquetas

Antes de poder anexar uma etiqueta, tem de criar uma etiqueta e configurar o respetivo valor. Para criar chaves de etiquetas e valores de etiquetas, consulte os artigos Criar uma etiqueta e Adicionar valores de etiquetas.

Etiquete clusters de estações de trabalho na nuvem

As secções seguintes descrevem como anexar etiquetas a clusters de estações de trabalho na nuvem novos e existentes, listar etiquetas anexadas a um cluster de estações de trabalho na nuvem e desanexar etiquetas de um cluster de estações de trabalho na nuvem.

Anexe etiquetas quando criar um novo cluster de estações de trabalho na nuvem

Depois de criar uma etiqueta, pode anexá-la a um novo cluster do Cloud Workstations. Para cada chave de etiqueta, pode anexar um valor de etiqueta a um cluster do Cloud Workstations. Para cada cluster do Cloud Workstations, pode anexar, no máximo, 50 etiquetas.

Consola

  1. Na Google Cloud consola, aceda à página Cloud Workstations.

    Aceda a Estações de trabalho

  2. Clique na secção Gestão de clusters.

  3. Clique em Criar.

  4. Introduza as informações do novo cluster de estações de trabalho na nuvem. Para mais detalhes, consulte o artigo Crie um cluster de estações de trabalho.

  5. Na secção Etiquetas, selecione as etiquetas que quer adicionar ao novo cluster do Cloud Workstations.

  6. Clique em Criar.

gcloud

Use o gcloud workstations clusters create comando com a flag --tags:

gcloud workstations clusters create WORKSTATIONS_CLUSTER_NAME \
    --region=LOCATION \
    --tags=TAG \
    --project=WORKSTATIONS_PROJECT_ID

Substitua o seguinte:

  • WORKSTATIONS_CLUSTER_NAME: o nome do cluster do Cloud Workstations.
  • LOCATION: a região do seu cluster.
  • TAG: a etiqueta que está a anexar ao novo cluster do Cloud Workstations. As várias etiquetas estão separadas por vírgulas. Por exemplo, 556741164180/env:prod,myProject/department:sales. Cada etiqueta tem de ter o nome da chave com espaço de nomes e o nome abreviado do valor.
  • WORKSTATIONS_PROJECT_ID: o ID do projeto da sua estação de trabalho.

API

Chame o método workstationClusters.create. Inclua as etiquetas no campo tags de WorkstationCluster.

Anexe etiquetas a um cluster de estações de trabalho na nuvem existente

Depois de criar uma etiqueta, pode anexá-la a um cluster do Cloud Workstations existente. Para cada chave de etiqueta, pode anexar um valor de etiqueta a um cluster do Cloud Workstations. Para cada cluster do Cloud Workstations, pode anexar, no máximo, 50 etiquetas.

Consola

  1. Na Google Cloud consola, aceda à página Cloud Workstations.

    Aceda a Estações de trabalho

  2. Clique na secção Gestão de clusters.

  3. Clique no cluster do Cloud Workstations ao qual quer anexar a etiqueta.

  4. Clique em Edit.

  5. Na secção Etiquetas, selecione as etiquetas que quer adicionar ao cluster do Cloud Workstations.

  6. Clique em Guardar.

gcloud

Para anexar uma etiqueta a um cluster do Cloud Workstations através da linha de comandos, crie um recurso de associação de etiquetas com o comando gcloud resource-manager tags bindings create:

gcloud resource-manager tags bindings create \
    --tag-value=TAGVALUE_NAME \
    --parent=RESOURCE_ID \
    --location=LOCATION

Substitua o seguinte:

  • TAGVALUE_NAME: o ID permanente ou o nome com espaço de nomes do valor da etiqueta a anexar, como tagValues/4567890123 ou 1234567/my_tag_key/my_tag_value.
  • RESOURCE_ID: o ID completo do cluster do Cloud Workstations, incluindo o nome do domínio da API (//workstations.googleapis.com/) para identificar o tipo de recurso. Por exemplo, //workstations.googleapis.com/projects/my_project/locations/us-central1/workstationClusters/my_cluster
  • LOCATION: a região do cluster de estações de trabalho na nuvem.

API

Chame o método workstationClusters.patch. Inclua as etiquetas no campo tags de WorkstationCluster.

Liste as etiquetas anexadas a um cluster de estações de trabalho na nuvem

Pode listar as etiquetas anexadas diretamente a um cluster do Cloud Workstations. Este processo não apresenta etiquetas herdadas de recursos principais.

Consola

  1. Na Google Cloud consola, aceda à página Cloud Workstations.

    Aceda a Estações de trabalho

  2. Clique na secção Gestão de clusters.

  3. Clique no cluster do Cloud Workstations para o qual quer apresentar as etiquetas.

  4. As etiquetas são visíveis na secção Etiquetas.

gcloud

Para obter uma lista de associações de etiquetas anexadas a um recurso, use o comando gcloud resource-manager tags bindings list:

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

Substitua o seguinte:

  • RESOURCE_ID: o ID completo do cluster do Cloud Workstations, incluindo o nome do domínio da API (//workstations.googleapis.com/) para identificar o tipo de recurso. Por exemplo, //workstations.googleapis.com/projects/my_project/locations/us-central1/workstationClusters/my_cluster.

  • LOCATION: a região do cluster de estações de trabalho na nuvem.

API

Chame o método v3.tagBindings.list. Inclua o cluster de estações de trabalho na nuvem no campo principal. Por exemplo, //cloudresourcemanager.googleapis.com/projects/my-project/regions/us-central1/workstationClusters/my-cluster.

Desassocie etiquetas de um cluster de estações de trabalho na nuvem

Pode remover uma associação de etiqueta de um cluster do Cloud Workstations eliminando a associação de etiquetas. Se precisar de eliminar uma etiqueta, deve seguir os passos abaixo para desassociar primeiro a etiqueta do cluster do Cloud Workstations.

Consola

  1. Na Google Cloud consola, aceda à página Cloud Workstations.

    Aceda a Estações de trabalho

  2. Clique na secção Gestão de clusters.

  3. Clique no cluster do Cloud Workstations do qual quer desassociar a etiqueta.

  4. Clique em Edit.

  5. Na secção Etiquetas, remova as etiquetas que quer desassociar do cluster do Cloud Workstations.

  6. Clique em Guardar.

gcloud

Para remover uma associação de etiquetas de um cluster de estações de trabalho na nuvem através da linha de comandos, elimine a associação de etiquetas com o comando gcloud resource-manager tags bindings delete:

gcloud resource-manager tags bindings delete \
    --tag-value=TAGVALUE_NAME \
    --parent=RESOURCE_ID \
    --location=LOCATION

Substitua o seguinte:

  • TAGVALUE_NAME: o ID permanente ou o nome com espaço de nomes do valor da etiqueta a anexar, como tagValues/4567890123 ou 1234567/my_tag_key/my_tag_value.
  • RESOURCE_ID: o ID completo do cluster do Cloud Workstations, incluindo o nome do domínio da API (//workstations.googleapis.com/) para identificar o tipo de recurso. Por exemplo, //workstations.googleapis.com/projects/my_project/locations/us-central1/workstationClusters/my_cluster
  • LOCATION: a região do cluster de estações de trabalho na nuvem.

API

Chame o método workstationClusters.patch. Remova as etiquetas no campo tags de WorkstationCluster.

O que se segue?