Criar e gerenciar tags

É possível anexar tags aos seguintes recursos do Cloud Router:

  • Roteador

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 .

Permissões necessárias

Para receber as permissões necessárias para gerenciar tags, peça ao administrador que conceda a você os seguintes papéis do IAM:

  • Leitor de tags (roles/resourcemanager.tagViewer) nos recursos a que as tags estão anexadas
  • Visualizar e gerenciar tags no nível da organização: Leitor da organização (roles/resourcemanager.organizationViewer) na organização
  • Criar, atualizar e excluir definições de tags: Administrador de tags (roles/resourcemanager.tagAdmin) no recurso em que você está criando, atualizando ou excluindo tags
  • Anexar e remover tags de recursos: Usuário de tags (roles/resourcemanager.tagUser) no valor da tag e nos recursos a que você está anexando ou removendo o valor da tag

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

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Para anexar tags a recursos do Cloud Router, você precisa do papel Administrador de rede do Compute (roles/compute.networkAdmin).

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.

Adicionar tags durante a criação de recursos

É possível adicionar tags ao criar secrets regionais. Ao adicionar tags, você fornece instantaneamente metadados essenciais para seus segredos regionais e também ajuda na organização, no rastreamento de custos e na aplicação automatizada de políticas.

gcloud

Para anexar uma tag a um recurso durante a criação dele, adicione a flag --resource-manager-tags com o respectivo comando create. Por exemplo, para anexar uma tag a um roteador, use o seguinte comando:

gcloud compute routers create ROUTER_NAME \
    --resource-manager-tags=tagKeys/TAGKEY_ID=tagValues/TAGVALUE_ID

Substitua:

  • ROUTER_NAME: o nome do roteador
  • TAGKEY_ID: o ID numérico do número da chave da tag
  • TAGVALUE_ID: o ID numérico permanente do valor da tag anexado; por exemplo: 4567890123

Especifique várias tags separando-as por vírgula, por exemplo, TAGKEY1=TAGVALUE1,TAGKEY2=TAGVALUE2.

API

Envie uma solicitação POST para o seguinte URL:

      POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/{region}/routers

Forneça o seguinte JSON no corpo da solicitação:

      
    {
      "name": "ROUTER_NAME",
      "params": {
        "resourceManagerTags": {
          "tagKeys/TAGKEY_ID": "tagValues/TAGVALUE_ID",
        },
      }
      // Other fields omitted
    }

Substitua:

  • ROUTER_NAME: o nome do roteador
  • TAGKEY_ID: o ID numérico do número da chave da tag
  • TAGVALUE_ID: o ID numérico permanente do valor da tag anexado; por exemplo: 4567890123

Adicionar tags a recursos atuais

Para adicionar uma tag a recursos atuais do Cloud Router, siga estas etapas:

Console

  1. Acesse a página Cloud Router no console do Google Cloud .
  2. Acessar o Cloud Router

  3. Selecione o recurso do Cloud Router a que você quer anexar uma tag.
  4. Clique em Tags.
  5. Se a organização não aparecer no painel Tags, clique em Selecionar escopo. Selecione sua organização e clique em Abrir.
  6. Clique em Adicionar tag.
  7. Selecione na lista a chave da tag que você quer anexar. Para filtrar a lista, digite palavras-chave.
  8. Selecione na lista o valor da tag que você quer anexar. Para filtrar a lista, digite palavras-chave.
  9. Clique em Salvar.
  10. Na caixa de diálogo Confirmar, clique em Confirmar para anexar a tag.
  11. Uma notificação confirma que suas tags foram atualizadas.

gcloud

Para anexar uma tag a um recurso do Cloud Router, crie um recurso de vinculação de tags 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 a um recurso; por exemplo: tagValues/567890123456.
  • RESOURCE_ID: o ID completo do recurso, incluindo a API. nome de domínio para identificar o tipo de recurso (//compute.googleapis.com/). Você precisam usar os IDs numéricos dos recursos, não seus nomes. Por exemplo, o ID de um roteador em projects/7890123456 é o seguinte: //compute.googleapis.com/projects/7890123456/regions/REGION/routers/{resource-id}
  • LOCATION: a localização do recurso. Se você estiver anexando uma tag a um recurso global, como uma pasta ou um projeto, omita essa flag. 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 recursos

É possível consultar uma lista de vinculações de tags anexadas diretamente ou herdadas pelo recurso do Cloud Router.

Console

  1. Acesse a página Cloud Router no console do Google Cloud .
  2. Acessar o Cloud Router

  3. Selecione o recurso para ver os detalhes. As tags aparecem na linha Tags.

gcloud

Para consultar 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 a API. nome de domínio para identificar o tipo de recurso (//compute.googleapis.com/). Você precisam usar os IDs numéricos dos recursos, não seus nomes. Por exemplo, o ID de um roteador em projects/7890123456 é o seguinte: //compute.googleapis.com/projects/7890123456/regions/REGION/routers/{resource-id}
  • 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).

Uma resposta semelhante a esta vai aparecer:

name: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F7890123456/tagValues/567890123456
          tagValue: tagValues/567890123456
          resource: 
//compute.googleapis.com/projects/7890123456/regions/REGION/routers/{resource-id}

      

Remover tags de recursos

Você pode desanexar tags que foram anexadas diretamente a um recurso do Cloud Router. As tags herdadas podem ser substituídas anexando uma tag com a mesma chave e um valor diferente, mas não podem ser removidas.

Console

  1. Acesse a página Cloud Router no console do Google Cloud .
  2. Acessar o Cloud Router

  3. Selecione o recurso do Cloud Router de que você quer remover uma tag.
  4. Clique em Tags.
  5. No painel Tags, ao lado da tag que você quer remover, clique em Excluir item.
  6. Clique em Salvar.
  7. 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 a API. nome de domínio para identificar o tipo de recurso (//compute.googleapis.com/). Você precisam usar os IDs numéricos dos recursos, não seus nomes. Por exemplo, o ID de um roteador em projects/7890123456 é o seguinte: //compute.googleapis.com/projects/7890123456/regions/REGION/routers/{resource-id}
  • LOCATION: a localização do recurso. Se você estiver anexando uma tag a um recurso global, como uma pasta ou um projeto, omita essa flag. 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 ou definição de valor de tag, verifique se ela está separada do recurso do Cloud Router. 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