Method: projects.locations.list

Lists information about the supported locations for this service.

HTTP request

GET https://firebaseapphosting.googleapis.com/v1/{name=projects/*}/locations

The URL uses gRPC Transcoding syntax. To know more about valid error responses that can be thrown by this HTTP request, please refer to the service error catalog

Path parameters

Parameters
name

string

The resource that owns the locations collection, if applicable.

Query parameters

Parameters
filter

string

A filter to narrow down results to a preferred subset. The filtering language accepts strings like "displayName=tokyo", and is documented in more detail in AIP-160.
pageSize

integer

The maximum number of results to return. If not set, the service selects a default.
pageToken

string

A page token received from the nextPageToken field in the response. Send that page token to receive the subsequent page.
extraLocationTypes[]

string

Optional. A list of extra location types that should be used as conditions for controlling the visibility of the locations.

Request body

The request body must be empty.

Response body

The response message for Locations.ListLocations.

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

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

object (Location)

A list of locations that matches the specified filter in the request.
nextPageToken

string

The standard List next-page token.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.

IAM Permissions

Requires the following IAM permission on the name resource:

  • firebaseapphosting.locations.list

For more information, see the IAM documentation.

See also Firebase App Hosting's IAM Permissions and Predefined IAM Roles.