Stay organized with collections
Save and categorize content based on your preferences.
Updates an instance configuration. The returned long-running operation
can be used to track the progress of updating the instance. If the named
instance configuration does not exist, returns NOT_FOUND. Only
user-managed configurations can be updated. Immediately after the
request returns: * The instance configuration's reconciling field is set
to true. While the operation is pending: * Cancelling the operation sets
its metadata's cancel_time. The operation is guaranteed to succeed at
undoing all changes, after which point it terminates with a CANCELLED
status. * All other attempts to modify the instance configuration are
rejected. * Reading the instance configuration via the API continues to
give the pre-request values. Upon completion of the returned operation:
* Creating instances using the instance configuration uses the new
values. * The new values of the instance configuration are readable via
the API. * The instance configuration's reconciling field becomes false.
The returned long-running operation will have a name of the format
/operations/ and can be used to track the instance configuration
modification. The metadata field type is UpdateInstanceConfigMetadata.
The response field type is InstanceConfig, if successful. Authorization
requires spanner.instanceConfigs.update permission on the resource
name.
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.
The connector uses polling to monitor the long-running operation, which might
generate additional billable steps. The polling policy for the long-running
operation can be configured. For example, if you set skip_polling to True,
the connector invocation call is non-blocking if the initial request succeeds;
otherwise, retries might occur.
For more information about connector-specific parameters (connector_params),
see Invoke a connector call.
For more information about retries and long-running operations, see
Understand connectors.
Arguments
Parameters
name
string
Required. A unique identifier for the instance configuration. Values are of the form projects//instanceConfigs/a-z*. User instance configuration must start with custom-.
[[["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.spanner.v1.projects.instanceConfigs.patch\n\nUpdates an instance configuration. The returned long-running operation\ncan be used to track the progress of updating the instance. If the named\ninstance configuration does not exist, returns `NOT_FOUND`. Only\nuser-managed configurations can be updated. Immediately after the\nrequest returns: \\* The instance configuration's reconciling field is set\nto true. While the operation is pending: \\* Cancelling the operation sets\nits metadata's cancel_time. The operation is guaranteed to succeed at\nundoing all changes, after which point it terminates with a `CANCELLED`\nstatus. \\* All other attempts to modify the instance configuration are\nrejected. \\* Reading the instance configuration via the API continues to\ngive the pre-request values. Upon completion of the returned operation:\n\\* Creating instances using the instance configuration uses the new\nvalues. \\* The new values of the instance configuration are readable via\nthe API. \\* The instance configuration's reconciling field becomes false.\nThe returned long-running operation will have a name of the format\n`/operations/` and can be used to track the instance configuration\nmodification. The metadata field type is UpdateInstanceConfigMetadata.\nThe response field type is InstanceConfig, if successful. Authorization\nrequires `spanner.instanceConfigs.update` permission on the resource\nname.\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.\n\nThe connector uses polling to monitor the long-running operation, which might\ngenerate additional billable steps. The polling policy for the long-running\noperation can be configured. For example, if you set `skip_polling` to `True`,\nthe connector invocation call is non-blocking if the initial request succeeds;\notherwise, retries might occur.\n\nFor more information about connector-specific parameters (`connector_params`),\nsee [Invoke a connector call](/workflows/docs/reference/googleapis#invoke_a_connector_call).\n\nFor more information about retries and long-running operations, see\n[Understand connectors](/workflows/docs/connectors).\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/spanner/v1/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/spanner/docs/reference/rest/v1/projects.instanceConfigs/patch). \n\n### YAML\n\n```yaml\n- patch:\n call: googleapis.spanner.v1.projects.instanceConfigs.patch\n args:\n name: ...\n body:\n instanceConfig:\n baseConfig: ...\n displayName: ...\n etag: ...\n labels: ...\n leaderOptions: ...\n name: ...\n replicas: ...\n updateMask: ...\n validateOnly: ...\n result: patchResult\n```\n\n### JSON\n\n```json\n[\n {\n \"patch\": {\n \"call\": \"googleapis.spanner.v1.projects.instanceConfigs.patch\",\n \"args\": {\n \"name\": \"...\",\n \"body\": {\n \"instanceConfig\": {\n \"baseConfig\": \"...\",\n \"displayName\": \"...\",\n \"etag\": \"...\",\n \"labels\": \"...\",\n \"leaderOptions\": \"...\",\n \"name\": \"...\",\n \"replicas\": \"...\"\n },\n \"updateMask\": \"...\",\n \"validateOnly\": \"...\"\n }\n },\n \"result\": \"patchResult\"\n }\n }\n]\n```"]]