Stay organized with collections
Save and categorize content based on your preferences.
Updates a folder, changing its display_name. Changes to the folder
display_name will be rejected if they violate either the
display_name formatting rules or the naming constraints described in
the CreateFolder documentation. The folder's display_name must start
and end with a letter or digit, may contain letters, digits, spaces,
hyphens and underscores and can be between 3 and 30 characters. This is
captured by the regular expression: \p{L}\p{N}{1,28}[\p{L}\p{N}].
The caller must have resourcemanager.folders.update permission on the
identified folder. If the update fails due to the unique name constraint
then a PreconditionFailure explaining this violation will be returned
in the Status.details field.
This method waits—the workflow execution is paused—until the operation is
complete, fails, or times out. The default timeout value is 1800 seconds (30
minutes) and can be changed to a maximum value of 31536000 seconds (one year)
for long-running operations using the connector_params field. See the
Connectors reference.
The connector uses polling to monitor the long-running operation, which might
generate additional billable steps. For more information about retries and
long-running operations, refer to Understand connectors.
The polling policy for the long-running operation can be configured. To set the
connector-specific parameters (connector_params), refer to
Invoke a connector call.
Arguments
Parameters
name
string
Required. Output only. The resource name of the folder. Its format is folders/{folder_id}, for example: "folders/1234".
[[["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-08-28 UTC."],[],[],null,["# Method: googleapis.cloudresourcemanager.v3.folders.patch\n\nUpdates a folder, changing its `display_name`. Changes to the folder\n`display_name` will be rejected if they violate either the\n`display_name` formatting rules or the naming constraints described in\nthe CreateFolder documentation. The folder's `display_name` must start\nand end with a letter or digit, may contain letters, digits, spaces,\nhyphens and underscores and can be between 3 and 30 characters. This is\ncaptured by the regular expression: `\\p{L}\\p{N}{1,28}[\\p{L}\\p{N}]`.\nThe caller must have `resourcemanager.folders.update` permission on the\nidentified folder. If the update fails due to the unique name constraint\nthen a `PreconditionFailure` explaining this violation will be returned\nin the Status.details field.\n\nThis method waits---the workflow execution is paused---until the operation is\ncomplete, fails, or times out. The default timeout value is `1800` seconds (30\nminutes) and can be changed to a maximum value of `31536000` seconds (one year)\nfor long-running operations using the `connector_params` field. See the\n[Connectors reference](/workflows/docs/reference/googleapis).\n\nThe connector uses polling to monitor the long-running operation, which might\ngenerate additional billable steps. For more information about retries and\nlong-running operations, refer to [Understand connectors](/workflows/docs/connectors).\n\nThe polling policy for the long-running operation can be configured. To set the\nconnector-specific parameters (`connector_params`), refer to\n[Invoke a connector call](/workflows/docs/reference/googleapis#invoke_a_connector_call).\n\nArguments\n---------\n\nRaised exceptions\n-----------------\n\nResponse\n--------\n\nIf successful, the response contains an instance of [`Operation`](https://cloud.google.com/workflows/docs/reference/googleapis/cloudresourcemanager/v3/Overview#Operation).\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/folders/patch). \n\n### YAML\n\n```yaml\n- patch:\n call: googleapis.cloudresourcemanager.v3.folders.patch\n args:\n name: ...\n updateMask: ...\n body:\n displayName: ...\n parent: ...\n result: patchResult\n```\n\n### JSON\n\n```json\n[\n {\n \"patch\": {\n \"call\": \"googleapis.cloudresourcemanager.v3.folders.patch\",\n \"args\": {\n \"name\": \"...\",\n \"updateMask\": \"...\",\n \"body\": {\n \"displayName\": \"...\",\n \"parent\": \"...\"\n }\n },\n \"result\": \"patchResult\"\n }\n }\n]\n```"]]