Skip to main content

firewall_endpoints

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

Overview

Namefirewall_endpoints
TypeResource
Idgoogle.networksecurity.firewall_endpoints

Fields

NameDatatypeDescription
namestringImmutable. Identifier. name of resource
descriptionstringOptional. Description of the firewall endpoint. Max length 2048 characters.
associatedNetworksarrayOutput only. List of networks that are associated with this endpoint in the local zone. This is a projection of the FirewallEndpointAssociations pointing at this endpoint. A network will only appear in this list after traffic routing is fully configured. Format: projects/{project}/global/networks/{name}.
associationsarrayOutput only. List of FirewallEndpointAssociations that are associated to this endpoint. An association will only appear in this list after traffic routing is fully configured.
billingProjectIdstringRequired. Project to bill on endpoint uptime usage.
createTimestringOutput only. Create time stamp
labelsobjectOptional. Labels as key value pairs
reconcilingbooleanOutput only. Whether reconciling is in progress, recommended per https://google.aip.dev/128.
statestringOutput only. Current state of the endpoint.
updateTimestringOutput only. Update time stamp

Methods

NameAccessible byRequired ParamsDescription
organizations_locations_firewall_endpoints_getSELECTfirewallEndpointsId, locationsId, organizationsIdGets details of a single Endpoint.
organizations_locations_firewall_endpoints_listSELECTlocationsId, organizationsIdLists FirewallEndpoints in a given project and location.
organizations_locations_firewall_endpoints_createINSERTlocationsId, organizationsIdCreates a new FirewallEndpoint in a given project and location.
organizations_locations_firewall_endpoints_deleteDELETEfirewallEndpointsId, locationsId, organizationsIdDeletes a single Endpoint.
organizations_locations_firewall_endpoints_patchUPDATEfirewallEndpointsId, locationsId, organizationsIdUpdate a single Endpoint.

SELECT examples

Lists FirewallEndpoints in a given project and location.

SELECT
name,
description,
associatedNetworks,
associations,
billingProjectId,
createTime,
labels,
reconciling,
state,
updateTime
FROM google.networksecurity.firewall_endpoints
WHERE locationsId = '{{ locationsId }}'
AND organizationsId = '{{ organizationsId }}';

INSERT example

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

/*+ create */
INSERT INTO google.networksecurity.firewall_endpoints (
locationsId,
organizationsId,
name,
description,
labels,
billingProjectId
)
SELECT
'{{ locationsId }}',
'{{ organizationsId }}',
'{{ name }}',
'{{ description }}',
'{{ labels }}',
'{{ billingProjectId }}'
;

UPDATE example

Updates a firewall_endpoints resource.

/*+ update */
UPDATE google.networksecurity.firewall_endpoints
SET
name = '{{ name }}',
description = '{{ description }}',
labels = '{{ labels }}',
billingProjectId = '{{ billingProjectId }}'
WHERE
firewallEndpointsId = '{{ firewallEndpointsId }}'
AND locationsId = '{{ locationsId }}'
AND organizationsId = '{{ organizationsId }}';

DELETE example

Deletes the specified firewall_endpoints resource.

/*+ delete */
DELETE FROM google.networksecurity.firewall_endpoints
WHERE firewallEndpointsId = '{{ firewallEndpointsId }}'
AND locationsId = '{{ locationsId }}'
AND organizationsId = '{{ organizationsId }}';