app_connections

Creates, updates, deletes, gets or lists an app_connections resource.

Overview

Name	app_connections
Type	Resource
Id	google.beyondcorp.app_connections

Fields

The following fields are returned by SELECT queries:

projects_locations_app_connections_get

Name	Datatype	Description
name	string	Required. Unique resource name of the AppConnection. The name is ignored when creating a AppConnection.
applicationEndpoint	object	Required. Address of the remote application endpoint for the BeyondCorp AppConnection. (id: GoogleCloudBeyondcorpAppconnectionsV1AppConnectionApplicationEndpoint)
connectors	array	Optional. List of [google.cloud.beyondcorp.v1main.Connector.name] that are authorized to be associated with this AppConnection.
createTime	string (google-datetime)	Output only. Timestamp when the resource was created.
displayName	string	Optional. An arbitrary user-provided name for the AppConnection. Cannot exceed 64 characters.
gateway	object	Optional. Gateway used by the AppConnection. (id: GoogleCloudBeyondcorpAppconnectionsV1AppConnectionGateway)
labels	object	Optional. Resource labels to represent user provided metadata.
satisfiesPzi	boolean	Output only. Reserved for future use.
satisfiesPzs	boolean	Output only. Reserved for future use.
state	string	Output only. The current state of the AppConnection. (STATE_UNSPECIFIED, CREATING, CREATED, UPDATING, DELETING, DOWN)
type	string	Required. The type of network connectivity used by the AppConnection. (TYPE_UNSPECIFIED, TCP_PROXY)
uid	string	Output only. A unique identifier for the instance generated by the system.
updateTime	string (google-datetime)	Output only. Timestamp when the resource was last modified.

projects_locations_app_connections_list

Name	Datatype	Description
name	string	Required. Unique resource name of the AppConnection. The name is ignored when creating a AppConnection.
applicationEndpoint	object	Required. Address of the remote application endpoint for the BeyondCorp AppConnection. (id: GoogleCloudBeyondcorpAppconnectionsV1AppConnectionApplicationEndpoint)
connectors	array	Optional. List of [google.cloud.beyondcorp.v1main.Connector.name] that are authorized to be associated with this AppConnection.
createTime	string (google-datetime)	Output only. Timestamp when the resource was created.
displayName	string	Optional. An arbitrary user-provided name for the AppConnection. Cannot exceed 64 characters.
gateway	object	Optional. Gateway used by the AppConnection. (id: GoogleCloudBeyondcorpAppconnectionsV1AppConnectionGateway)
labels	object	Optional. Resource labels to represent user provided metadata.
satisfiesPzi	boolean	Output only. Reserved for future use.
satisfiesPzs	boolean	Output only. Reserved for future use.
state	string	Output only. The current state of the AppConnection. (STATE_UNSPECIFIED, CREATING, CREATED, UPDATING, DELETING, DOWN)
type	string	Required. The type of network connectivity used by the AppConnection. (TYPE_UNSPECIFIED, TCP_PROXY)
uid	string	Output only. A unique identifier for the instance generated by the system.
updateTime	string (google-datetime)	Output only. Timestamp when the resource was last modified.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
projects_locations_app_connections_get	select	projectsId, locationsId, appConnectionsId		Gets details of a single AppConnection.
projects_locations_app_connections_list	select	projectsId, locationsId	pageToken, pageSize, filter, orderBy	Lists AppConnections in a given project and location.
projects_locations_app_connections_create	insert	projectsId, locationsId	requestId, appConnectionId, validateOnly	Creates a new AppConnection in a given project and location.
projects_locations_app_connections_patch	update	projectsId, locationsId, appConnectionsId	requestId, allowMissing, updateMask, validateOnly	Updates the parameters of a single AppConnection.
projects_locations_app_connections_delete	delete	projectsId, locationsId, appConnectionsId	validateOnly, requestId	Deletes a single AppConnection.
projects_locations_app_connections_resolve	exec	projectsId, locationsId	pageToken, pageSize, appConnectorId	Resolves AppConnections details for a given AppConnector. An internal method called by a connector to find AppConnections to connect to.

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
appConnectionsId	string
locationsId	string
projectsId	string
allowMissing	boolean
appConnectionId	string
appConnectorId	string
filter	string
orderBy	string
pageSize	integer (int32)
pageToken	string
requestId	string
updateMask	string (google-fieldmask)
validateOnly	boolean

SELECT examples

projects_locations_app_connections_get

Gets details of a single AppConnection.

