Gerenciar tags

Nesta seção, você aprenderá a anexar, remover e listar tags em recursos do Datastream, como streams, perfis de conexão ou conexões particulares. Para uma visão geral das tags no Datastream, consulte Controle de acesso com tags.

Sobre as tags

Uma tag é um par de chave-valor que pode ser anexado a um recurso no Google Cloud. É possível usar tags para permitir ou negar políticas condicionalmente com base no fato de um recurso ter uma tag específica ou não. Por exemplo, é possível conceder condicionalmente papéis do Identity and Access Management (IAM) com base no fato de um recurso ter uma tag específica ou não. Para mais informações sobre tags, consulte Visão geral de tags.

As tags são anexadas aos recursos criando um recurso de vinculação de tags que vincula o valor ao recurso do Google Cloud.

Para agrupar streams, perfis de conexão ou conexões particulares no Datastream para fins de automação e faturamento, use rótulos. As tags e os rótulos funcionam de maneira independente uns dos outros, e é possível aplicar os dois aos recursos.

Permissões necessárias

As permissões necessárias dependem da ação que você precisa realizar.

Para receber essas permissões, peça ao administrador para conceder o papel sugerido no nível apropriado da hierarquia de recursos.

Visualizar tags

Para visualizar as definições de tag e tags anexadas aos recursos, você precisa do papel Visualizador de tags (roles/resourcemanager.tagViewer) ou de outro papel que inclua as seguintes permissões:

Permissões necessárias

resourcemanager.tagKeys.get
resourcemanager.tagKeys.list
resourcemanager.tagValues.list
resourcemanager.tagValues.get
listTagBindings para o tipo de recurso apropriado. Por exemplo, compute.instances.listTagBindings para visualizar as tags anexadas a instâncias do Compute Engine.
listEffectiveTags

compute.instances.listEffectiveTags

Para visualizar as tags no nível da organização, é preciso ter o papel de Visualizador da organização (roles/resourcemanager.organizationViewer) no recurso da organização.

Administrar tags

Para criar, atualizar e excluir definições de tag, você precisa do papel Administrador de tags (roles/resourcemanager.tagAdmin) ou de outro papel que inclua as seguintes permissões:

Permissões necessárias

resourcemanager.tagKeys.create
resourcemanager.tagKeys.update
resourcemanager.tagKeys.delete
resourcemanager.tagKeys.list
resourcemanager.tagKeys.get
resourcemanager.tagKeys.getIamPolicy
resourcemanager.tagKeys.setIamPolicy
resourcemanager.tagValues.create
resourcemanager.tagValues.update
resourcemanager.tagValues.delete
resourcemanager.tagValues.list
resourcemanager.tagValues.get
resourcemanager.tagValues.getIamPolicy
resourcemanager.tagValues.setIamPolicy

Para administrar tags no nível da organização, você precisa do papel de Visualizador da organização (roles/resourcemanager.organizationViewer) no recurso da organização.

Gerenciar tags em recursos

Para adicionar e remover tags anexadas a recursos, você precisa do papel Usuário da tag (roles/resourcemanager.tagUser) ou de outro papel com permissões equivalentes, nos tag e os recursos que você está anexando ao valor da tag. O papel Tag User inclui as seguintes permissões:

Permissões necessárias

As permissões necessárias para o recurso ao qual você está anexando o valor da tag

Permissão createTagBinding específica do recurso, como compute.instances.createTagBinding para instâncias do Compute Engine
Permissão deleteTagBinding específica do recurso, como compute.instances.deleteTagBinding para instâncias do Compute Engine

As permissões necessárias para o valor da tag:

resourcemanager.tagValueBindings.create
resourcemanager.tagValueBindings.delete

Permissões que permitem visualizar projetos e definições de tags:

resourcemanager.tagValues.get
resourcemanager.tagValues.list
resourcemanager.tagKeys.get
resourcemanager.tagKeys.list
resourcemanager.projects.get

Para anexar tags aos recursos do Datastream, você precisa do papel Administrador do Datastream (roles/datastream.admin) ou de outro papel que inclua as seguintes permissões:

Permissões necessárias

datastream.connectionProfiles.createTagBinding
datastream.connectionProfiles.deleteTagBinding
datastream.connectionProfiles.listTagBindings
datastream.connectionProfiles.listEffectiveTags
datastream.streams.createTagBinding
datastream.streams.deleteTagBinding
datastream.streams.listTagBindings
datastream.streams.listEffectiveTags
datastream.privateConnections.createTagBinding
datastream.privateConnections.deleteTagBinding
datastream.privateConnections.listTagBindings
datastream.privateConnections.listEffectiveTags

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 um valor de tag.

Anexar uma tag a um stream, perfil de conexão ou conexão particular

Depois que a tag for criada, anexe-a a um stream, perfil de conexão ou conexão particular.

Console

Acesse a página Datastream no console do Google Cloud.

Acessar o Datastream

Selecione a página do recurso ao qual você quer anexar uma tag. Por exemplo, para anexar uma tag a um perfil de conexão, acesse a página Perfis de conexão.
Clique em Tags.
Caso sua organização não apareça no painel Tags, clique em Selecionar escopo. Selecione a organização e clique em **Abrir**.
Clique em Adicionar tag.
Selecione na lista a chave da tag que você quer anexar. Para filtrar a lista, digite palavras-chave.
Selecione na lista o valor da tag que você quer anexar. Para filtrar a lista, digite palavras-chave.
Clique em Save.
Na caixa de diálogo Confirmar, clique em Confirmar para anexar a tag.

