# REST Resource: projects.locations.privateClouds.externalAddresses

- [Resource: ExternalAddress](https://docs.cloud.google.com/vmware-engine/docs/public/reference/rest/v1/projects.locations.privateClouds.externalAddresses#ExternalAddress)
  - [JSON representation](https://docs.cloud.google.com/vmware-engine/docs/public/reference/rest/v1/projects.locations.privateClouds.externalAddresses#ExternalAddress.SCHEMA_REPRESENTATION)
- [State](https://docs.cloud.google.com/vmware-engine/docs/public/reference/rest/v1/projects.locations.privateClouds.externalAddresses#State)
- [Methods](https://docs.cloud.google.com/vmware-engine/docs/public/reference/rest/v1/projects.locations.privateClouds.externalAddresses#METHODS_SUMMARY)

## Resource: ExternalAddress

Represents an allocated external IP address and its corresponding internal IP address in a private cloud.

| JSON representation |
|---|
| ``` { "name": string, "createTime": string, "updateTime": string, "internalIp": string, "externalIp": string, "state": enum (`https://docs.cloud.google.com/vmware-engine/docs/public/reference/rest/v1/projects.locations.privateClouds.externalAddresses#State`), "uid": string, "description": string } ``` |

| Fields ||
|---|---|
| `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` |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. Creation time of this resource. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `updateTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. Last update time of this resource. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `internalIp` | `string` The internal IP address of a workload VM. |
| `externalIp` | `string` Output only. The external IP address of a workload VM. |
| `state` | ``enum (`https://docs.cloud.google.com/vmware-engine/docs/public/reference/rest/v1/projects.locations.privateClouds.externalAddresses#State`)`` Output only. The state of the resource. |
| `uid` | `string` Output only. System-generated unique identifier for the resource. |
| `description` | `string` User-provided description for this resource. |

## State

Enum State defines possible states of external addresses.

| Enums ||
|---|---|
| `STATE_UNSPECIFIED` | The default value. This value should never be used. |
| `ACTIVE` | The address is ready. |
| `CREATING` | The address is being created. |
| `UPDATING` | The address is being updated. |
| `DELETING` | The address is being deleted. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/vmware-engine/docs/public/reference/rest/v1/projects.locations.privateClouds.externalAddresses/create` | Creates a new `ExternalAddress` resource in a given private cloud. |
| ### `https://docs.cloud.google.com/vmware-engine/docs/public/reference/rest/v1/projects.locations.privateClouds.externalAddresses/delete` | Deletes a single external IP address. |
| ### `https://docs.cloud.google.com/vmware-engine/docs/public/reference/rest/v1/projects.locations.privateClouds.externalAddresses/get` | Gets details of a single external IP address. |
| ### `https://docs.cloud.google.com/vmware-engine/docs/public/reference/rest/v1/projects.locations.privateClouds.externalAddresses/list` | Lists external IP addresses assigned to VMware workload VMs in a given private cloud. |
| ### `https://docs.cloud.google.com/vmware-engine/docs/public/reference/rest/v1/projects.locations.privateClouds.externalAddresses/patch` | Updates the parameters of a single external IP address. |