Projects: listXpnHosts

Requires authorization

List all shared VPC host projects visible to the user in an organization.


HTTP request



Parameter name Value Description
Path parameters
project string Project ID for this request.
Optional query parameters
filter string
maxResults unsigned integer
order_by string
pageToken string


This request requires authorization with at least one of the following scopes (read more about authentication and authorization).


Request body

In the request body, supply data with the following structure:

  "organization": string
Property name Value Description Notes
organization string Optional organization ID managed by Cloud Resource Manager, for which to list shared VPC host projects. If not specified, the organization will be inferred from the project.


If successful, this method returns a response body with the following structure:

  "kind": "compute#xpnHostList",
  "id": string,
  "items": [
    projects Resource
  "nextPageToken": string,
  "selfLink": string
Property name Value Description Notes
kind string [Output Only] Type of resource. Always compute#xpnHostList for lists of shared VPC hosts.
id string [Output Only] The unique identifier for the resource. This identifier is defined by the server.
items[] list [Output Only] A list of shared VPC host project URLs.
nextPageToken string [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.

Send feedback about...

Compute Engine