Required. The parent, which owns this collection of profiles. Format: projects/{user_project_id} It takes the formprojects/{project}.
Authorization requires the followingIAMpermission on the specified resourceparent:
cloudprofiler.profiles.list
Query parameters
Parameters
pageSize
integer
Optional. The maximum number of items to return. Default pageSize is 1000. Max limit is 1000.
pageToken
string
Optional. The token to continue pagination and get profiles from a particular page. When paginating, all other parameters provided toprofiles.listmust match the call that provided the page token.
Request body
The request body must be empty.
Response body
ListProfileResponse contains the list of collected profiles for deployments in projects which the user has permissions to view.
If successful, the response body contains data with the following structure:
Token to receive the next page of results. This field maybe empty if there are no more profiles to fetch.
skippedProfiles
integer
Number of profiles that were skipped in the current page since they were not able to be fetched successfully. This should typically be zero. A non-zero value may indicate a transient failure, in which case if the number is too high for your use case, the call may be retried.
[[["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-09 UTC."],[],[],null,["# Method: projects.profiles.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.ListProfilesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists profiles which have been collected so far and for which the caller has permission to view.\n\n### HTTP request\n\n`GET https://cloudprofiler.googleapis.com/v2/{parent=projects/*}/profiles`\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\nListProfileResponse contains the list of collected profiles for deployments in projects which the user has permissions to view.\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/monitoring`\n- `\n https://www.googleapis.com/auth/monitoring.write`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
