Required. The parent, which owns this collection of host projects. Format: projects/*/locations/*
Query parameters
Parameters
pageSize
integer
Optional. The maximum number of host project registrations to return. The service may return fewer than this value. If unspecified, at most 50 host project registrations will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
pageToken
string
Optional. A page token, received from a previous hostProjectRegistrations.list call. Provide this to retrieve the subsequent page.
When paginating, all other parameters (except pageSize) provided to hostProjectRegistrations.list must match the call that provided the page token.
filter
string
Optional. An expression that filters the list of HostProjectRegistrations.
A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string. All standard operators as documented at https://google.aip.dev/160 are supported.
The following fields in the HostProjectRegistration are eligible for filtering:
name - The name of the HostProjectRegistration.
create_time - The time at which the HostProjectRegistration was created. The value should be in the (RFC3339)[https://tools.ietf.org/html/rfc3339] format.
gcp_project - The Google cloud project associated with the HostProjectRegistration.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-28 UTC."],[[["\u003cp\u003eThis endpoint lists host project registrations, requiring a \u003ccode\u003eGET\u003c/code\u003e request to \u003ccode\u003ehttps://apihub.googleapis.com/v1/{parent=projects/*/locations/*}/hostProjectRegistrations\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e path parameter is required, specifying the project and location, using the format \u003ccode\u003eprojects/*/locations/*\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters such as \u003ccode\u003epageSize\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e, \u003ccode\u003efilter\u003c/code\u003e, and \u003ccode\u003eorderBy\u003c/code\u003e can be used to customize the result set, including pagination and filtering by fields like \u003ccode\u003ename\u003c/code\u003e, \u003ccode\u003ecreate_time\u003c/code\u003e, or \u003ccode\u003egcp_project\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and a successful response returns a JSON object containing a list of \u003ccode\u003ehostProjectRegistrations\u003c/code\u003e and an optional \u003ccode\u003enextPageToken\u003c/code\u003e for pagination.\u003c/p\u003e\n"],["\u003cp\u003eTo use this endpoint, you need the OAuth scope \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e and the \u003ccode\u003eapihub.runTimeProjectAttachments.list\u003c/code\u003e IAM permission on the parent resource.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.hostProjectRegistrations.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListHostProjectRegistrationsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n\nLists host project registrations.\n\n### HTTP request\n\n`GET https://apihub.googleapis.com/v1/{parent=projects/*/locations/*}/hostProjectRegistrations`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe [hostProjectRegistrations.list](/apigee/docs/reference/apis/apihub/rest/v1/projects.locations.hostProjectRegistrations/list#google.cloud.apihub.v1.HostProjectRegistrationService.ListHostProjectRegistrations) method's response.\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource:\n\n- `apihub.runTimeProjectAttachments.list`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]