Lists migration jobs in a given project and location.
HTTP request
GET https://datamigration.googleapis.com/v1/{parent}/migrationJobs
Path parameters
Parameters
parent
string
Required. The parent which owns this collection of migrationJobs.
Authorization requires the following IAM permission on the specified resource parent:
datamigration.migrationjobs.list
Query parameters
Parameters
pageSize
integer
The maximum number of migration jobs to return. The service may return fewer than this value. If unspecified, at most 50 migration jobs will be returned. The maximum value is 1000; values above 1000 are coerced to 1000.
pageToken
string
The nextPageToken value received in the previous call to migrationJobs.list, used in the subsequent request to retrieve the next page of results. On first call this should be left blank. When paginating, all other parameters provided to migrationJobs.list must match the call that provided the page token.
filter
string
A filter expression that filters migration jobs 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 migration jobs created this year by specifying createTime %gt; 2020-01-01T00:00:00.000000000Z. You can also filter nested fields. For example, you could specify reverseSshConnectivity.vmIp = "1.2.3.4" to select all migration jobs connecting through the specific SSH tunnel bastion.
orderBy
string
Sort the results based on the migration job name. Valid values are: "name", "name asc", and "name desc".
Request body
The request body must be empty.
Response body
Response message for 'migrationJobs.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 list migration jobs within a specific project and location using a GET HTTP request.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e parameter is required in the path to specify the project and location, and listing migration jobs requires specific IAM permissions.\u003c/p\u003e\n"],["\u003cp\u003eQuery parameters like \u003ccode\u003epageSize\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e, \u003ccode\u003efilter\u003c/code\u003e, and \u003ccode\u003eorderBy\u003c/code\u003e allow for pagination, filtering, and sorting of the migration jobs returned in the response.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, while the response body includes a list of \u003ccode\u003emigrationJobs\u003c/code\u003e, a \u003ccode\u003enextPageToken\u003c/code\u003e for subsequent pages, and a list of \u003ccode\u003eunreachable\u003c/code\u003e locations.\u003c/p\u003e\n"],["\u003cp\u003eAccessing this endpoint requires the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.migrationJobs.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.ListMigrationJobsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Examples](#examples)\n- [Try it!](#try-it)\n\nLists migration jobs in a given project and location.\n\n### HTTP request\n\n`GET https://datamigration.googleapis.com/v1/{parent}/migrationJobs`\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 'migrationJobs.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/)."]]