- HTTP request
- Path parameters
- Request body
- Response body
- Authorization Scopes
- Location
- LocationType
- Try it!
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 |
Required. Contains the name of the resource requested. Specified in the format |
Request body
The request body must be empty.
Response body
If successful, the response body contains data with the following structure:
ListLocationsResponse returns the list of all GKE locations and their recommendation state.
JSON representation |
---|
{
"locations": [
{
object ( |
Fields | |
---|---|
locations[] |
A full list of GKE locations. |
nextPageToken |
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 ( |
Fields | |
---|---|
type |
Contains the type of location this Location is for. Regional or Zonal. |
name |
Contains the name of the resource requested. Specified in the format |
recommended |
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. |