Skip to main content

regional_endpoints

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

Overview

Nameregional_endpoints
TypeResource
Idgoogle.networkconnectivity.regional_endpoints

Fields

NameDatatypeDescription
namestringOutput only. The name of a RegionalEndpoint. Format: projects/{project}/locations/{location}/regionalEndpoints/{regional_endpoint}.
descriptionstringOptional. A description of this resource.
accessTypestringRequired. The access type of this regional endpoint. This field is reflected in the PSC Forwarding Rule configuration to enable global access.
addressstringOptional. The IP Address of the Regional Endpoint. When no address is provided, an IP from the subnetwork is allocated. Use one of the following formats: IPv4 address as in 10.0.0.1 Address resource URI as in projects/{project}/regions/{region}/addresses/{address_name}
createTimestringOutput only. Time when the RegionalEndpoint was created.
ipAddressstringOutput only. The literal IP address of the PSC Forwarding Rule created on behalf of the customer. This field is deprecated. Use address instead.
labelsobjectUser-defined labels.
networkstringThe name of the VPC network for this private regional endpoint. Format: projects/{project}/global/networks/{network}
pscForwardingRulestringOutput only. The resource reference of the PSC Forwarding Rule created on behalf of the customer. Format: //compute.googleapis.com/projects/{project}/regions/{region}/forwardingRules/{forwarding_rule_name}
subnetworkstringThe name of the subnetwork from which the IP address will be allocated. Format: projects/{project}/regions/{region}/subnetworks/{subnetwork}
targetGoogleApistringRequired. The service endpoint this private regional endpoint connects to. Format: {apiname}.{region}.p.rep.googleapis.com Example: "cloudkms.us-central1.p.rep.googleapis.com".
updateTimestringOutput only. Time when the RegionalEndpoint was updated.

Methods

NameAccessible byRequired ParamsDescription
getSELECTlocationsId, projectsId, regionalEndpointsIdGets details of a single RegionalEndpoint.
listSELECTlocationsId, projectsIdLists RegionalEndpoints in a given project and location.
createINSERTlocationsId, projectsIdCreates a new RegionalEndpoint in a given project and location.
deleteDELETElocationsId, projectsId, regionalEndpointsIdDeletes a single RegionalEndpoint.

SELECT examples

Lists RegionalEndpoints in a given project and location.

SELECT
name,
description,
accessType,
address,
createTime,
ipAddress,
labels,
network,
pscForwardingRule,
subnetwork,
targetGoogleApi,
updateTime
FROM google.networkconnectivity.regional_endpoints
WHERE locationsId = '{{ locationsId }}'
AND projectsId = '{{ projectsId }}';

INSERT example

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

/*+ create */
INSERT INTO google.networkconnectivity.regional_endpoints (
locationsId,
projectsId,
labels,
description,
targetGoogleApi,
network,
subnetwork,
accessType,
address
)
SELECT
'{{ locationsId }}',
'{{ projectsId }}',
'{{ labels }}',
'{{ description }}',
'{{ targetGoogleApi }}',
'{{ network }}',
'{{ subnetwork }}',
'{{ accessType }}',
'{{ address }}'
;

DELETE example

Deletes the specified regional_endpoints resource.

/*+ delete */
DELETE FROM google.networkconnectivity.regional_endpoints
WHERE locationsId = '{{ locationsId }}'
AND projectsId = '{{ projectsId }}'
AND regionalEndpointsId = '{{ regionalEndpointsId }}';