Required. The project and location for which to retrieve instance information in the format projects/{project}/locations/{location}. If the location is specified as '-' (wildcard), then all regions available to the project are queried, and the results are aggregated.
Query parameters
Parameters
pageSize
integer
The maximum number of items to return.
pageToken
string
The nextPageToken value to use if there are additional results to retrieve for this list request.
filter
string
List filter.
orderBy
string
Sort results. Supported values are "name", "name desc", or "" (unsorted).
Request body
The request body must be empty.
Response body
Response message for the list instance 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-06-20 UTC."],[[["\u003cp\u003eThis endpoint retrieves a list of Data Fusion instances within a specified project and location.\u003c/p\u003e\n"],["\u003cp\u003eThe request uses a \u003ccode\u003eGET\u003c/code\u003e method and requires the project and location to be specified in the URL path as \u003ccode\u003eparent\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe request supports optional query parameters for pagination (\u003ccode\u003epageSize\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e), filtering (\u003ccode\u003efilter\u003c/code\u003e), and ordering (\u003ccode\u003eorderBy\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eThe response returns a list of Data Fusion instance objects, a token for retrieving the next page of results if applicable, and a list of unreachable locations.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization to access 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.instances.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.ListInstancesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists Data Fusion instances in the specified project and location.\n\n### HTTP request\n\n`GET https://datafusion.googleapis.com/v1beta1/{parent=projects/*/locations/*}/instances`\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\nResponse message for the list instance 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](/docs/authentication#authorization-gcp)."]]