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

# POST /v1/{+parent}/regionalEndpoints

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

Creates a new RegionalEndpoint in a given project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `regionalEndpointId` string
- `requestId` string

## Request body

- RegionalEndpoint — The RegionalEndpoint resource.
  - `address` string — Optional. 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}` for an IPv4 or IPv6 address.
  - `network` string — Optional. The name of the VPC network for this private regional endpoint. Format: `projects/{project}/global/networks/{network}`
  - `name` string — Output only. The name of a RegionalEndpoint. Pattern: `projects/{project}/locations/{location}/regionalEndpoints/^[-a-z0-9](?:[-a-z0-9]{0,44})[a-z0-9]$`.
  - `accessType` 'ACCESS_TYPE_UNSPECIFIED' | 'GLOBAL' | 'REGIONAL' — Required. The access type of this regional endpoint. This field is reflected in the PSC Forwarding Rule configuration to enable global access.
  - `labels` object — User-defined labels.
  - `targetGoogleApi` string — Required. The service endpoint this private regional endpoint connects to. Format: `{apiname}.{region}.p.rep.googleapis.com` Example: "cloudkms.us-central1.p.rep.googleapis.com".
  - `subnetwork` string — Optional. The name of the subnetwork from which the IP address will be allocated. Format: `projects/{project}/regions/{region}/subnetworks/{subnetwork}`
  - `pscForwardingRule` string — Output 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}`
  - `ipAddress` string — Output only. The literal IP address of the PSC Forwarding Rule created on behalf of the customer. This field is deprecated. Use address instead.
  - `updateTime` string, google-datetime — Output only. Time when the RegionalEndpoint was updated.
  - `createTime` string, google-datetime — Output only. Time when the RegionalEndpoint was created.
  - `description` string — Optional. A description of this resource.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/networkconnectivity.md) · [All operations](https://skmtc.net/google/apis/networkconnectivity/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/networkconnectivity/versions/778637dee420/schema)