Gerir etiquetas

Nesta página, vai saber como anexar, desanexar e listar etiquetas em recursos do fluxo de dados, como streams, perfis de associação ou associações privadas. Para uma vista geral das etiquetas no fluxo de dados, consulte o artigo Controlo de acesso com etiquetas.

Acerca das etiquetas

Uma etiqueta é um par de chave-valor que pode anexar a um recurso em Google Cloud. Pode usar etiquetas para permitir ou negar condicionalmente políticas com base no facto de um recurso ter uma etiqueta específica. Por exemplo, pode conceder condicionalmente funções de gestão de identidade e de acesso (IAM) com base no facto de um recurso ter uma etiqueta específica. Para mais informações sobre etiquetas, consulte o artigo Vista geral das etiquetas.

As etiquetas são anexadas aos recursos através da criação de um recurso de associação de etiquetas que associa o valor ao recurso. Google Cloud

Para agrupar streams, perfis de associação ou associações privadas no Datastream para fins de automatização e faturação, use etiquetas. As etiquetas e os rótulos funcionam independentemente uns dos outros e pode aplicá-los a recursos.

Autorizações necessárias

Para receber as autorizações de que precisa para gerir etiquetas, peça ao seu administrador que lhe conceda as seguintes funções do IAM:

  • Visualizador de etiquetas (roles/resourcemanager.tagViewer) nos recursos aos quais as etiquetas estão anexadas
  • Ver e gerir etiquetas ao nível da organização: Visitante da organização (roles/resourcemanager.organizationViewer) na organização
  • Criar, atualizar e eliminar definições de etiquetas: Administrador de etiquetas (roles/resourcemanager.tagAdmin) no recurso para o qual está a criar, atualizar ou eliminar etiquetas
  • Anexar e remover etiquetas de recursos: Utilizador de etiquetas (roles/resourcemanager.tagUser) no valor da etiqueta e nos recursos aos quais está a anexar ou remover o valor da etiqueta

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.

Para anexar etiquetas a recursos do Datastream, precisa da função Administrador do Datastream (roles/datastream.admin) ou de outra função que inclua as seguintes autorizações:

Autorizaçõ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

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

Adicione etiquetas a recursos existentes

Para adicionar uma etiqueta a streams, perfis de associação ou associações privadas existentes, siga estes passos:

Consola

  1. Aceda à página Stream de dados na Google Cloud consola.

    2. Aceda à stream de dados

  2. Selecione a página do recurso ao qual quer anexar uma etiqueta. Por exemplo, para anexar uma etiqueta a um perfil de associação, aceda à página Perfis de associação.
  3. Clique em Etiquetas.
  4. Se a sua organização não aparecer no painel Etiquetas, clique em Selecionar âmbito. Selecione a sua organização e clique em Abrir.
  5. Clique em Adicionar etiqueta.
  6. Selecione a chave da etiqueta que quer anexar na lista. Pode filtrar a lista escrevendo palavras-chave.
  7. Selecione o valor da etiqueta que quer anexar na lista. Pode filtrar a lista escrevendo palavras-chave.
  8. Clique em Guardar.
  9. Na caixa de diálogo Confirmar, clique em Confirmar para anexar a etiqueta.

    10. É apresentada uma notificação a confirmar que as etiquetas foram atualizadas.

gcloud

