---
title: "POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}/failover"
method: POST
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}/failover"
tags: ["EHNamespaces"]
---

# POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}/failover

`POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}/failover`

## Request

- Base URL: `https://management.azure.com`
- URL: `https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}/failover`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `user_impersonation`

GeoDR Failover

## Path parameters

- `namespaceName` string, required

## Parameters

- `../../../../../../common-types/resource-management/v3/types.json#/components/parameters/ApiVersionParameter` (unresolved $ref)
- `../../../../../../common-types/resource-management/v3/types.json#/components/parameters/SubscriptionIdParameter` (unresolved $ref)
- `../../../../../../common-types/resource-management/v3/types.json#/components/parameters/ResourceGroupNameParameter` (unresolved $ref)

## Request body

- FailOver
  - `properties` FailOverProperties
    - `primaryLocation` string: Query parameter for the new primary location after failover.
    - `force` boolean: If Force is false then graceful failover is attempted after ensuring no data loss. If Force flag is set to true, Forced failover is attempted with possible data loss.

## Response `202`

Resource operation accepted.

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/azure/apis/eventhubmanagementclient.md) - [All operations](https://skmtc.dev/azure/apis/eventhubmanagementclient/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/eventhubmanagementclient/revisions/122d63fca4a7?raw)