创建和管理标记

您可以将标记附加到以下 Cloud Router 资源：

路由器

关于标记

标记是一种可附加到Google Cloud中的资源的键值对。您可以使用标记，根据资源是否有特定标记，有条件地允许或拒绝政策。例如，您可以根据资源是否具有特定标记，有条件地授予 Identity and Access Management (IAM) 角色。如需详细了解标记，请参阅标记概览。

通过创建可将值关联到 Google Cloud 资源的标记绑定资源，系统会将标记附加到资源。

所需权限

如需获得管理标记所需的权限，请让您的管理员为您授予以下 IAM 角色：

针对标记附加到的资源的 Tag Viewer (roles/resourcemanager.tagViewer)
在组织级层查看和管理标记：针对组织的 Organization Viewer (roles/resourcemanager.organizationViewer)
创建、更新和删除标记定义：针对您要为其创建、更新或删除标记的资源的 Tag Administrator (roles/resourcemanager.tagAdmin)
在资源中附加和移除标记：针对标记值以及您要为其附加或移除标记值的资源的 Tag User (roles/resourcemanager.tagUser)

如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

如需将标记附加到 Cloud Router 资源，您需要 Compute Network Admin 角色 (roles/compute.networkAdmin)。

创建标记键和标记值

在附加标记之前，您需要创建标记并配置其值。如需创建标记键和标记值，请参阅创建标记和添加标记值。

在创建资源期间添加标记

您可以在创建地区级 Secret 时添加标记。在创建资源期间添加标记，可以立即为资源提供必要的元数据，同时有助于更好地进行组织管理、费用跟踪和自动应用政策。

gcloud

如需在资源创建期间将标记附加到资源，请在相应的 create 命令中添加 --resource-manager-tags 标志。例如，如需将标记附加到网络，请使用以下命令：

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

替换以下内容：

ROUTER_NAME：路由器的名称
TAGKEY_ID：标记键编号数字 ID
TAGVALUE_ID：所附加的标记值的永久数字 ID，例如 4567890123

要指定多个标记，请使用英文逗号分隔标记，例如 TAGKEY1=TAGVALUE1,TAGKEY2=TAGVALUE2

API

向以下网址发送 POST 请求：

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

在请求正文中提供以下 JSON：

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

替换以下内容：

ROUTER_NAME：路由器的名称
TAGKEY_ID：标记键编号数字 ID
TAGVALUE_ID：所附加的标记值的永久数字 ID，例如 4567890123

为现有资源添加标记

如需为现有 Cloud Router 资源添加标记，请按照以下步骤操作：

控制台

前往 Google Cloud 控制台中的 Cloud Router 页面。

前往 Cloud Router

选择您要为其附加标记的 Cloud Router 资源。
点击标记。
如果您的组织未显示在标记面板中，请点击选择范围。选择您的组织，然后点击打开。
点击添加标记。
从列表中选择要附加的标记的键。您可以通过输入关键字来过滤列表。
从列表中选择要附加的标记的值。您可以通过输入关键字来过滤列表。
点击保存。
在确认对话框中，点击确认以附加标记。

系统会显示一条通知以确认您的标记已更新。

gcloud

如需将标记附加到 Cloud Router 资源，您必须使用 gcloud resource-manager tags bindings create 命令创建标记绑定资源：

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

替换以下内容：

TAGVALUE_NAME 是所附加的标记值的永久 ID 或命名空间名称，例如 tagValues/567890123456。
RESOURCE_ID：资源的完整 ID，包括用于标识资源类型的 API 域名 (//compute.googleapis.com/)。您必须使用资源的数字 ID，而不是其名称。例如，projects/7890123456 中路由器的资源 ID 如下所示： //compute.googleapis.com/projects/7890123456/regions/REGION/routers/{resource-id}
LOCATION：资源的位置。如果您要将标记附加到全球性资源（例如文件夹或项目），请省略此标志。如果您要将标记附加到区域级或可用区级资源，则必须指定位置，例如 us-central1（区域）或 us-central1-a（可用区）。

列出附加到资源的标记

您可以查看直接附加到 Cloud Router 资源或由 Cloud Router 资源继承的标记绑定的列表。

控制台

前往 Google Cloud 控制台中的 Cloud Router 页面。

前往 Cloud Router

选择相应资源以查看其详细信息。标签会显示在标签行中。

gcloud

如需获取附加到资源的标记绑定列表，请使用 gcloud resource-manager tags bindings list 命令：

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

替换以下内容：

RESOURCE_ID：资源的完整 ID，包括用于标识资源类型的 API 域名 (//compute.googleapis.com/)。您必须使用资源的数字 ID，而不是其名称。例如，projects/7890123456 中路由器的资源 ID 如下所示： //compute.googleapis.com/projects/7890123456/regions/REGION/routers/{resource-id}
LOCATION：资源的位置。如果您要查看附加到全球性资源（例如文件夹或项目）的标记，请省略此标志。如果您要查看附加到区域级或可用区级资源的标记，则必须指定位置，例如 us-central1（区域）或 us-central1-a（可用区）。

您应该会看到如下所示的响应：

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

将标记与资源分离

您可以分离直接附加到 Cloud Router 资源的标记。可以通过附加具有相同键和不同值的标记来替换继承的标记，但不能分离这些标记。

控制台

前往 Google Cloud 控制台中的 Cloud Router 页面。

前往 Cloud Router

选择要从中移除标记的 Cloud Router 资源。
点击标记。
在标记面板中，点击要分离的标记旁边的 删除项。
点击保存。
在确认对话框中，点击确认以分离标记。

系统会显示一条通知以确认您的标记已更新。

gcloud

如需删除标记绑定，请使用 gcloud resource-manager tags bindings delete 命令：

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

替换以下内容：

TAGVALUE_NAME 是所附加的标记值的永久 ID 或命名空间名称，例如 tagValues/567890123456。
RESOURCE_ID：资源的完整 ID，包括用于标识资源类型的 API 域名 (//compute.googleapis.com/)。您必须使用资源的数字 ID，而不是其名称。例如，projects/7890123456 中路由器的资源 ID 如下所示： //compute.googleapis.com/projects/7890123456/regions/REGION/routers/{resource-id}
LOCATION：资源的位置。如果您要将标记附加到全球性资源（例如文件夹或项目），请省略此标志。如果您要将标记附加到区域级或可用区级资源，则必须指定位置，例如 us-central1（区域）或 us-central1-a（可用区）。

删除标记键和标记值

移除标记键或值定义时，请确保标记已与 Cloud Router 资源分离。在删除标记定义本身之前，您必须先删除现有的标记连接（称为标记绑定）。如需删除标记键和标记值，请参阅删除标记。

Identity and Access Management 条件和标记

您可以使用标记和 IAM 条件来有条件地向层次结构中的用户授予角色绑定。如果应用了具有条件角色绑定的 IAM 政策，则更改或删除附加到资源的标记可能会移除用户对该资源的访问权限。如需了解详情，请参阅 Identity and Access Management 条件和标记。

后续步骤

查看其他支持标记的服务。
请参阅标记和访问权限控制，了解如何将标记与 IAM 搭配使用。