---
title: "POST /v1/{+name}:changequorum"
method: POST
path: "/v1/{+name}:changequorum"
tags: ["projects"]
---

# POST /v1/{+name}:changequorum

`POST /v1/{+name}:changequorum`

`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.

## Path parameters

- `name` string, required

## Request body

- ChangeQuorumRequest — The request for ChangeQuorum.
  - `name` string — Required. Name of the database in which to apply `ChangeQuorum`. Values are of the form `projects//instances//databases/`.
  - `quorumType` QuorumType — Information about the database quorum type. This only applies to dual-region instance configs.
    - `singleRegion` SingleRegionQuorum — Message type for a single-region quorum.
      - `servingLocation` string — Required. The location of the serving region, for example, "us-central1". The location must be one of the regions within the dual-region instance configuration of your database. The list of valid locations is available using the GetInstanceConfig API. This should only be used if you plan to change quorum to the single-region quorum type.
    - `dualRegion` DualRegionQuorum — Message type for a dual-region quorum. Currently this type has no options.
  - `etag` string — Optional. The etag is the hash of the `QuorumInfo`. The `ChangeQuorum` operation is only performed if the etag matches that of the `QuorumInfo` in the current database resource. Otherwise the API returns an `ABORTED` error. The etag is used for optimistic concurrency control as a way to help prevent simultaneous change quorum requests that could create a race condition.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/spanner.md) · [All operations](https://skmtc.net/google/apis/spanner/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/spanner/versions/4b66067d2622/schema)