Stay organized with collections
Save and categorize content based on your preferences.
ChangeQuorum is strictly restricted to databases that use dual-region
instance configurations. Initiates a background operation to change the
quorum of a database from dual-region mode to single-region mode or vice
versa. The returned long-running operation has a name of the format
projects//instances//databases//operations/ and can be used to track
execution of the ChangeQuorum. The metadata field type is
ChangeQuorumMetadata. Authorization requires
spanner.databases.changequorum permission on the resource database.
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. Name of the database in which to apply ChangeQuorum. Values are of the form projects//instances//databases/.
[[["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.spanner.v1.projects.instances.databases.changequorum\n\n`ChangeQuorum` is strictly restricted to databases that use dual-region\ninstance configurations. Initiates a background operation to change the\nquorum of a database from dual-region mode to single-region mode or vice\nversa. The returned long-running operation has a name of the format\n`projects//instances//databases//operations/` and can be used to track\nexecution of the `ChangeQuorum`. The metadata field type is\nChangeQuorumMetadata. Authorization requires\n`spanner.databases.changequorum` permission on the resource database.\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.instances.databases/changequorum). \n\n### YAML\n\n```yaml\n- changequorum:\n call: googleapis.spanner.v1.projects.instances.databases.changequorum\n args:\n name: ...\n body:\n etag: ...\n name: ...\n quorumType:\n dualRegion: ...\n singleRegion:\n servingLocation: ...\n result: changequorumResult\n```\n\n### JSON\n\n```json\n[\n {\n \"changequorum\": {\n \"call\": \"googleapis.spanner.v1.projects.instances.databases.changequorum\",\n \"args\": {\n \"name\": \"...\",\n \"body\": {\n \"etag\": \"...\",\n \"name\": \"...\",\n \"quorumType\": {\n \"dualRegion\": \"...\",\n \"singleRegion\": {\n \"servingLocation\": \"...\"\n }\n }\n }\n },\n \"result\": \"changequorumResult\"\n }\n }\n]\n```"]]