Retrieve a list of all connection profiles in a given project and location.
HTTP request
GET https://datamigration.googleapis.com/v1alpha2/{parent}/connectionProfiles
Path parameters
Parameters
parent
string
Required. The parent, which owns this collection of connection profiles.
Authorization requires the following IAM permission on the specified resource parent:
datamigration.connectionprofiles.list
Query parameters
Parameters
pageSize
integer
The maximum number of connection profiles to return. The service may return fewer than this value. If unspecified, at most 50 connection profiles will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
pageToken
string
A page token, received from a previous connectionProfiles.list call. Provide this to retrieve the subsequent page.
When paginating, all other parameters provided to connectionProfiles.list must match the call that provided the page token.
filter
string
A filter expression that filters connection profiles 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 connection profiles created this year by specifying createTime %gt; 2020-01-01T00:00:00.000000000Z. You can also filter nested fields. For example, you could specify mySql.username = %lt;my_username%gt; to list all connection profiles configured to connect with a specific username.
orderBy
string
the order by fields for the result.
Request body
The request body must be empty.
Response body
Response message for 'connectionProfiles.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 webpage details how to retrieve a list of connection profiles within a specified project and location using a \u003ccode\u003eGET\u003c/code\u003e HTTP request.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e path parameter is required to specify the project and location, with proper \u003ccode\u003eIAM\u003c/code\u003e permission needed to authorize the request.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003epageSize\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e, \u003ccode\u003efilter\u003c/code\u003e, and \u003ccode\u003eorderBy\u003c/code\u003e query parameters can be used to customize the results, such as limiting the number of profiles, navigating through pages, applying filters and ordering the connection profiles.\u003c/p\u003e\n"],["\u003cp\u003eThe response body will include a list of connection profiles, a token to retrieve the next page of results if available, and a list of unreachable locations.\u003c/p\u003e\n"],["\u003cp\u003eThe request must be authorized using the OAuth scope: \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.connectionProfiles.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.ListConnectionProfilesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Examples](#examples)\n- [Try it!](#try-it)\n\nRetrieve a list of all connection profiles in a given project and location.\n\n### HTTP request\n\n`GET https://datamigration.googleapis.com/v1alpha2/{parent}/connectionProfiles`\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 'connectionProfiles.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/)."]]