Method: sites.versions.list
Stay organized with collections
Save and categorize content based on your preferences.
Lists the versions that have been created for the specified site.
This list includes versions for both the default live channel and any active preview channels for the specified site.
HTTP request
GET https://firebasehosting.googleapis.com/v1beta1/{parent=sites/*}/versions
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
parent |
string
Required. The site or channel for which to list versions, in either of the following formats:
|
Query parameters
| Parameters |
pageSize |
integer
The maximum number of versions to return. The service may return a lower number if fewer versions exist than this maximum number.
If unspecified, defaults to 25. The maximum value is 100; values above 100 will be coerced to 100.
|
pageToken |
string
A token from a previous call to versions.list that tells the server where to resume listing.
|
filter |
string
A filter string used to return a subset of versions in the response. The currently supported fields for filtering are: name, status, and createTime. Learn more about filtering in Google's AIP 160 standard.
|
Request body
The request body must be empty.
Response body
If successful, the response body contains data with the following structure:
| JSON representation |
{
"versions": [
{
object (Version)
}
],
"nextPageToken": string
} |
| Fields |
versions[] |
object (Version)
The list of versions, if any exist.
|
nextPageToken |
string
The pagination token, if more results exist beyond the ones in this response. Include this token in your next call to versions.list. Page tokens are short-lived and should not be stored.
|
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/firebase.hosting.readonly
https://www.googleapis.com/auth/firebase.hosting
https://www.googleapis.com/auth/firebase.readonly
https://www.googleapis.com/auth/firebase
https://www.googleapis.com/auth/cloud-platform.read-only
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-09-11 UTC.
[null,null,["Last updated 2023-09-11 UTC."],[],[],null,["# Method: sites.versions.list\n\nLists the versions that have been created for the specified site.\n\nThis list includes versions for both the default `live` channel and any active preview channels for the specified site.\n\n### HTTP request\n\n`GET https://firebasehosting.googleapis.com/v1beta1/{parent=sites/*}/versions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The site or channel for which to list versions, in either of the following formats: - \u003cbr /\u003e `sites/`\u003cvar translate=\"no\"\u003eSITE_ID\u003c/var\u003e - `sites/`\u003cvar translate=\"no\"\u003eSITE_ID\u003c/var\u003e`/channels/`\u003cvar translate=\"no\"\u003eCHANNEL_ID\u003c/var\u003e \u003cbr /\u003e \u003cbr /\u003e |\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of versions to return. The service may return a lower number if fewer versions exist than this maximum number. If unspecified, defaults to 25. The maximum value is 100; values above 100 will be coerced to 100. |\n| `pageToken` | `string` A token from a previous call to `versions.list` that tells the server where to resume listing. |\n| `filter` | `string` A filter string used to return a subset of versions in the response. The currently supported fields for filtering are: `name`, `status`, and `createTime`. Learn more about filtering in Google's [AIP 160 standard](https://google.aip.dev/160). |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"versions\": [ { object (/docs/reference/hosting/rest/v1beta1/sites.versions#Version) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `versions[]` | `object (`[Version](/docs/reference/hosting/rest/v1beta1/sites.versions#Version)`)` The list of versions, if any exist. |\n| `nextPageToken` | `string` The pagination token, if more results exist beyond the ones in this response. Include this token in your next call to `versions.list`. Page tokens are short-lived and should not be stored. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/firebase.hosting.readonly`\n- `\n https://www.googleapis.com/auth/firebase.hosting`\n- `\n https://www.googleapis.com/auth/firebase.readonly`\n- `\n https://www.googleapis.com/auth/firebase`\n- `\n https://www.googleapis.com/auth/cloud-platform.read-only`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](https://cloud.google.com/docs/authentication/)."]]
