databases.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/<project>/instances/<instance>/databases/<database>/operations/<operationId>
and can be used to track execution of the databases.changequorum
. The metadata field type is ChangeQuorumMetadata
.
Authorization requires spanner.databases.changequorum
permission on the resource database.
HTTP request
POST https://spanner.googleapis.com/v1/{name=projects/*/instances/*/databases/*}:changequorum
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
name |
Required. Name of the database in which to apply Authorization requires the following IAM permission on the specified resource
|
Request body
The request body contains data with the following structure:
JSON representation |
---|
{
"quorumType": {
object ( |
Fields | |
---|---|
quorum |
Required. The type of this quorum. |
etag |
Optional. The etag is the hash of the 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 body
If successful, the response body contains an instance of Operation
.
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/spanner.admin
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.