REST Resource: projects.locations.networkPolicies.externalAccessRules

资源：ExternalAccessRule

用于过滤发往 ExternalAddress 资源的入站流量的外部访问防火墙规则。

JSON 表示法 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "description": string,
  "priority": integer,
  "action": enum (Action),
  "ipProtocol": string,
  "sourceIpRanges": [
    {
      object (IpRange)
    }
  ],
  "sourcePorts": [
    string
  ],
  "destinationIpRanges": [
    {
      object (IpRange)
    }
  ],
  "destinationPorts": [
    string
  ],
  "state": enum (State),
  "uid": string
}
字段
name

string

仅限输出。相应外部访问规则的资源名称。资源名称是无方案 URI，遵循 https://cloud.google.com/apis/design/resource_names 中的惯例。例如 projects/my-project/locations/us-central1/networkPolicies/my-policy/externalAccessRules/my-rule
createTime

string (Timestamp format)

仅限输出。相应资源的创建时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

仅限输出。相应资源的上次更新时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
description

string

用户为此外部访问规则提供的说明。
priority

integer

外部访问规则优先级，用于确定在应用多条规则时要使用哪条外部访问规则。如果多个规则具有相同的优先级，则它们的顺序是不确定的。如果需要特定的排序，请分配唯一的优先级以强制执行此类排序。外部访问规则优先级是一个从 100 到 4096 的整数（含边界值）。数字越小，优先级越高。例如，优先级为 100 的规则的优先级高于优先级为 101 的规则。
action

enum (Action)

外部访问规则执行的操作。
ipProtocol

string

外部访问规则所应用的 IP 协议。此值可以是以下三个协议字符串之一（不区分大小写）：tcp、udp 或 icmp。
sourceIpRanges[]

object (IpRange)

如果指定了来源范围，则外部访问规则仅适用于来源 IP 地址位于这些范围内的流量。这些范围可以采用 CIDR 格式或 IP 地址的形式表示。由于仅支持入站规则，因此 ExternalAddress 资源不能作为外部访问规则的源 IP 地址。如需匹配所有来源地址，请指定 0.0.0.0/0。
sourcePorts[]

string

外部访问规则适用的源端口列表。此字段仅适用于 UDP 或 TCP 协议。每个条目都必须是整数或范围。例如：["22"]、["80","443"] 或 ["12345-12349"]。如需匹配所有源端口，请指定 ["0-65535"]。
destinationIpRanges[]

object (IpRange)

如果指定了目标范围，则外部访问规则仅适用于目标 IP 地址位于这些范围内的流量。指定的 IP 地址必须在父级网络政策的范围内预留外部 IP 地址。如需匹配父级网络政策范围内的所有外部 IP 地址，请指定 0.0.0.0/0。如需匹配特定的外部 IP 地址，请使用 IpRange.external_address 属性指定该地址。
destinationPorts[]

string

外部访问规则适用的目标端口列表。此字段仅适用于 UDP 或 TCP 协议。每个条目都必须是整数或范围。例如：["22"]、["80","443"] 或 ["12345-12349"]。如需匹配所有目标端口，请指定 ["0-65535"]。
state

enum (State)

仅限输出。资源的状态。
uid

string

仅限输出。系统为资源生成的唯一标识符。

操作

操作用于确定外部访问规则是允许还是禁止流量，具体取决于规则的其他组件是否与流量匹配。

枚举
ACTION_UNSPECIFIED 默认值为 allow。
ALLOW 允许与其他指定组件匹配的连接。
DENY 禁止与其他指定组件匹配的连接。

IpRange

以任何一种支持的格式提供的 IP 范围。

JSON 表示法 
{

  // Union field ip_range can be only one of the following:
  "ipAddress": string,
  "ipAddressRange": string,
  "externalAddress": string
  // End of list of possible types for union field ip_range.
}
字段

联合字段 ip_range。

ip_range 只能是下列其中一项：
ipAddress

string

单个 IP 地址。例如：10.0.0.5。
ipAddressRange

string

采用 CIDR 格式的 IP 地址范围。例如：10.0.0.0/24。
externalAddress

string

ExternalAddress 资源的名称。外部地址必须已在此外部访问规则的父级网络政策的范围内预留。以 projects/{project}/locations/{location}/privateClouds/{privateCloud}/externalAddresses/{externalAddress} 的形式提供外部地址名称。例如：projects/my-project/locations/us-central1-a/privateClouds/my-cloud/externalAddresses/my-address。

州

定义外部访问防火墙规则的可能状态。

枚举
STATE_UNSPECIFIED 默认值。如果省略状态，则使用此值。
ACTIVE 规则已准备就绪。
CREATING 正在创建规则。
UPDATING 正在更新规则。
DELETING 正在删除规则。

方法

create

 在给定的网络政策中创建新的外部访问规则。

delete

 删除单个外部访问规则。

get

 获取单个外部访问规则的详细信息。

list

 列出指定网络政策中的 ExternalAccessRule 资源。

patch

 更新单个外部访问规则的参数。