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

# POST /v1/{+parent}/networkPeerings

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

Creates a new network peering between the peer network and VMware Engine network provided in a `NetworkPeering` resource. NetworkPeering is a global resource and location can only be global.

## Path parameters

- `parent` string, required

## Query parameters

- `networkPeeringId` string
- `requestId` string
- `validateOnly` boolean

## Request body

- NetworkPeering — Details of a network peering.
  - `createTime` string, google-datetime — Output only. Creation time of this resource.
  - `exportCustomRoutesWithPublicIp` boolean — Optional. True if all subnet routes with a public IP address range are exported; false otherwise. The default value is true. IPv4 special-use ranges (https://en.wikipedia.org/wiki/IPv4#Special_addresses) are always exported to peers and are not controlled by this field.
  - `peerNetwork` string — Required. The relative resource name of the network to peer with a standard VMware Engine network. The provided network can be a consumer VPC network or another standard VMware Engine network. If the `peer_network_type` is VMWARE_ENGINE_NETWORK, specify the name in the form: `projects/{project}/locations/global/vmwareEngineNetworks/{vmware_engine_network_id}`. Otherwise specify the name in the form: `projects/{project}/global/networks/{network_id}`, where `{project}` can either be a project number or a project ID.
  - `peerMtu` integer — Optional. Maximum transmission unit (MTU) in bytes. The default value is `1500`. If a value of `0` is provided for this field, VMware Engine uses the default value instead.
  - `exchangeSubnetRoutes` boolean — Optional. True if full mesh connectivity is created and managed automatically between peered networks; false otherwise. Currently this field is always true because Google Compute Engine automatically creates and manages subnetwork routes between two VPC networks when peering state is 'ACTIVE'.
  - `importCustomRoutesWithPublicIp` boolean — Optional. True if all subnet routes with public IP address range are imported; false otherwise. The default value is true. IPv4 special-use ranges (https://en.wikipedia.org/wiki/IPv4#Special_addresses) are always imported to peers and are not controlled by this field.
  - `stateDetails` string — Output only. Output Only. Details about the current state of the network peering.
  - `importCustomRoutes` boolean — Optional. True if custom routes are imported from the peered network; false otherwise. The default value is true.
  - `name` string — Output only. Identifier. The resource name of the network peering. NetworkPeering is a global resource and location can only be global. Resource names are scheme-less URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names. For example: `projects/my-project/locations/global/networkPeerings/my-peering`
  - `exportCustomRoutes` boolean — Optional. True if custom routes are exported to the peered network; false otherwise. The default value is true.
  - `vmwareEngineNetwork` string — Required. The relative resource name of the VMware Engine network. Specify the name in the following form: `projects/{project}/locations/{location}/vmwareEngineNetworks/{vmware_engine_network_id}` where `{project}` can either be a project number or a project ID.
  - `uid` string — Output only. System-generated unique identifier for the resource.
  - `updateTime` string, google-datetime — Output only. Last update time of this resource.
  - `state` 'STATE_UNSPECIFIED' | 'INACTIVE' | 'ACTIVE' | 'CREATING' | 'DELETING' — Output only. State of the network peering. This field has a value of 'ACTIVE' when there's a matching configuration in the peer network. New values may be added to this enum when appropriate.
  - `description` string — Optional. User-provided description for this network peering.
  - `peerNetworkType` 'PEER_NETWORK_TYPE_UNSPECIFIED' | 'STANDARD' | 'VMWARE_ENGINE_NETWORK' | 'PRIVATE_SERVICES_ACCESS' | 'NETAPP_CLOUD_VOLUMES' | 'THIRD_PARTY_SERVICE' | 'DELL_POWERSCALE' | 'GOOGLE_CLOUD_NETAPP_VOLUMES' | 'GOOGLE_CLOUD_FILESTORE_INSTANCES' — Required. The type of the network to peer with the 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)