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

# POST /v1/{+name}:failoverReservation

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

Fail over a reservation to the secondary location. The operation should be done in the current secondary location, which will be promoted to the new primary location for the reservation. Attempting to failover a reservation in the current primary location will fail with the error code `google.rpc.Code.FAILED_PRECONDITION`.

## Path parameters

- `name` string, required

## Request body

- FailoverReservationRequest — The request for ReservationService.FailoverReservation.
  - `failoverMode` 'FAILOVER_MODE_UNSPECIFIED' | 'SOFT' | 'HARD' — Optional. A parameter that determines how writes that are pending replication are handled after a failover is initiated. If not specified, HARD failover mode is used by default.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/bigqueryreservation.md) · [All operations](https://skmtc.dev/google/apis/bigqueryreservation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/bigqueryreservation/revisions/3502c38ecee3/schema)