Skip to main content

endpoints

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

Overview

Nameendpoints
TypeResource
Idgoogle.ids.endpoints

Fields

NameDatatypeDescription
namestringOutput only. The name of the endpoint.
descriptionstringUser-provided description of the endpoint
createTimestringOutput only. The create time timestamp.
endpointForwardingRulestringOutput only. The fully qualified URL of the endpoint's ILB Forwarding Rule.
endpointIpstringOutput only. The IP address of the IDS Endpoint's ILB.
labelsobjectThe labels of the endpoint.
networkstringRequired. The fully qualified URL of the network to which the IDS Endpoint is attached.
satisfiesPzibooleanOutput only. [Output Only] Reserved for future use.
satisfiesPzsbooleanOutput only. [Output Only] Reserved for future use.
severitystringRequired. Lowest threat severity that this endpoint will alert on.
statestringOutput only. Current state of the endpoint.
threatExceptionsarrayList of threat IDs to be excepted from generating alerts.
trafficLogsbooleanWhether the endpoint should report traffic logs in addition to threat logs.
updateTimestringOutput only. The update time timestamp.

Methods

NameAccessible byRequired ParamsDescription
getSELECTendpointsId, locationsId, projectsIdGets details of a single Endpoint.
listSELECTlocationsId, projectsIdLists Endpoints in a given project and location.
createINSERTlocationsId, projectsIdCreates a new Endpoint in a given project and location.
deleteDELETEendpointsId, locationsId, projectsIdDeletes a single Endpoint.
patchUPDATEendpointsId, locationsId, projectsIdUpdates the parameters of a single Endpoint.

SELECT examples

Lists Endpoints in a given project and location.

SELECT
name,
description,
createTime,
endpointForwardingRule,
endpointIp,
labels,
network,
satisfiesPzi,
satisfiesPzs,
severity,
state,
threatExceptions,
trafficLogs,
updateTime
FROM google.ids.endpoints
WHERE locationsId = '{{ locationsId }}'
AND projectsId = '{{ projectsId }}';

INSERT example

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

/*+ create */
INSERT INTO google.ids.endpoints (
locationsId,
projectsId,
labels,
network,
description,
severity,
threatExceptions,
trafficLogs
)
SELECT
'{{ locationsId }}',
'{{ projectsId }}',
'{{ labels }}',
'{{ network }}',
'{{ description }}',
'{{ severity }}',
'{{ threatExceptions }}',
{{ trafficLogs }}
;

UPDATE example

Updates a endpoints resource.

/*+ update */
UPDATE google.ids.endpoints
SET
labels = '{{ labels }}',
network = '{{ network }}',
description = '{{ description }}',
severity = '{{ severity }}',
threatExceptions = '{{ threatExceptions }}',
trafficLogs = true|false
WHERE
endpointsId = '{{ endpointsId }}'
AND locationsId = '{{ locationsId }}'
AND projectsId = '{{ projectsId }}';

DELETE example

Deletes the specified endpoints resource.

/*+ delete */
DELETE FROM google.ids.endpoints
WHERE endpointsId = '{{ endpointsId }}'
AND locationsId = '{{ locationsId }}'
AND projectsId = '{{ projectsId }}';