Para anexar uma etiqueta a uma stream, a um perfil de ligação ou a uma ligação privada, tem de criar um recurso de associação de etiquetas através do 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 anexado, por exemplo, tagValues/567890123456.
  • RESOURCE_ID é o ID completo do recurso, incluindo o nome do domínio da API para identificar o tipo de recurso (//datastream.googleapis.com/). Por exemplo, para anexar uma etiqueta a projects/PROJECT_NAME/streams/STREAM_NAME, o ID completo é: //datastream.googleapis.com/projects/PROJECT_NAME/streams/STREAM_NAME.
  • LOCATION: a localização do seu recurso. Se estiver a anexar uma etiqueta a um recurso global, como uma pasta ou um projeto, omita esta flag. Se estiver a anexar uma etiqueta a um recurso regional ou zonal, tem de especificar a localização. Por exemplo, us-central1 (região) ou us-central1-a (zona).

Liste as etiquetas anexadas aos recursos

Pode ver uma lista de associações de etiquetas diretamente anexadas ou herdadas pela stream, pelo perfil de ligação ou pela ligação privada.

Consola

  1. Aceda à página Stream de dados na Google Cloud consola.

    2. Aceda à stream de dados

  2. Selecione a página do recurso cujas etiquetas quer ver. Por exemplo, para ver as etiquetas do perfil de associação, aceda à página Perfis de associação.

    As etiquetas são apresentadas na coluna Etiquetas da stream, do perfil de associação ou da associação privada.

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 recurso, incluindo o nome do domínio da API para identificar o tipo de recurso (//datastream.googleapis.com/). Por exemplo, para anexar uma etiqueta a projects/PROJECT_NAME/streams/STREAM_NAME, o ID completo é: //datastream.googleapis.com/projects/PROJECT_NAME/streams/STREAM_NAME.
  • LOCATION: a localização do seu recurso. Se estiver a ver uma etiqueta anexada a um recurso global, como uma pasta ou um projeto, omita esta flag. Se estiver a ver uma etiqueta anexada a um recurso regional ou zonal, tem de especificar a localização, por exemplo, us-central1 (região) ou us-central1-a (zona).

Deve receber uma resposta semelhante à seguinte:

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

Desassocie etiquetas de recursos

Pode desanexar etiquetas que tenham sido anexadas diretamente a uma stream, um perfil de ligação ou uma ligação privada. As etiquetas herdadas podem ser substituídas anexando uma etiqueta com a mesma chave e um valor diferente, mas não podem ser desanexadas.

Consola

  1. Aceda à página Stream de dados na Google Cloud consola.

    2. Aceda à stream de dados

  2. Selecione a página do recurso ao qual quer remover uma etiqueta. Por exemplo, para remover uma etiqueta de um perfil de associação, aceda à página Perfis de associação.
  3. Clique em Etiquetas.
  4. No painel Etiquetas, junto à etiqueta que quer desassociar, clique em Eliminar item.
  5. Clique em Guardar.
  6. Na caixa de diálogo Confirmar, clique em Confirmar para desanexar a etiqueta.

É apresentada uma notificação a confirmar que as etiquetas foram atualizadas.

gcloud

Para eliminar uma associação de etiqueta, 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 o seguinte:

  • TAGVALUE_NAME: o ID permanente ou o nome com espaço de nomes do valor da etiqueta anexado, por exemplo, tagValues/567890123456.
  • RESOURCE_ID é o ID completo do recurso, incluindo o nome do domínio da API para identificar o tipo de recurso (//datastream.googleapis.com/). Por exemplo, para anexar uma etiqueta a projects/PROJECT_NAME/streams/STREAM_NAME, o ID completo é: //datastream.googleapis.com/projects/PROJECT_NAME/streams/STREAM_NAME.
  • LOCATION: a localização do seu recurso. Se estiver a anexar uma etiqueta a um recurso global, como uma pasta ou um projeto, omita esta flag. Se estiver a anexar uma etiqueta a um recurso regional ou zonal, tem de especificar a localização. Por exemplo, us-central1 (região) ou us-central1-a (zona).

Elimine chaves e valores de etiquetas

Quando remover uma definição de valor ou chave de etiqueta, certifique-se de que a etiqueta está desassociada da stream, do perfil de associação ou da associação privada. Tem de eliminar as associações de etiquetas existentes, denominadas associações de etiquetas, antes de eliminar a própria definição de etiqueta. Para eliminar chaves de etiquetas e valores de etiquetas, consulte o artigo Eliminar etiquetas.

Condições e etiquetas da gestão de identidade e de acesso

Pode usar etiquetas e condições da IAM para conceder condicionalmente associações de funções a utilizadores na sua hierarquia. A alteração ou a eliminação da etiqueta anexada a um recurso pode remover o acesso do utilizador a esse recurso se tiver sido aplicada uma política do IAM com associações de funções condicionais. Para mais informações, consulte o artigo Condições e etiquetas da gestão de identidade e de acesso.

O que se segue?