Resource: ExternalAccessRule
External access firewall rules for filtering incoming traffic destined to ExternalAddress
resources.
JSON representation |
---|
{ "name": string, "createTime": string, "updateTime": string, "description": string, "priority": integer, "action": enum ( |
Fields | |
---|---|
name |
Output only. The resource name of this external access rule. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: |
createTime |
Output only. Creation time of this resource. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
updateTime |
Output only. Last update time of this resource. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
description |
User-provided description for this external access rule. |
priority |
External access rule priority, which determines the external access rule to use when multiple rules apply. If multiple rules have the same priority, their ordering is non-deterministic. If specific ordering is required, assign unique priorities to enforce such ordering. The external access rule priority is an integer from 100 to 4096, both inclusive. Lower integers indicate higher precedence. For example, a rule with priority |
action |
The action that the external access rule performs. |
ipProtocol |
The IP protocol to which the external access rule applies. This value can be one of the following three protocol strings (not case-sensitive): |
sourceIpRanges[] |
If source ranges are specified, the external access rule applies only to traffic that has a source IP address in these ranges. These ranges can either be expressed in the CIDR format or as an IP address. As only inbound rules are supported, |
sourcePorts[] |
A list of source ports to which the external access rule applies. This field is only applicable for the UDP or TCP protocol. Each entry must be either an integer or a range. For example: |
destinationIpRanges[] |
If destination ranges are specified, the external access rule applies only to the traffic that has a destination IP address in these ranges. The specified IP addresses must have reserved external IP addresses in the scope of the parent network policy. To match all external IP addresses in the scope of the parent network policy, specify |
destinationPorts[] |
A list of destination ports to which the external access rule applies. This field is only applicable for the UDP or TCP protocol. Each entry must be either an integer or a range. For example: |
state |
Output only. The state of the resource. |
uid |
Output only. System-generated unique identifier for the resource. |
Action
Action determines whether the external access rule permits or blocks traffic, subject to the other components of the rule matching the traffic.
Enums | |
---|---|
ACTION_UNSPECIFIED |
Defaults to allow. |
ALLOW |
Allows connections that match the other specified components. |
DENY |
Blocks connections that match the other specified components. |
IpRange
An IP range provided in any one of the supported formats.
JSON representation |
---|
{ // Union field |
Fields | |
---|---|
Union field
|
|
ipAddress |
A single IP address. For example: |
ipAddressRange |
An IP address range in the CIDR format. For example: |
externalAddress |
The name of an |
State
Defines possible states of external access firewall rules.
Enums | |
---|---|
STATE_UNSPECIFIED |
The default value. This value is used if the state is omitted. |
ACTIVE |
The rule is ready. |
CREATING |
The rule is being created. |
UPDATING |
The rule is being updated. |
DELETING |
The rule is being deleted. |
Methods |
|
---|---|
|
Creates a new external access rule in a given network policy. |
|
Deletes a single external access rule. |
|
Gets details of a single external access rule. |
|
Lists ExternalAccessRule resources in the specified network policy. |
|
Updates the parameters of a single external access rule. |