Skip to main content

private_connections

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

Overview

Nameprivate_connections
TypeResource
Idgoogle.vmwareengine.private_connections

Fields

NameDatatypeDescription
namestringOutput only. The resource name of the private connection. Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: projects/my-project/locations/us-central1/privateConnections/my-connection
descriptionstringOptional. User-provided description for this private connection.
createTimestringOutput only. Creation time of this resource.
peeringIdstringOutput only. VPC network peering id between given network VPC and VMwareEngineNetwork.
peeringStatestringOutput only. Peering state between service network and VMware Engine network.
routingModestringOptional. Routing Mode. Default value is set to GLOBAL. For type = PRIVATE_SERVICE_ACCESS, this field can be set to GLOBAL or REGIONAL, for other types only GLOBAL is supported.
serviceNetworkstringRequired. Service network to create private connection. Specify the name in the following form: projects/{project}/global/networks/{network_id} For type = PRIVATE_SERVICE_ACCESS, this field represents servicenetworking VPC, e.g. projects/project-tp/global/networks/servicenetworking. For type = NETAPP_CLOUD_VOLUME, this field represents NetApp service VPC, e.g. projects/project-tp/global/networks/netapp-tenant-vpc. For type = DELL_POWERSCALE, this field represent Dell service VPC, e.g. projects/project-tp/global/networks/dell-tenant-vpc. For type= THIRD_PARTY_SERVICE, this field could represent a consumer VPC or any other producer VPC to which the VMware Engine Network needs to be connected, e.g. projects/project/global/networks/vpc.
statestringOutput only. State of the private connection.
typestringRequired. Private connection type.
uidstringOutput only. System-generated unique identifier for the resource.
updateTimestringOutput only. Last update time of this resource.
vmwareEngineNetworkstringRequired. The relative resource name of Legacy VMware Engine network. Specify the name in the following form: projects/{project}/locations/{location}/vmwareEngineNetworks/{vmware_engine_network_id} where {project}, {location} will be same as specified in private connection resource name and {vmware_engine_network_id} will be in the form of {location}-default e.g. projects/project/locations/us-central1/vmwareEngineNetworks/us-central1-default.
vmwareEngineNetworkCanonicalstringOutput only. The canonical name of the VMware Engine network in the form: projects/{project_number}/locations/{location}/vmwareEngineNetworks/{vmware_engine_network_id}

Methods

NameAccessible byRequired ParamsDescription
getSELECTlocationsId, privateConnectionsId, projectsIdRetrieves a PrivateConnection resource by its resource name. The resource contains details of the private connection, such as connected network, routing mode and state.
listSELECTlocationsId, projectsIdLists PrivateConnection resources in a given project and location.
createINSERTlocationsId, projectsIdCreates a new private connection that can be used for accessing private Clouds.
deleteDELETElocationsId, privateConnectionsId, projectsIdDeletes a PrivateConnection resource. When a private connection is deleted for a VMware Engine network, the connected network becomes inaccessible to that VMware Engine network.
patchUPDATElocationsId, privateConnectionsId, projectsIdModifies a PrivateConnection resource. Only description and routing_mode fields can be updated. Only fields specified in updateMask are applied.

SELECT examples

Lists PrivateConnection resources in a given project and location.

SELECT
name,
description,
createTime,
peeringId,
peeringState,
routingMode,
serviceNetwork,
state,
type,
uid,
updateTime,
vmwareEngineNetwork,
vmwareEngineNetworkCanonical
FROM google.vmwareengine.private_connections
WHERE locationsId = '{{ locationsId }}'
AND projectsId = '{{ projectsId }}';

INSERT example

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

/*+ create */
INSERT INTO google.vmwareengine.private_connections (
locationsId,
projectsId,
description,
vmwareEngineNetwork,
type,
routingMode,
serviceNetwork
)
SELECT
'{{ locationsId }}',
'{{ projectsId }}',
'{{ description }}',
'{{ vmwareEngineNetwork }}',
'{{ type }}',
'{{ routingMode }}',
'{{ serviceNetwork }}'
;

UPDATE example

Updates a private_connections resource.

/*+ update */
UPDATE google.vmwareengine.private_connections
SET
description = '{{ description }}',
vmwareEngineNetwork = '{{ vmwareEngineNetwork }}',
type = '{{ type }}',
routingMode = '{{ routingMode }}',
serviceNetwork = '{{ serviceNetwork }}'
WHERE
locationsId = '{{ locationsId }}'
AND privateConnectionsId = '{{ privateConnectionsId }}'
AND projectsId = '{{ projectsId }}';

DELETE example

Deletes the specified private_connections resource.

/*+ delete */
DELETE FROM google.vmwareengine.private_connections
WHERE locationsId = '{{ locationsId }}'
AND privateConnectionsId = '{{ privateConnectionsId }}'
AND projectsId = '{{ projectsId }}';