Incluir tags nos recursos do Cloud Workstations

Neste documento, descrevemos como usar tags para aplicar condicionalmente as políticas do Identity and Access Management (IAM) a clusters do Cloud Workstations.

Uma tag é um par de chave-valor que pode ser anexado diretamente a um cluster do Cloud Workstations. Um cluster do Cloud Workstations também pode herdar uma tag de outros recursos doGoogle Cloud . É possível aplicar condicionalmente políticas baseadas em um recurso que tem uma tag específica. Por exemplo, é possível conceder condicionalmente o papel Criador do Cloud Workstations a um principal em qualquer cluster do Cloud Workstations com a tag environment:dev.

Para mais informações sobre o uso de tags na hierarquia de recursos do Google Cloud, consulte Visão geral das tags.

Antes de começar

Você precisa conceder papéis do IAM que forneçam aos usuários as permissões necessárias para realizar cada tarefa neste documento. Você também precisa criar chaves e valores de tag para anexar aos recursos.

Funções exigidas

Os papéis a seguir fornecem as permissões necessárias para adicionar tags aos recursos do Cloud Workstations:

Anexar uma tag a um cluster do Cloud Workstations

Para receber as permissões necessárias para anexar uma tag a um cluster do Cloud Workstations, peça ao administrador para conceder a você os seguintes papéis do IAM:

• Para criar um cluster do Cloud Workstations: Administrador do Cloud Workstations (roles/workstations.admin) no seu projeto
• Para criar tags: Administrador de tags (roles/resourcemanager.tagAdmin) no seu projeto
• Para gerenciar tags: Usuário da tag (roles/resourcemanager.tagUser) no valor da tag e no cluster do Cloud Workstations

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

Esses papéis predefinidos contêm as permissões necessárias para anexar uma tag a um cluster do Cloud Workstations. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Remover uma tag de um cluster do Cloud Workstations

Para receber as permissões necessárias para remover uma tag de um cluster do Cloud Workstations, peça ao administrador para conceder a você os seguintes papéis do IAM:

• Para remover uma tag de um cluster do Cloud Workstations: Administrador do Cloud Workstations (roles/workstations.admin) no seu projeto
• Para gerenciar tags: Usuário da tag (roles/resourcemanager.tagUser) no valor da tag e no cluster do Cloud Workstations
• Para excluir tags: Administrador de tags (roles/resourcemanager.tagAdmin) no projeto

Esses papéis predefinidos contêm as permissões necessárias para remover uma tag de um cluster do Cloud Workstations. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Listar tags anexadas a um cluster do Cloud Workstations

Para receber as permissões necessárias para listar as tags anexadas a um cluster do Cloud Workstations, peça ao administrador para conceder a você os seguintes papéis do IAM:

• Para listar as tags anexadas a um cluster do Cloud Workstations: Administrador do Cloud Workstations (roles/workstations.admin) no seu projeto
• Para listar tags: Visualizador de tags (roles/resourcemanager.tagViewer) no valor da tag e no cluster do Cloud Workstations

Esses papéis predefinidos contêm as permissões necessárias para listar as tags anexadas a um cluster do Cloud Workstations. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Criar chaves e valores de tags

Antes de anexar uma tag, é preciso criá-la e configurar o valor dela. Para criar chaves e valores de tag, consulte Como criar uma tag e Como adicionar valores de tag.

Adicionar tags aos clusters do Cloud Workstations

As seções a seguir descrevem como anexar tags a clusters novos e atuais do Cloud Workstations, listar tags anexadas a um cluster do Cloud Workstations e remover tags de um cluster do Cloud Workstations.

Anexar tags ao criar um cluster do Cloud Workstations

Depois de criar uma tag, você pode anexá-la a um novo cluster do Cloud Workstations. Para cada chave de tag, é possível anexar um valor de tag a um cluster do Cloud Workstations. Para cada cluster do Cloud Workstations, é possível anexar no máximo 50 tags.

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

Anexar tags a um cluster do Cloud Workstations

Depois de criar uma tag, você pode anexá-la a um cluster do Cloud Workstations. Para cada chave de tag, é possível anexar um valor de tag a um cluster do Cloud Workstations. Para cada cluster do Cloud Workstations, é possível anexar no máximo 50 tags.

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

Listar tags anexadas a um cluster do Cloud Workstations

É possível listar as tags anexadas diretamente a um cluster do Cloud Workstations. Esse processo não lista as tags herdadas dos recursos pai.

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

Remover tags de um cluster do Cloud Workstations

Para remover uma associação de tag de um cluster do Cloud Workstations, exclua a vinculação. Se você precisar excluir uma tag, siga estas etapas para removê-la do seu cluster do Cloud Workstations.

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

A seguir

• Para uma visão geral das tags no Google Cloud, consulte Visão geral sobre tags.
• Para mais informações sobre como usar tags, consulte Como criar e gerenciar tags.
• Para informações sobre como controlar o acesso aos recursos do Cloud Workstations com as condições do IAM, consulte Controle de acesso com as condições do IAM.