在防火墙政策中使用地址组

如需使用地址组,您必须先确定与您的要求相关的地址组的范围。范围用于标识地址组在资源层次结构中的适用级别。

如果您要在应用于单个项目的防火墙政策规则中使用地址组,请使用项目级地址组

如果您要在适用于组织或网络中整个层次结构的所有资源的防火墙政策规则中使用地址组,请使用组织级地址组

项目级地址组

本部分详细介绍了如何管理项目级地址组。

项目级地址组在项目级层定义,并且仅适用于在其中创建它们的项目。如需使用地址组,您必须将其与全球网络防火墙政策区域级网络防火墙政策中的防火墙规则相关联。地址组的位置必须与其使用的防火墙政策的位置相同。

创建地址组

项目级地址组的容器类型始终设置为 projects

创建地址组时,您可以将地址组的名称指定为字符串或唯一网址标识符。项目级地址组的唯一网址可以按以下格式构建:

projects/PROJECT_ID/locations/location/addressGroups/ADDRESS_GROUP_NAME

如果您为地址组名称使用唯一网址标识符,则地址组的位置已包含在该网址标识符中。但是,如果您仅使用地址组名称,则必须单独指定位置。 如需详细了解唯一网址标识符,请参阅地址组规范

地址组可以包含 IPv4 或 IPv6 内容类型,但不能同时包含这两种类型。您还必须指定地址组的内容容量上限。地址组创建后,您将无法更改地址组的名称、内容类型或内容容量。

gcloud

gcloud network-security address-groups create NAME \
   --type TYPE \
   --capacity CAPACITY \
   --location LOCATION \
   --description DESCRIPTION

请替换以下内容:

  • NAME:地址组的名称;您可以将该名称指定为字符串或唯一网址标识符

  • TYPE:地址组的类型 - IPv4 或 IPv6

  • CAPACITY:地址组的容量

  • LOCATION:地址组的位置

    此位置可以设置为 global 或区域代码(例如 europe-west)。如果您为 name 参数使用唯一网址标识符,则可以省略 location 参数。

  • DESCRIPTION:地址组的可选说明

描述地址组

如需查看地址组的详细信息,您必须指定地址组的名称和位置。

gcloud

gcloud network-security address-groups describe NAME \
    --location LOCATION

更新地址组说明

您无法更新地址组的名称、类型或容量。您只能更新地址组说明。

gcloud

gcloud network-security address-groups update NAME \
    --description DESCRIPTION \
    --location LOCATION

列出地址组

您可以列出一个位置中的所有地址组。

gcloud

gcloud network-security address-groups list \
    --location LOCATION 

删除地址组

您可以通过指定地址组的名称和位置来将其删除。但是,如果防火墙政策引用了该地址组,则该地址组无法删除。

gcloud

gcloud network-security address-groups delete NAME \
  --location LOCATION

查找地址组引用

地址组由防火墙政策使用。您可以找到使用特定地址组的所有防火墙政策的列表。

gcloud

gcloud network-security address-groups list-references NAME \
    --location LOCATION

向地址组添加内容

您可以向地址组添加多项内容,例如 IP 地址或 IP 范围。如果请求中包含已经属于地址组的内容,则系统会忽略这些内容。如果请求包含无效内容,则整个请求会失败。

gcloud

gcloud network-security address-groups add-items NAME \
    --items ITEMS \
    --location LOCATION

请替换以下内容:

  • NAME:地址组的名称;您可以将该名称指定为字符串或唯一网址标识符

  • ITEMS:以英文逗号分隔的 IP 地址或 IP 范围列表(采用 CIDR 格式)

  • LOCATION:地址组的位置

    此位置可以设置为 global 或区域代码(例如 europe-west)。如果您为 name 参数使用唯一网址标识符,则可以省略 location 参数。

从地址组中移除内容

您可以从地址组中移除现有内容。如果请求中的任何内容无效,则请求会失败。如果请求中包含不属于地址组的内容,则系统会忽略这些内容。

gcloud

gcloud network-security address-groups remove-items NAME \
    --items ITEMS \
    --location LOCATION

从其他地址组中克隆内容

您可以将内容从一个地址组克隆到另一个地址组。如需克隆地址组,请遵循以下准则:

  • 两个地址组必须属于同一类型。
  • 两个地址组必须位于同一区域。
  • 确保新地址组有足够的容量来容纳要克隆的来源地址组的内容。
  • 如需指定来源地址组,请使用以下唯一网址标识符格式:

    projects/PROJECT_ID/locations/location/addressGroups/ADDRESS_GROUP_NAME
    

    如需详细了解地址组的唯一网址标识符,请参阅地址组规范

gcloud

gcloud network-security address-groups clone-items NAME \
    --source SOURCE_NAMED_LIST \
    --location LOCATION

请替换以下内容:

  • NAME:地址组的名称;您可以将该名称指定为字符串或唯一网址标识符

  • SOURCE_NAMED_LIST:从其中克隆内容的来源地址组的唯一网址标识符

  • LOCATION:目标地址组的位置

    此位置可以设置为 global 或区域代码(例如 europe-west)。如果您为 name 参数使用唯一网址标识符,则可以省略 location 参数。

组织级地址组

本部分详细介绍了如何管理组织级地址组。

组织级地址组在组织级层定义,并应用于组织中资源层次结构所指定的所有资源。如需使用地址组,您必须将其与分层防火墙政策全球网络防火墙政策区域级网络防火墙政策中的防火墙规则相关联。

