security_gateways

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

Overview

Name	security_gateways
Type	Resource
Id	google.beyondcorp.security_gateways

Fields

The following fields are returned by SELECT queries:

projects_locations_security_gateways_get

Name	Datatype	Description
name	string	Identifier. Name of the resource.
createTime	string (google-datetime)	Output only. Timestamp when the resource was created.
delegatingServiceAccount	string	Output only. Service account used for operations that involve resources in consumer projects.
displayName	string	Optional. An arbitrary user-provided name for the SecurityGateway. Cannot exceed 64 characters.
externalIps	array	Output only. IP addresses that will be used for establishing connection to the endpoints.
hubs	object	Optional. Map of Hubs that represents regional data path deployment with GCP region as a key.
logging	object	Optional. Configuration for Cloud Logging. If this field is present, the logging will be enabled. (id: GoogleCloudBeyondcorpSecuritygatewaysV1LoggingConfig)
proxyProtocolConfig	object	Optional. Shared proxy configuration for all apps. (id: GoogleCloudBeyondcorpSecuritygatewaysV1ProxyProtocolConfig)
serviceDiscovery	object	Optional. Settings related to the Service Discovery. (id: GoogleCloudBeyondcorpSecuritygatewaysV1ServiceDiscovery)
state	string	Output only. The operational state of the SecurityGateway. (STATE_UNSPECIFIED, CREATING, UPDATING, DELETING, RUNNING, DOWN, ERROR)
updateTime	string (google-datetime)	Output only. Timestamp when the resource was last modified.

projects_locations_security_gateways_list

Name	Datatype	Description

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
projects_locations_security_gateways_get	select	projectsId, locationsId, securityGatewaysId		Gets details of a single SecurityGateway.
projects_locations_security_gateways_list	select	projectsId, locationsId	pageToken, orderBy, pageSize, filter	Lists SecurityGateways in a given project and location.
projects_locations_security_gateways_create	insert	projectsId, locationsId	requestId, securityGatewayId	Creates a new Security Gateway in a given project and location.
projects_locations_security_gateways_patch	update	projectsId, locationsId, securityGatewaysId	requestId, updateMask	Updates the parameters of a single SecurityGateway.
projects_locations_security_gateways_delete	delete	projectsId, locationsId, securityGatewaysId	requestId, validateOnly	Deletes a single SecurityGateway.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
locationsId	string
projectsId	string
securityGatewaysId	string
filter	string
orderBy	string
pageSize	integer (int32)
pageToken	string
requestId	string
securityGatewayId	string
updateMask	string (google-fieldmask)
validateOnly	boolean

SELECT examples

projects_locations_security_gateways_get

Gets details of a single SecurityGateway.

SELECT
name,
createTime,
delegatingServiceAccount,
displayName,
externalIps,
hubs,
logging,
proxyProtocolConfig,
serviceDiscovery,
state,
updateTime
FROM google.beyondcorp.security_gateways
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND securityGatewaysId = '{{ securityGatewaysId }}' -- required
;

projects_locations_security_gateways_list

Lists SecurityGateways in a given project and location.

SELECT
*
FROM google.beyondcorp.security_gateways
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND pageToken = '{{ pageToken }}'
AND orderBy = '{{ orderBy }}'
AND pageSize = '{{ pageSize }}'
AND filter = '{{ filter }}'
;

INSERT examples

projects_locations_security_gateways_create

Creates a new Security Gateway in a given project and location.

INSERT INTO google.beyondcorp.security_gateways (
data__hubs,
data__displayName,
data__name,
data__logging,
data__proxyProtocolConfig,
data__serviceDiscovery,
projectsId,
locationsId,
requestId,
securityGatewayId
)
SELECT 
'{{ hubs }}',
'{{ displayName }}',
'{{ name }}',
'{{ logging }}',
'{{ proxyProtocolConfig }}',
'{{ serviceDiscovery }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ requestId }}',
'{{ securityGatewayId }}'
RETURNING
name,
done,
error,
metadata,
response
;

Manifest

# Description fields are for documentation purposes
- name: security_gateways
props:
  - name: projectsId
    value: "{{ projectsId }}"
    description: Required parameter for the security_gateways resource.
  - name: locationsId
    value: "{{ locationsId }}"
    description: Required parameter for the security_gateways resource.
  - name: hubs
    value: "{{ hubs }}"
    description: |
      Optional. Map of Hubs that represents regional data path deployment with GCP region as a key.
  - name: displayName
    value: "{{ displayName }}"
    description: |
      Optional. An arbitrary user-provided name for the SecurityGateway. Cannot exceed 64 characters.
  - name: name
    value: "{{ name }}"
    description: |
      Identifier. Name of the resource.
  - name: logging
    value: "{{ logging }}"
    description: |
      Optional. Configuration for Cloud Logging. If this field is present, the logging will be enabled.
  - name: proxyProtocolConfig
    description: |
      Optional. Shared proxy configuration for all apps.
    value:
      gatewayIdentity: "{{ gatewayIdentity }}"
      contextualHeaders:
        userInfo:
          outputType: "{{ outputType }}"
        deviceInfo:
          outputType: "{{ outputType }}"
        outputType: "{{ outputType }}"
        groupInfo:
          outputType: "{{ outputType }}"
      clientIp: {{ clientIp }}
      allowedClientHeaders:
        - "{{ allowedClientHeaders }}"
      metadataHeaders: "{{ metadataHeaders }}"
  - name: serviceDiscovery
    description: |
      Optional. Settings related to the Service Discovery.
    value:
      apiGateway:
        resourceOverride:
          path: "{{ path }}"
  - name: requestId
    value: "{{ requestId }}"
  - name: securityGatewayId
    value: "{{ securityGatewayId }}"

UPDATE examples

projects_locations_security_gateways_patch

Updates the parameters of a single SecurityGateway.

UPDATE google.beyondcorp.security_gateways
SET 
data__hubs = '{{ hubs }}',
data__displayName = '{{ displayName }}',
data__name = '{{ name }}',
data__logging = '{{ logging }}',
data__proxyProtocolConfig = '{{ proxyProtocolConfig }}',
data__serviceDiscovery = '{{ serviceDiscovery }}'
WHERE 
projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND securityGatewaysId = '{{ securityGatewaysId }}' --required
AND requestId = '{{ requestId}}'
AND updateMask = '{{ updateMask}}'
RETURNING
name,
done,
error,
metadata,
response;

DELETE examples

projects_locations_security_gateways_delete

Deletes a single SecurityGateway.

DELETE FROM google.beyondcorp.security_gateways
WHERE projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND securityGatewaysId = '{{ securityGatewaysId }}' --required
AND requestId = '{{ requestId }}'
AND validateOnly = '{{ validateOnly }}'
;