Skip to main content

ingress_rules

Creates, updates, deletes, gets or lists a ingress_rules resource.

Overview

Nameingress_rules
TypeResource
Idgoogle.appengine.ingress_rules

Fields

NameDatatypeDescription
descriptionstringAn optional string description of this rule. This field has a maximum length of 400 characters.
actionstringThe action to take on matched requests.
priorityintegerA positive integer between 1, Int32.MaxValue-1 that defines the order of rule evaluation. Rules with the lowest priority are evaluated first.A default rule at priority Int32.MaxValue matches all IPv4 and IPv6 traffic when no previous rule matches. Only the action of this rule can be modified by the user.
sourceRangestringIP address or range, defined using CIDR notation, of requests that this rule applies to. You can use the wildcard character "*" to match all IPs equivalent to "0/0" and "::/0" together. Examples: 192.168.1.1 or 192.168.0.0/16 or 2001:db8::/32 or 2001:0db8:0000:0042:0000:8a2e:0370:7334. Truncation will be silently performed on addresses which are not properly truncated. For example, 1.2.3.4/24 is accepted as the same address as 1.2.3.0/24. Similarly, for IPv6, 2001:db8::1/32 is accepted as the same address as 2001:db8::/32.

Methods

NameAccessible byRequired ParamsDescription
getSELECTappsId, ingressRulesIdGets the specified firewall rule.
listSELECTappsIdLists the firewall rules of an application.
createINSERTappsIdCreates a firewall rule for the application.
deleteDELETEappsId, ingressRulesIdDeletes the specified firewall rule.
batch_updateUPDATEappsIdReplaces the entire firewall ruleset in one bulk operation. This overrides and replaces the rules of an existing firewall with the new rules.If the final rule does not match traffic with the '*' wildcard IP range, then an "allow all" rule is explicitly added to the end of the list.
patchUPDATEappsId, ingressRulesIdUpdates the specified firewall rule.

SELECT examples

Lists the firewall rules of an application.

SELECT
description,
action,
priority,
sourceRange
FROM google.appengine.ingress_rules
WHERE appsId = '{{ appsId }}';

INSERT example

Use the following StackQL query and manifest file to create a new ingress_rules resource.

/*+ create */
INSERT INTO google.appengine.ingress_rules (
appsId,
priority,
action,
sourceRange,
description
)
SELECT
'{{ appsId }}',
'{{ priority }}',
'{{ action }}',
'{{ sourceRange }}',
'{{ description }}'
;

UPDATE example

Updates a ingress_rules resource.

/*+ update */
UPDATE google.appengine.ingress_rules
SET
ingressRules = '{{ ingressRules }}'
WHERE
appsId = '{{ appsId }}';

DELETE example

Deletes the specified ingress_rules resource.

/*+ delete */
DELETE FROM google.appengine.ingress_rules
WHERE appsId = '{{ appsId }}'
AND ingressRulesId = '{{ ingressRulesId }}';