---
title: "POST /v1/{+parent}/privateConnections"
method: POST
path: "/v1/{+parent}/privateConnections"
tags: ["projects"]
---

# POST /v1/{+parent}/privateConnections

`POST /v1/{+parent}/privateConnections`

Creates a new private connection that can be used for accessing private Clouds.

## Path parameters

- `parent` string, required

## Query parameters

- `privateConnectionId` string
- `requestId` string
- `validateOnly` boolean

## Request body

- PrivateConnection — Private connection resource that provides connectivity for VMware Engine private clouds.
  - `updateTime` string, google-datetime — Output only. Last update time of this resource.
  - `vmwareEngineNetworkCanonical` string — Output only. The canonical name of the VMware Engine network in the form: `projects/{project_number}/locations/{location}/vmwareEngineNetworks/{vmware_engine_network_id}`
  - `description` string — Optional. User-provided description for this private connection.
  - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'ACTIVE' | 'UPDATING' | 'DELETING' | 'UNPROVISIONED' | 'FAILED' — Output only. State of the private connection.
  - `vmwareEngineNetwork` string — Required. 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.
  - `type` 'TYPE_UNSPECIFIED' | 'PRIVATE_SERVICE_ACCESS' | 'NETAPP_CLOUD_VOLUMES' | 'DELL_POWERSCALE' | 'THIRD_PARTY_SERVICE' — Required. Private connection type.
  - `uid` string — Output only. System-generated unique identifier for the resource.
  - `routingMode` 'ROUTING_MODE_UNSPECIFIED' | 'GLOBAL' | 'REGIONAL' — Optional. 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.
  - `name` string — Output 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`
  - `peeringId` string — Output only. VPC network peering id between given network VPC and VMwareEngineNetwork.
  - `serviceNetwork` string — Required. 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.
  - `createTime` string, google-datetime — Output only. Creation time of this resource.
  - `peeringState` 'PEERING_STATE_UNSPECIFIED' | 'PEERING_ACTIVE' | 'PEERING_INACTIVE' — Output only. Peering state between service network and VMware Engine network.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/vmwareengine.md) · [All operations](https://skmtc.dev/google/apis/vmwareengine/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/vmwareengine/revisions/23816cc0f25a/schema)