A zone is a deployment area. These deployment areas are subsets of a region. For example the zoneus-east1-bis located in theus-east1region. For more information, readRegions and Zones.
If successful, the response body contains data with the following structure:
[Output Only] Textual description of the resource.
status
enum
[Output Only] Status of the zone, eitherUPorDOWN.
deprecated
object
[Output Only] The deprecation status associated with this zone.
deprecated.state
enum
The deprecation state of this resource. This can beACTIVE,DEPRECATED,OBSOLETE, orDELETED. Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATEDresource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which useOBSOLETEorDELETEDresources will be rejected and result in an error.
deprecated.replacement
string
The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.
deprecated.deprecated
string
An optionalRFC3339timestamp on or after which the state of this resource is intended to change toDEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.
deprecated.obsolete
string
An optionalRFC3339timestamp on or after which the state of this resource is intended to change toOBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.
deprecated.deleted
string
An optionalRFC3339timestamp on or after which the state of this resource is intended to change toDELETED. This is only informational and the status will not change unless the client explicitly changes it.
region
string
[Output Only] Full URL reference to the region which hosts the zone.
selfLink
string
[Output Only] Server-defined URL for the resource.
availableCpuPlatforms[]
string
[Output Only] Available cpu/platform selections for the zone.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-28 UTC."],[[["\u003cp\u003eThis page details how to retrieve a specific Zone resource using a \u003ccode\u003eGET\u003c/code\u003e request, including the necessary parameters and response structure.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eGET\u003c/code\u003e request URL structure is \u003ccode\u003ehttps://compute.googleapis.com/compute/v1/projects/{project}/zones/{zone}\u003c/code\u003e, which includes path parameters for the \u003ccode\u003eproject\u003c/code\u003e and \u003ccode\u003ezone\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request body for this operation must be empty, and the response body will represent a Zone resource with detailed fields like \u003ccode\u003ekind\u003c/code\u003e, \u003ccode\u003eid\u003c/code\u003e, \u003ccode\u003ename\u003c/code\u003e, \u003ccode\u003estatus\u003c/code\u003e, \u003ccode\u003edeprecated\u003c/code\u003e, \u003ccode\u003eregion\u003c/code\u003e, etc.\u003c/p\u003e\n"],["\u003cp\u003eAccessing this resource requires specific OAuth scopes such as \u003ccode\u003ehttps://www.googleapis.com/auth/compute.readonly\u003c/code\u003e or relevant IAM permissions like \u003ccode\u003ecompute.zones.get\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe definition of a Zone is a subset of a region, and a deployment area, for example the zone \u003ccode\u003eus-east1-b\u003c/code\u003e is located in the \u003ccode\u003eus-east1\u003c/code\u003e region.\u003c/p\u003e\n"]]],[],null,["# Method: zones.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.Zone.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [Try it!](#try-it)\n\nReturns the specified Zone resource.\n\n### HTTP request\n\n`GET https://compute.googleapis.com/compute/v1/projects/{project}/zones/{zone}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nRepresents a Zone resource.\n\nA zone is a deployment area. These deployment areas are subsets of a region. For example the zone `us-east1-b` is located in the `us-east1` region. For more information, read [Regions and Zones](/docs/geography-and-regions#regions_and_zones).\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/compute.readonly`\n- `\n https://www.googleapis.com/auth/compute`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\n### IAM Permissions\n\nIn addition to any permissions specified on the fields above, authorization requires one or more of the following [IAM](https://cloud.google.com/iam/docs/) permissions:\n\n- `compute.zones.get`\n\nTo find predefined roles that contain those permissions, see [Compute Engine IAM Roles](/compute/docs/access/iam)."]]
