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.
HTTP request
POST https://bigqueryreservation.googleapis.com/v1/{name=projects/*/locations/*/reservations/*}:failoverReservation
[[["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-07-02 UTC."],[[["\u003cp\u003eThis webpage details the process of failing over a reservation to a secondary location, which will then become the new primary.\u003c/p\u003e\n"],["\u003cp\u003eThe operation is performed via an HTTP POST request to a specific URL, requiring a defined resource name as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe request body for this operation must be empty, and it requires \u003ccode\u003ebigquery.reservations.update\u003c/code\u003e IAM permission.\u003c/p\u003e\n"],["\u003cp\u003eA successful request returns a \u003ccode\u003eReservation\u003c/code\u003e resource instance in the response body, detailing the updated reservation status.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this operation requires either the \u003ccode\u003ehttps://www.googleapis.com/auth/bigquery\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,[]]