Uma notificação confirma que suas tags foram atualizadas.

gcloud

Para anexar uma tag a um stream, perfil de conexão ou conexão particular, crie um recurso de vinculação de tag usando o comando gcloud resource-manager tags bindings create:

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

Substitua:

TAGVALUE_NAME é o ID permanente ou o nome do namespace do valor da tag anexado; por exemplo: tagValues/567890123456.
RESOURCE_ID é o ID completo do recurso, incluindo o nome de domínio da API para identificar o tipo de recurso (//datastream.googleapis.com/). Por exemplo, para anexar uma tag a projects/PROJECT_NAME/streams/STREAM_NAME, o ID completo é: //datastream.googleapis.com/projects/PROJECT_NAME/streams/STREAM_NAME.
LOCATION: a localização do recurso. Se você anexar uma tag a um recurso global, como uma pasta ou um projeto, omita essa sinalização. Se você estiver anexando uma tag a um recurso regional ou zonal, especifique o local, por exemplo: us-central1 (região) ou us-central1-a (zona).

Listar tags anexadas a um stream, perfil de conexão ou conexão particular

É possível conferir uma lista de vinculações de tags diretamente anexadas ou herdadas pelo stream, perfil de conexão ou conexão particular.

Console

Acesse a página Datastream no console do Google Cloud.

Acessar o Datastream

Selecione a página do recurso em que você quer visualizar as tags. Por exemplo, para ver as tags do perfil de conexão, acesse a página Perfis de conexão.

As tags são mostradas na coluna Tags do stream, do perfil da conexão ou da conexão particular.

gcloud

Para ver uma lista de vinculações de tags 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:

RESOURCE_ID é o ID completo do recurso, incluindo o nome de domínio da API para identificar o tipo de recurso (//datastream.googleapis.com/). Por exemplo, para anexar uma tag a projects/PROJECT_NAME/streams/STREAM_NAME, o ID completo é: //datastream.googleapis.com/projects/PROJECT_NAME/streams/STREAM_NAME.
LOCATION: a localização do recurso. Se você estiver visualizando uma tag anexada a um recurso global, como uma pasta ou um projeto, omita essa flag. Se você estiver visualizando uma tag anexada a um recurso regional ou zonal, especifique o local, por exemplo: us-central1 (região) ou us-central1-a (zona).

Você receberá uma resposta semelhante a esta:

name: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F7890123456/tagValues/567890123456
          tagValue: tagValues/567890123456
          resource: //datastream.googleapis.com/projects/project-abc/streams/stream-xyz<

Remover tags de um stream, perfil de conexão ou conexão particular

É possível remover tags que foram diretamente anexadas a um stream, perfil de conexão ou conexão particular. As tags herdadas podem ser substituídas anexando uma tag com a mesma chave e um valor diferente, mas não podem ser removidas. Para excluir uma tag, remova a chave e os valores dela de todos os recursos a que ela está anexada.

Console

Acesse a página Datastream no console do Google Cloud.

Acessar o Datastream

Selecione a página do recurso em que você quer remover uma tag. Por exemplo, para remover uma tag de um perfil de conexão, acesse a página Perfis de conexão.
Clique em Tags.
No painel Tags, ao lado da tag que você quer remover, clique em Excluir item.
Clique em Save.
Na caixa de diálogo Confirmar, clique em Confirmar para remover a tag.

Uma notificação confirma que suas tags foram atualizadas.

gcloud

Para excluir uma vinculação de tag, use o comando gcloud resource-manager tags bindings delete:

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

Substitua:

TAGVALUE_NAME é o ID permanente ou o nome do namespace do valor da tag anexado; por exemplo: tagValues/567890123456.
RESOURCE_ID é o ID completo do recurso, incluindo o nome de domínio da API para identificar o tipo de recurso (//datastream.googleapis.com/). Por exemplo, para anexar uma tag a projects/PROJECT_NAME/streams/STREAM_NAME, o ID completo é: //datastream.googleapis.com/projects/PROJECT_NAME/streams/STREAM_NAME.
LOCATION: a localização do recurso. Se você anexar uma tag a um recurso global, como uma pasta ou um projeto, omita essa sinalização. Se você estiver anexando uma tag a um recurso regional ou zonal, especifique o local, por exemplo: us-central1 (região) ou us-central1-a (zona).

Excluir chaves e valores de tags

Ao remover uma chave de tag ou definição de valor, confira se a tag está removida do stream, do perfil de conexão ou da conexão particular. Você precisa excluir os anexos de tag, chamados de vinculações de tag, antes de excluir a definição da tag. Para excluir chaves e valores de tags, consulte Como excluir tags.

Condições e tags do Identity and Access Management

Você pode usar tags e condições do IAM para conceder vinculações de papéis condicionalmente aos usuários na sua hierarquia. Alterar ou excluir a tag anexada a um recurso removerá o acesso do usuário a esse recurso se uma política do IAM com vinculações de papéis condicionais tiver sido aplicada. Para mais informações, consulte Condições e tags do Identity and Access Management.

A seguir

Veja os outros serviços que têm suporte a tags.
Consulte Tags e controle de acesso para ver como usar tags com o IAM.

Usar as APIs do Datastream

Gerenciar configurações de conectividade particular usando a API