# Compute Engine API . zones

## Instance Methods

Returns the specified zone resource.

Retrieves the list of zone resources available to the specified project.

Retrieves the next page of results.

### Method Details

`get(project, zone)`

    Returns the specified zone resource.

    Args:
      project: string, Project ID for this request. (required)
      zone: string, Name of the zone resource to return. (required)

    Returns:
      An object of the form:

        { # A Zone resource.
        "status": "A String", # [Output Only] Status of the zone, either UP or DOWN.
        "kind": "compute#zone", # [Output Only] Type of the resource. Always kind#zone for zones.
        "description": "A String", # [Output Only] Textual description of the resource.
        "maintenanceWindows": [ # [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
          {
            "endTime": "A String", # [Output Only] Ending time of the maintenance window, in RFC3339 format.
            "beginTime": "A String", # [Output Only] Starting time of the maintenance window, in RFC3339 format.
            "name": "A String", # [Output Only] Name of the maintenance window.
            "description": "A String", # [Output Only] Textual description of the maintenance window.
          },
        ],
        "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this zone.
          "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
          "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
          "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
          "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
          "replacement": "A 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.
        },
        "region": "A String", # [Output Only] Full URL reference to the region which hosts the zone.
        "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
        "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
        "selfLink": "A String", # [Output Only] Server defined URL for the resource.
        "name": "A String", # [Output Only] Name of the resource.
      }

`list(project, maxResults=None, pageToken=None, filter=None)`

    Retrieves the list of zone resources available to the specified project.

    Args:
      project: string, Project ID for this request. (required)
      maxResults: integer, Maximum count of results to be returned.
      pageToken: string, Tag returned by a previous list request when that list was truncated to maxResults. Used to continue a previous list request.
      filter: string, Filter expression for filtering listed resources.

    Returns:
      An object of the form:

        { # Contains a list of zone resources.
        "nextPageToken": "A String", # [Output Only] A token used to continue a truncated list request.
        "items": [ # [Output Only] A list of Zone resources.
          { # A Zone resource.
            "status": "A String", # [Output Only] Status of the zone, either UP or DOWN.
            "kind": "compute#zone", # [Output Only] Type of the resource. Always kind#zone for zones.
            "description": "A String", # [Output Only] Textual description of the resource.
            "maintenanceWindows": [ # [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
              {
                "endTime": "A String", # [Output Only] Ending time of the maintenance window, in RFC3339 format.
                "beginTime": "A String", # [Output Only] Starting time of the maintenance window, in RFC3339 format.
                "name": "A String", # [Output Only] Name of the maintenance window.
                "description": "A String", # [Output Only] Textual description of the maintenance window.
              },
            ],
            "deprecated": { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this zone.
              "deleted": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DELETED.
              "deprecated": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.
              "state": "A String", # The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.
              "obsolete": "A String", # An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.
              "replacement": "A 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.
            },
            "region": "A String", # [Output Only] Full URL reference to the region which hosts the zone.
            "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
            "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
            "selfLink": "A String", # [Output Only] Server defined URL for the resource.
            "name": "A String", # [Output Only] Name of the resource.
          },
        ],
        "kind": "compute#zoneList", # Type of resource.
        "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
        "selfLink": "A String", # Server defined URL for this resource (output only).
      }

`list_next(previous_request, previous_response)`

    Retrieves the next page of results.

    Args:
      previous_request: The request for the previous page. (required)
      previous_response: The response from the request for the previous page. (required)

    Returns:
      A request object that you can call 'execute()' on to request the next
      page. Returns None if there are no more items in the collection.