创建地址组

组织级地址组的容器类型始终设置为 organization

创建地址组时,您可以将地址组的名称指定为字符串或唯一网址标识符。组织级地址组的唯一网址可以按以下格式构建:

organization/ORGANIZATION_ID/locations/LOCATION/addressGroups/ADDRESS_GROUP_NAME

如果您为地址组名称使用唯一网址标识符,则地址组的组织 ID 或位置已包含在该网址标识符中。但是,如果您仅使用地址组名称,则必须指定组织的 ID 以及在其中定义地址组的位置。如需详细了解唯一网址标识符,请参阅地址组规范

地址组可以包含 IPv4 或 IPv6 内容类型,但不能同时包含这两种类型。您还必须指定地址组的内容容量上限。地址组创建后,您将无法更改地址组的名称、内容类型或内容容量。

gcloud

gcloud network-security org-address-groups create NAME \
   --organization ORGANIZATION \
   --type TYPE \
   --capacity CAPACITY \
   --location LOCATION \
   --description DESCRIPTION

请替换以下内容:

  • NAME:地址组的名称;您可以将该名称指定为字符串或唯一网址标识符

  • ORGANIZATION:在其中创建地址组的组织的 ID

    如果您为 name 参数使用唯一网址标识符,则可以省略 organization 参数。

  • TYPE:地址组的类型 - IPv4 或 IPv6

  • CAPACITY:地址组的容量

  • LOCATION:地址组的位置

    此位置可以设置为 global 或区域代码(例如 europe-west)。如果您为 name 参数使用唯一网址标识符,则可以省略 location 参数。

  • DESCRIPTION:地址组的可选说明

描述地址组

您可以查看特定地址组的详细信息。

gcloud

gcloud network-security org-address-groups describe NAME \
    --organization ORGANIZATION \
    --location LOCATION

更新地址组说明

您无法更新地址组的名称、类型或容量。您只能更新地址组说明。

gcloud

gcloud network-security org-address-groups update NAME \
    --organization ORGANIZATION \
    --description DESCRIPTION \
    --location LOCATION

列出地址组

您可以列出一个位置中的所有地址组。

gcloud

gcloud network-security org-address-groups list \
    --organization ORGANIZATION \
    --location LOCATION 

删除地址组

您可以通过指定地址组的名称、组织和位置来将其删除。如果防火墙政策引用了该地址组,则该地址组无法删除。

gcloud

gcloud network-security org-address-groups delete NAME \
  --organization ORGANIZATION \
  --location LOCATION

查找地址组引用

地址组由防火墙政策使用。您可以找到使用特定地址组的所有防火墙政策的列表。

gcloud

gcloud network-security org-address-groups list-references NAME \
    --organization ORGANIZATION \
    --location LOCATION

向地址组添加内容

您可以向地址组添加多项内容,例如 IP 地址或 IP 范围。如果请求中包含已经属于地址组的内容,则系统会忽略此类内容。如果请求包含无效内容,则整个请求会失败。

gcloud

gcloud network-security org-address-groups add-items NAME \
    --organization ORGANIZATION \
    --items ITEMS \
    --location LOCATION

请替换以下内容:

  • NAME:地址组的名称;您可以将该名称指定为字符串或唯一网址标识符

  • ORGANIZATION:在其中创建地址组的组织的 ID

    如果您为 name 参数使用唯一网址标识符,则可以省略 organization 参数。

  • ITEMS:以英文逗号分隔的 IP 地址或 IP 范围列表(采用 CIDR 格式)

  • LOCATION:地址组的位置

    此位置可以设置为 global 或区域代码(例如 europe-west)。如果您为 name 参数使用唯一网址标识符,则可以省略 location 参数。

从地址组中移除内容

您可以从地址组中移除现有内容。如果请求中的任何内容无效,则请求会失败。如果请求中包含不属于地址组的内容,则系统会忽略这些内容。

gcloud

gcloud network-security org-address-groups remove-items NAME \
    --organization ORGANIZATION \
    --items ITEMS \
    --location LOCATION

从其他地址组中克隆内容

您可以将内容从一个地址组克隆到另一个地址组。如需克隆地址组,请遵循以下准则:

  • 两个地址组必须属于同一类型。
  • 两个地址组必须位于同一位置。
  • 确保新地址组有足够的容量来容纳要克隆的来源地址组的内容。
  • 如需指定来源地址组,您必须使用以下唯一网址标识符:

    organization/ORGANIZATION_ID/locations/LOCATION/addressGroups/ADDRESS_GROUP_NAME
    

    如需详细了解地址组的唯一网址标识符,请参阅地址组规范

gcloud

gcloud network-security org-address-groups clone-items NAME \
    --organization ORGANIZATION \
    --source SOURCE_NAMED_LIST \
    --location LOCATION

请替换以下内容:

  • NAME:地址组的名称;您可以将该名称指定为字符串或唯一网址标识符

  • ORGANIZATION:在其中创建地址组的组织的 ID

    如果您为 name 参数使用唯一网址标识符,则可以省略 organization 参数。

  • SOURCE_NAMED_LIST:从其中克隆内容的来源地址组的唯一网址标识符

  • LOCATION:目标地址组的位置

    此位置可以设置为 global 或区域代码(例如 europe-west)。如果您为 name 参数使用唯一网址标识符,则可以省略 location 参数。

后续步骤