Anexar e gerenciar tags com domínios gerenciados do Microsoft AD

Neste tópico, mostramos como anexar uma tag ao seu domínio no serviço gerenciado para Microsoft Active Directory (Microsoft AD gerenciado), listar tags anexadas a um domínio e remover de um domínio.

Visão geral

Uma tag é um par de chave-valor que pode ser anexado a um recurso no Google Cloud. Você pode usar tags para permitir ou negar políticas condicionalmente, dependendo de um recurso ter uma tag específica. Por exemplo, é possível conceder papéis do IAM condicionalmente com base no fato de um domínio do Microsoft AD gerenciado ter uma tag específica. 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.

Antes de começar

Antes de começar, faça o seguinte:

Anexar tags a um domínio

Você precisa criar um recurso de vinculação de tags para anexar uma tag ao seu domínio do Microsoft AD gerenciado.

Execute o seguinte comando da CLI da gcloud:

gcloud alpha resource-manager tags bindings create --tag-value=TAG_VALUE_ID --parent=DOMAIN_NAME

Substitua:

  • TAG_VALUE_ID: o ID permanente ou o nome do namespace da valor da tag a ser anexado. Por exemplo, tagValues/1234567890.
  • DOMAIN_NAME: o nome completo do recurso do seu domínio do Microsoft AD gerenciado, na forma de: //managedidentities.googleapis.com/projects/PROJECT_ID/locations/global/domains/DOMAIN-NAME.

Você receberá os detalhes da vinculação de tag criada como uma resposta.

done: true
response:
  '@type': type.googleapis.com/google.cloud.resourcemanager.v3.TagBinding
  name: TAG_BINDING_NAME
  parent: DOMAIN_NAME
  tagValue: TAG_VALUE_ID

Após criar a vinculação de tag, é possível configurar políticas da organização para essas tags usando condições que definem quando a política precisa ser aplicada. Para mais informações, consulte Como definir uma política da organização com tags.

Listar tags anexadas a um domínio

É possível ver a lista de recursos de vinculação de tags anexados ao domínio do Microsoft AD gerenciado.

Execute o seguinte comando da CLI da gcloud:

gcloud alpha resource-manager tags bindings list --parent=DOMAIN_NAME

Substitua:

  • DOMAIN_NAME: o nome completo do recurso do seu domínio do Microsoft AD gerenciado, na forma de: //managedidentities.googleapis.com/projects/PROJECT_ID/locations/global/domains/DOMAIN-NAME.

Você receberá uma resposta sobre a vinculação de tags anexada ao seu domínio.

tagBindings:
  name: TAG_BINDING_NAME
  parent: DOMAIN_NAME
  tagValue: TAG_VALUE_ID

Remover tags de um domínio

Você precisa excluir o recurso de vinculação de tags para remover uma tag do domínio do Microsoft AD gerenciado.

Execute o seguinte comando da CLI da gcloud:

gcloud alpha resource-manager tags bindings delete --tag-value=TAG_VALUE_ID --parent=DOMAIN_NAME

Substitua:

  • TAG_VALUE_ID: o ID permanente ou o nome do namespace da valor da tag a ser anexado. Por exemplo, tagValues/1234567890.
  • DOMAIN_NAME: o nome completo do recurso do seu domínio do Microsoft AD gerenciado, na forma de: //managedidentities.googleapis.com/projects/PROJECT_ID/locations/global/domains/DOMAIN-NAME.

A seguir