# REST Resource: projects.locations.zones

- [Resource: Zone](https://docs.cloud.google.com/distributed-cloud/connected/1.7.0/docs/reference/hardware/rest/v1alpha/projects.locations.zones#Zone)
  - [JSON representation](https://docs.cloud.google.com/distributed-cloud/connected/1.7.0/docs/reference/hardware/rest/v1alpha/projects.locations.zones#Zone.SCHEMA_REPRESENTATION)
- [State](https://docs.cloud.google.com/distributed-cloud/connected/1.7.0/docs/reference/hardware/rest/v1alpha/projects.locations.zones#State)
- [ZoneNetworkConfig](https://docs.cloud.google.com/distributed-cloud/connected/1.7.0/docs/reference/hardware/rest/v1alpha/projects.locations.zones#ZoneNetworkConfig)
  - [JSON representation](https://docs.cloud.google.com/distributed-cloud/connected/1.7.0/docs/reference/hardware/rest/v1alpha/projects.locations.zones#ZoneNetworkConfig.SCHEMA_REPRESENTATION)
- [Subnet](https://docs.cloud.google.com/distributed-cloud/connected/1.7.0/docs/reference/hardware/rest/v1alpha/projects.locations.zones#Subnet)
  - [JSON representation](https://docs.cloud.google.com/distributed-cloud/connected/1.7.0/docs/reference/hardware/rest/v1alpha/projects.locations.zones#Subnet.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/distributed-cloud/connected/1.7.0/docs/reference/hardware/rest/v1alpha/projects.locations.zones#METHODS_SUMMARY)

## Resource: Zone

A zone holding a set of hardware.

| JSON representation |
|---|
| ``` { "name": string, "createTime": string, "updateTime": string, "labels": { string: string, ... }, "displayName": string, "state": enum (`https://docs.cloud.google.com/distributed-cloud/connected/1.7.0/docs/reference/hardware/rest/v1alpha/projects.locations.zones#State`), "contacts": [ { object (`https://docs.cloud.google.com/distributed-cloud/connected/1.7.0/docs/reference/hardware/rest/v1alpha/Contact`) } ], "ciqUri": string, "networkConfig": { object (`https://docs.cloud.google.com/distributed-cloud/connected/1.7.0/docs/reference/hardware/rest/v1alpha/projects.locations.zones#ZoneNetworkConfig`) } } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. Name of this zone. Format: `projects/{project}/locations/{location}/zones/{zone}` |
| `createTime` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` format)`` Output only. Time when this zone was created. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: `"2014-10-02T15:01:23Z"` and `"2014-10-02T15:01:23.045123456Z"`. |
| `updateTime` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` format)`` Output only. Time when this zone was last updated. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: `"2014-10-02T15:01:23Z"` and `"2014-10-02T15:01:23.045123456Z"`. |
| `labels` | `map (key: string, value: string)` Optional. Labels associated with this zone as key value pairs. For more information about labels, see [Create and manage labels](https://cloud.google.com/resource-manager/docs/creating-managing-labels). An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |
| `displayName` | `string` Optional. Human friendly display name of this zone. |
| `state` | ``enum (`https://docs.cloud.google.com/distributed-cloud/connected/1.7.0/docs/reference/hardware/rest/v1alpha/projects.locations.zones#State`)`` Output only. Current state for this zone. |
| `contacts[]` | ``object (`https://docs.cloud.google.com/distributed-cloud/connected/1.7.0/docs/reference/hardware/rest/v1alpha/Contact`)`` Required. The points of contact. |
| `ciqUri` | `string` Output only. Link to the Customer Intake Questionnaire (CIQ) sheet for this zone. |
| `networkConfig` | ``object (`https://docs.cloud.google.com/distributed-cloud/connected/1.7.0/docs/reference/hardware/rest/v1alpha/projects.locations.zones#ZoneNetworkConfig`)`` Optional. Networking configuration for this zone. |

## State

Valid states for a zone.

| Enums ||
|---|---|
| `STATE_UNSPECIFIED` | State of the Zone is unspecified. |
| `ADDITIONAL_INFO_NEEDED` | More information is required from the customer to make progress. |
| `PREPARING` | Google is preparing the Zone. |
| `ACTIVE` | The Zone is available to use. |
| `CANCELLED` | The Zone has been cancelled. |

## ZoneNetworkConfig

Networking configuration for a zone.

| JSON representation |
|---|
| ``` { "machineMgmtIpv4Range": string, "kubernetesNodeIpv4Range": string, "kubernetesControlPlaneIpv4Range": string, "managementIpv4Subnet": { object (`https://docs.cloud.google.com/distributed-cloud/connected/1.7.0/docs/reference/hardware/rest/v1alpha/projects.locations.zones#Subnet`) }, "kubernetesIpv4Subnet": { object (`https://docs.cloud.google.com/distributed-cloud/connected/1.7.0/docs/reference/hardware/rest/v1alpha/projects.locations.zones#Subnet`) } } ``` |

| Fields ||
|---|---|
| `machineMgmtIpv4Range` | `string` Required. An IPv4 address block for machine management. Should be a private RFC1918 or public CIDR block large enough to allocate at least one address per machine in the Zone. Should be in `managementIpv4Subnet`, and disjoint with other address ranges. |
| `kubernetesNodeIpv4Range` | `string` Required. An IPv4 address block for kubernetes nodes. Should be a private RFC1918 or public CIDR block large enough to allocate at least one address per machine in the Zone. Should be in `kubernetesIpv4Subnet`, and disjoint with other address ranges. |
| `kubernetesControlPlaneIpv4Range` | `string` Required. An IPv4 address block for kubernetes control plane. Should be a private RFC1918 or public CIDR block large enough to allocate at least one address per cluster in the Zone. Should be in `kubernetesIpv4Subnet`, and disjoint with other address ranges. |
| `managementIpv4Subnet` | ``object (`https://docs.cloud.google.com/distributed-cloud/connected/1.7.0/docs/reference/hardware/rest/v1alpha/projects.locations.zones#Subnet`)`` Required. An IPv4 subnet for the management network. |
| `kubernetesIpv4Subnet` | ``object (`https://docs.cloud.google.com/distributed-cloud/connected/1.7.0/docs/reference/hardware/rest/v1alpha/projects.locations.zones#Subnet`)`` Optional. An IPv4 subnet for the kubernetes network. If unspecified, the kubernetes subnet will be the same as the management subnet. |

## Subnet

Represents a subnet.

| JSON representation |
|---|
| ``` { "addressRange": string, "defaultGatewayIpAddress": string } ``` |

| Fields ||
|---|---|
| `addressRange` | `string` Required. Address range for this subnet in CIDR notation. |
| `defaultGatewayIpAddress` | `string` Required. Default gateway for this subnet. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/distributed-cloud/connected/1.7.0/docs/reference/hardware/rest/v1alpha/projects.locations.zones/create` | Creates a new zone in a given project and location. |
| ### `https://docs.cloud.google.com/distributed-cloud/connected/1.7.0/docs/reference/hardware/rest/v1alpha/projects.locations.zones/delete` | Deletes a zone. |
| ### `https://docs.cloud.google.com/distributed-cloud/connected/1.7.0/docs/reference/hardware/rest/v1alpha/projects.locations.zones/get` | Gets details of a zone. |
| ### `https://docs.cloud.google.com/distributed-cloud/connected/1.7.0/docs/reference/hardware/rest/v1alpha/projects.locations.zones/list` | Lists zones in a given project and location. |
| ### `https://docs.cloud.google.com/distributed-cloud/connected/1.7.0/docs/reference/hardware/rest/v1alpha/projects.locations.zones/patch` | Updates the parameters of a zone. |