ingress_rules
Creates, updates, deletes, gets or lists a ingress_rules
resource.
Overview
Name | ingress_rules |
Type | Resource |
Id | google.appengine.ingress_rules |
Fields
Name | Datatype | Description |
---|---|---|
description | string | An optional string description of this rule. This field has a maximum length of 400 characters. |
action | string | The action to take on matched requests. |
priority | integer | A 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. |
sourceRange | string | IP 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
Name | Accessible by | Required Params | Description |
---|---|---|---|
get | SELECT | appsId, ingressRulesId | Gets the specified firewall rule. |
list | SELECT | appsId | Lists the firewall rules of an application. |
create | INSERT | appsId | Creates a firewall rule for the application. |
delete | DELETE | appsId, ingressRulesId | Deletes the specified firewall rule. |
batch_update | UPDATE | appsId | Replaces 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. |
patch | UPDATE | appsId, ingressRulesId | Updates 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.
- All Properties
- Manifest
/*+ create */
INSERT INTO google.appengine.ingress_rules (
appsId,
priority,
action,
sourceRange,
description
)
SELECT
'{{ appsId }}',
'{{ priority }}',
'{{ action }}',
'{{ sourceRange }}',
'{{ description }}'
;
- name: your_resource_model_name
props:
- name: priority
value: integer
- name: action
value: string
- name: sourceRange
value: string
- name: description
value: string
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 }}';