---
title: "POST /#Action=FailoverGlobalCluster"
method: POST
path: "/#Action=FailoverGlobalCluster"
---

# POST /#Action=FailoverGlobalCluster

`POST /#Action=FailoverGlobalCluster`

Initiates the failover process for a Neptune global database.

A failover for a Neptune global database promotes one of secondary read-only DB clusters to be the primary DB cluster and demotes the primary DB cluster to being a secondary (read-only) DB cluster. In other words, the role of the current primary DB cluster and the selected target secondary DB cluster are switched. The selected secondary DB cluster assumes full read/write capabilities for the Neptune global database.

This action applies **only** to Neptune global databases. This action is only intended for use on healthy Neptune global databases with healthy Neptune DB clusters and no region-wide outages, to test disaster recovery scenarios or to reconfigure the global database topology.

## Query parameters

- `Action` 'FailoverGlobalCluster', required
- `Version` '2014-10-31', required

## Response `200`

Success

## Other responses

- `480` — GlobalClusterNotFoundFault
- `481` — InvalidGlobalClusterStateFault
- `482` — InvalidDBClusterStateFault
- `483` — DBClusterNotFoundFault

---

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