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

# POST /v1/{+parent}/externalAddresses

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

Creates a new `ExternalAddress` resource in a given private cloud. The network policy that corresponds to the private cloud must have the external IP address network service enabled (`NetworkPolicy.external_ip`).

## Path parameters

- `parent` string, required

## Query parameters

- `externalAddressId` string
- `requestId` string
- `validateOnly` boolean

## Request body

- ExternalAddress — Represents an allocated external IP address and its corresponding internal IP address in a private cloud.
  - `name` string — Output only. Identifier. The resource name of this external IP address. 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-a/privateClouds/my-cloud/externalAddresses/my-address`
  - `uid` string — Output only. System-generated unique identifier for the resource.
  - `internalIp` string — The internal IP address of a workload VM.
  - `externalIp` string — Output only. The external IP address of a workload VM.
  - `state` 'STATE_UNSPECIFIED' | 'ACTIVE' | 'CREATING' | 'UPDATING' | 'DELETING' — Output only. The state of the resource.
  - `description` string — User-provided description for this resource.
  - `createTime` string, google-datetime — Output only. Creation time of this resource.
  - `updateTime` string, google-datetime — Output only. Last update time of this resource.

## 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)