Method: projects.locations.list

Fetches locations that offer Google Kubernetes Engine.

HTTP request

GET https://container.googleapis.com/v1beta1/{parent=projects/*}/locations

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. Contains the name of the resource requested. Specified in the format projects/*.

Request body

The request body must be empty.

Response body

ListLocationsResponse returns the list of all GKE locations and their recommendation state.

If successful, the response body contains data with the following structure:

JSON representation
{
  "locations": [
    {
      object (Location)
    }
  ],
  "nextPageToken": string
}
Fields
locations[]

object (Location)

A full list of GKE locations.

nextPageToken

string

Only return ListLocationsResponse that occur after the pageToken. This value should be populated from the ListLocationsResponse.next_page_token if that response token was set (which happens when listing more Locations than fit in a single ListLocationsResponse).

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

Location

Location returns the location name, and if the location is recommended for GKE cluster scheduling.

JSON representation
{
  "type": enum (LocationType),
  "name": string,
  "recommended": boolean
}
Fields
type

enum (LocationType)

Contains the type of location this Location is for. Regional or Zonal.

name

string

Contains the name of the resource requested. Specified in the format projects/*/locations/*.

recommended

boolean

Whether the location is recommended for GKE cluster scheduling.

LocationType

LocationType is the type of GKE location, regional or zonal.

Enums
LOCATION_TYPE_UNSPECIFIED LOCATION_TYPE_UNSPECIFIED means the location type was not determined.
ZONE A GKE Location where Zonal clusters can be created.
REGION A GKE Location where Regional clusters can be created.