Stay organized with collections
Save and categorize content based on your preferences.
Lists domains of a backend.
HTTP request
GET https://firebaseapphosting.googleapis.com/v1beta/{parent=projects/*/locations/*/backends/*}/domains
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
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-04-04 UTC."],[],[],null,["# Method: projects.locations.backends.domains.list\n\nLists domains of a backend.\n\n### HTTP request\n\n`GET https://firebaseapphosting.googleapis.com/v1beta/{parent=projects/*/locations/*/backends/*}/domains`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax. To know more about valid error responses that can be thrown by this HTTP request, please refer to the [service error catalog](/docs/reference/apphosting/rest/v1beta/errors)\n\n### Path parameters\n\n| Parameters ||\n|----------|------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent backend in the format: `projects/{project}/locations/{locationId}/backends/{backendId}`. |\n\n### Query parameters\n\n| Parameters ||\n|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Optional. The maximum number of results to return. If not set, the service selects a default. |\n| `pageToken` | `string` Optional. A page token received from the nextPageToken field in the response. Send that page token to receive the subsequent page. |\n| `filter` | `string` Optional. A filter to narrow down results to a preferred subset. Learn more about filtering in Google's [AIP 160 standard](https://google.aip.dev/160). |\n| `orderBy` | `string` Optional. Hint for how to order the results. Supported fields are `name` and `createTime`. To specify descending order, append a `desc` suffix. |\n| `showDeleted` | `boolean` Optional. If true, the request returns soft-deleted resources that haven't been fully-deleted yet. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nMessage for response to list domains.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"domains\": [ { object (/docs/reference/apphosting/rest/v1beta/projects.locations.backends.domains#Domain) } ], \"nextPageToken\": string, \"unreachable\": [ string ] } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------|\n| `domains[]` | `object (`[Domain](/docs/reference/apphosting/rest/v1beta/projects.locations.backends.domains#Domain)`)` Output only. The list of domains. |\n| `nextPageToken` | `string` Output only. A token identifying the next page of results the server should return. |\n| `unreachable[]` | `string` Output only. Locations that could not be reached. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2).\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource:\n\n- `firebaseapphosting.domains.list`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs).\n\nSee also Firebase App Hosting's [IAM Permissions](https://firebase.google.com/docs/projects/iam/permissions#app-hosting) and [Predefined IAM Roles](https://firebase.google.com/docs/projects/iam/roles-predefined-product)."]]