SELECT
name,
applicationEndpoint,
connectors,
createTime,
displayName,
gateway,
labels,
satisfiesPzi,
satisfiesPzs,
state,
type,
uid,
updateTime
FROM google.beyondcorp.app_connections
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND appConnectionsId = '{{ appConnectionsId }}' -- required
;

projects_locations_app_connections_list

Lists AppConnections in a given project and location.

SELECT
name,
applicationEndpoint,
connectors,
createTime,
displayName,
gateway,
labels,
satisfiesPzi,
satisfiesPzs,
state,
type,
uid,
updateTime
FROM google.beyondcorp.app_connections
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND pageToken = '{{ pageToken }}'
AND pageSize = '{{ pageSize }}'
AND filter = '{{ filter }}'
AND orderBy = '{{ orderBy }}'
;

INSERT examples

projects_locations_app_connections_create

Creates a new AppConnection in a given project and location.

INSERT INTO google.beyondcorp.app_connections (
data__connectors,
data__applicationEndpoint,
data__type,
data__labels,
data__name,
data__displayName,
data__gateway,
projectsId,
locationsId,
requestId,
appConnectionId,
validateOnly
)
SELECT 
'{{ connectors }}',
'{{ applicationEndpoint }}',
'{{ type }}',
'{{ labels }}',
'{{ name }}',
'{{ displayName }}',
'{{ gateway }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ requestId }}',
'{{ appConnectionId }}',
'{{ validateOnly }}'
RETURNING
name,
done,
error,
metadata,
response
;

Manifest

# Description fields are for documentation purposes
- name: app_connections
props:
  - name: projectsId
    value: "{{ projectsId }}"
    description: Required parameter for the app_connections resource.
  - name: locationsId
    value: "{{ locationsId }}"
    description: Required parameter for the app_connections resource.
  - name: connectors
    value:
      - "{{ connectors }}"
    description: |
      Optional. List of [google.cloud.beyondcorp.v1main.Connector.name] that are authorized to be associated with this AppConnection.
  - name: applicationEndpoint
    description: |
      Required. Address of the remote application endpoint for the BeyondCorp AppConnection.
    value:
      host: "{{ host }}"
      port: {{ port }}
  - name: type
    value: "{{ type }}"
    description: |
      Required. The type of network connectivity used by the AppConnection.
    valid_values: ['TYPE_UNSPECIFIED', 'TCP_PROXY']
  - name: labels
    value: "{{ labels }}"
    description: |
      Optional. Resource labels to represent user provided metadata.
  - name: name
    value: "{{ name }}"
    description: |
      Required. Unique resource name of the AppConnection. The name is ignored when creating a AppConnection.
  - name: displayName
    value: "{{ displayName }}"
    description: |
      Optional. An arbitrary user-provided name for the AppConnection. Cannot exceed 64 characters.
  - name: gateway
    description: |
      Optional. Gateway used by the AppConnection.
    value:
      l7psc: "{{ l7psc }}"
      ingressPort: {{ ingressPort }}
      appGateway: "{{ appGateway }}"
      uri: "{{ uri }}"
      type: "{{ type }}"
  - name: requestId
    value: "{{ requestId }}"
  - name: appConnectionId
    value: "{{ appConnectionId }}"
  - name: validateOnly
    value: {{ validateOnly }}

UPDATE examples

projects_locations_app_connections_patch

Updates the parameters of a single AppConnection.

UPDATE google.beyondcorp.app_connections
SET 
data__connectors = '{{ connectors }}',
data__applicationEndpoint = '{{ applicationEndpoint }}',
data__type = '{{ type }}',
data__labels = '{{ labels }}',
data__name = '{{ name }}',
data__displayName = '{{ displayName }}',
data__gateway = '{{ gateway }}'
WHERE 
projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND appConnectionsId = '{{ appConnectionsId }}' --required
AND requestId = '{{ requestId}}'
AND allowMissing = {{ allowMissing}}
AND updateMask = '{{ updateMask}}'
AND validateOnly = {{ validateOnly}}
RETURNING
name,
done,
error,
metadata,
response;

DELETE examples

projects_locations_app_connections_delete

Deletes a single AppConnection.

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

Lifecycle Methods

projects_locations_app_connections_resolve

Resolves AppConnections details for a given AppConnector. An internal method called by a connector to find AppConnections to connect to.

EXEC google.beyondcorp.app_connections.projects_locations_app_connections_resolve 
@projectsId='{{ projectsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@pageToken='{{ pageToken }}', 
@pageSize='{{ pageSize }}', 
@appConnectorId='{{ appConnectorId }}'
;