Retrieves a list of private connections in a given project and location.
HTTP request
GET https://datamigration.googleapis.com/v1/{parent}/privateConnections
Path parameters
Parameters
parent
string
Required. The parent that owns the collection of private connections.
Authorization requires the following IAM permission on the specified resource parent:
datamigration.privateconnections.list
Query parameters
Parameters
pageSize
integer
Maximum number of private connections to return. If unspecified, at most 50 private connections that are returned. The maximum value is 1000; values above 1000 are coerced to 1000.
pageToken
string
Page token received from a previous privateConnections.list call. Provide this to retrieve the subsequent page.
When paginating, all other parameters provided to privateConnections.list must match the call that provided the page token.
filter
string
A filter expression that filters private connections listed in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either =, !=, >, or <. For example, list private connections created this year by specifying createTime %gt; 2021-01-01T00:00:00.000000000Z.
orderBy
string
Order by fields for the result.
Request body
The request body must be empty.
Response body
Response message for 'privateConnections.list' request.
If successful, the response body contains data with the following structure:
[[["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 API endpoint retrieves a list of private connections within a specified project and location using a GET request.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e path parameter is required, and authorization for this request needs the \u003ccode\u003edatamigration.privateconnections.list\u003c/code\u003e IAM permission.\u003c/p\u003e\n"],["\u003cp\u003eQuery 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 control the results of private connections being retrieved.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and a successful response will include a list of private connections, a \u003ccode\u003enextPageToken\u003c/code\u003e for pagination, and a list of unreachable locations.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this endpoint requires the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.privateConnections.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.ListPrivateConnectionsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Examples](#examples)\n- [Try it!](#try-it)\n\nRetrieves a list of private connections in a given project and location.\n\n### HTTP request\n\n`GET https://datamigration.googleapis.com/v1/{parent}/privateConnections`\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for 'privateConnections.list' request.\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\nFor more information, see the [Authentication Overview](https://cloud.google.com/docs/authentication/)."]]