Required. The parent, which owns this collection of targets. Format must be projects/{projectId}/locations/{location_name}.
Query parameters
Parameters
pageSize
integer
Optional. The maximum number of Target objects to return. The service may return fewer than this value. If unspecified, at most 50 Target objects will be returned. The maximum value is 1000; values above 1000 will be set to 1000.
pageToken
string
Optional. A page token, received from a previous targets.list call. Provide this to retrieve the subsequent page.
When paginating, all other provided parameters match the call that provided the page token.
[[["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-13 UTC."],[[["\u003cp\u003eThis API endpoint retrieves a list of targets within a specified project and location using a GET request.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires a \u003ccode\u003eparent\u003c/code\u003e path parameter in the format \u003ccode\u003eprojects/{projectId}/locations/{location_name}\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters such as \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 target list.\u003c/p\u003e\n"],["\u003cp\u003eThe response body returns a JSON object containing an array of \u003ccode\u003eTarget\u003c/code\u003e objects, a \u003ccode\u003enextPageToken\u003c/code\u003e for pagination, and a list of \u003ccode\u003eunreachable\u003c/code\u003e locations.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the OAuth scope \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e and the IAM permission \u003ccode\u003eclouddeploy.targets.list\u003c/code\u003e on the parent resource.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.targets.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.ListTargetsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [Try it!](#try-it)\n\nLists Targets in a given project and location.\n\n### HTTP request\n\n`GET https://clouddeploy.googleapis.com/v1/{parent=projects/*/locations/*}/targets`\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\nThe response object from `targets.list`.\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).\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource:\n\n- `clouddeploy.targets.list`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]