Zones

Represents a Zone resource. See the Regions & Zones documentation for more information.

For a list of methods for this resource, see the end of this page.

Resource representations

A zone resource.

{
  "kind": "compute#zone",
  "selfLink": string,
  "id": unsigned long,
  "creationTimestamp": string,
  "name": string,
  "description": string,
  "status": string,
  "maintenanceWindows": [
    {
      "name": string,
      "description": string,
      "beginTime": string,
      "endTime": string
    }
  ],
  "deprecated": {
    "state": string,
    "replacement": string,
    "deprecated": string,
    "obsolete": string,
    "deleted": string
  },
  "region": string
}

Property name	Value	Description
`creationTimestamp`	`string`	[Output Only] Creation timestamp i n RFC3339 format .
`deprecated`	`nested object`	[Output Only] If applicable, t he deprecation status associated with this zone.
`deprecated. deleted`	`string`	[Output Only] An optional RFC3339 timestamp for when the deprecation state of this resource will be changed to `DELETED` .
`deprecated. deprecated`	`string`	[Output Only] An optional RFC3339 timestamp for when the deprecation state of this resource will be changed to `DEPRECATED` .
`deprecated. obsolete`	`string`	[Output Only] An optional RFC3339 timestamp for when the deprecation state of this resource will be changed to `OBSOLETE` .
`deprecated. replacement`	`string`	[Output Only] A fully-qualified URL of the suggested replacement for the deprecated zone.
`deprecated. state`	`string`	[Output Only] The deprecation state of this zone. Google Compute Engine sets this status if a zone will be deprecated soon. Acceptable values are: " `DELETED` ": DELETED zones cannot be used by existing resources or new resources. You must choose another zone to use. Google Compute Engine returns an error if you attempt to use this zone and recommends an alternative zone. " `DEPRECATED` ": `DEPRECATED` zone can still be used for new resource, but Google Compute Engine issues a warning and recommends a alternative zone. " `OBSOLETE` ": Existing instances already in an OBSOLETE zone can continue to reside there so, but you cannot create new resources in this zone. Google Compute Engine returns a warning if you attempt to use the zone for a new resource and recommends an alternative zone.
`description`	`string`	[Output Only] Textual description of the resource.
`id`	`unsigned long`	[Output Only] Unique identifier for the resource; defined by the server.
`kind`	`string`	[Output Only] The type of resource. Always `compute#zones` for Zone resources.
`maintenanceWindows[]`	`list`	[Output Only] Any scheduled maintenance windows for this zone. When the zone is in a maintenance window, all resources which reside in the zone will be unavailable. For more information, see Maintenance Windows .
`maintenanceWindows[]. beginTime`	`string`	[Output Only] Starting time of the maintenance window, in RFC3339 format .
`maintenanceWindows[]. description`	`string`	[Output Only] Textual description of the maintenance window.
`maintenanceWindows[]. endTime`	`string`	[Output Only] End time of the maintenance window, i n RFC3339 format .
`maintenanceWindows[]. name`	`string`	[Output Only] Name of the maintenance window.
`name`	`string`	[Output Only] Name of the resource.
`region`	`string`	[Output Only] The region of this zone.
`selfLink`	`string`	[Output Only] Server-defined fully-qualified URL for this resource.
`status`	`string`	[Output Only] The status of the zone, either `UP` or `DOWN` . Acceptable values are: " `DOWN` ": The zone is currently unavailable. " `UP` ": The zone is currently available.

Methods

The following are valid methods for Zone resources:

get: Returns the specified zone resource.
list: Retrieves the list of zone resources available to the specified project.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License , and code samples are licensed under the Apache 2.0 License . For details, see our Site Policies .

Last updated December 3, 2013.

Google Compute Engine

Zones

Resource representations

Methods

Authentication required

Signing you in...