Stay organized with collections
Save and categorize content based on your preferences.
Lists projects that are direct children of the specified folder or
organization resource. list() provides a strongly consistent view of
the projects underneath the specified parent resource. list() returns
projects sorted based upon the (ascending) lexical ordering of their
display_name. The caller must have resourcemanager.projects.list
permission on the identified parent.
Optional. The maximum number of projects to return in the response. The server can return fewer projects than requested. If unspecified, server picks an appropriate default.
pageToken
string
Optional. A pagination token returned from a previous call to ListProjects that indicates from where listing should continue.
parent
string
Required. The name of the parent resource to list projects under. For example, setting this field to 'folders/1234' would list all projects directly under that folder.
showDeleted
boolean
Optional. Indicate that projects in the DELETE_REQUESTED state should also be returned. Normally only ACTIVE projects are returned.
Raised exceptions
Exceptions
ConnectionError
In case of a network problem (such as DNS failure or refused connection).
HttpError
If the response status is >= 400 (excluding 429 and 503).
TimeoutError
If a long-running operation takes longer to finish than the specified timeout limit.
TypeError
If an operation or function receives an argument of the wrong type.
ValueError
If an operation or function receives an argument of the right type but an inappropriate value. For example, a negative timeout.
[[["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-09-04 UTC."],[],[],null,["# Method: googleapis.cloudresourcemanager.v3.projects.list\n\nLists projects that are direct children of the specified folder or\norganization resource. `list()` provides a strongly consistent view of\nthe projects underneath the specified parent resource. `list()` returns\nprojects sorted based upon the (ascending) lexical ordering of their\n`display_name`. The caller must have `resourcemanager.projects.list`\npermission on the identified parent.\n\nArguments\n---------\n\nRaised exceptions\n-----------------\n\nResponse\n--------\n\nIf successful, the response contains an instance of [`ListProjectsResponse`](https://cloud.google.com/workflows/docs/reference/googleapis/cloudresourcemanager/v3/Overview#ListProjectsResponse).\n\nSubworkflow snippet\n-------------------\n\nSome fields might be optional or required.\nTo identify required fields, refer to the [API documentation](https://cloud.google.com/resource-manager/reference/rest/v3/projects/list). \n\n### YAML\n\n```yaml\n- list:\n call: googleapis.cloudresourcemanager.v3.projects.list\n args:\n pageSize: ...\n pageToken: ...\n parent: ...\n showDeleted: ...\n result: listResult\n```\n\n### JSON\n\n```json\n[\n {\n \"list\": {\n \"call\": \"googleapis.cloudresourcemanager.v3.projects.list\",\n \"args\": {\n \"pageSize\": \"...\",\n \"pageToken\": \"...\",\n \"parent\": \"...\",\n \"showDeleted\": \"...\"\n },\n \"result\": \"listResult\"\n }\n }\n]\n```"]]