CosmosDBAccountResource.FailoverPriorityChange Method

Definition

Changes the failover priority for the Azure Cosmos DB database account. A failover priority of 0 indicates a write region. The maximum value for a failover priority = (total number of regions - 1). Failover priority values must be unique for each of the regions in which the database account exists.

  • Request Path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/failoverPriorityChange
  • Operation Id: DatabaseAccounts_FailoverPriorityChange
  • Default Api Version: 2024-02-15-preview
  • Resource: CosmosDBAccountResource
public virtual Azure.ResourceManager.ArmOperation FailoverPriorityChange (Azure.WaitUntil waitUntil, Azure.ResourceManager.CosmosDB.Models.CosmosDBFailoverPolicies failoverParameters, System.Threading.CancellationToken cancellationToken = default);
abstract member FailoverPriorityChange : Azure.WaitUntil * Azure.ResourceManager.CosmosDB.Models.CosmosDBFailoverPolicies * System.Threading.CancellationToken -> Azure.ResourceManager.ArmOperation
override this.FailoverPriorityChange : Azure.WaitUntil * Azure.ResourceManager.CosmosDB.Models.CosmosDBFailoverPolicies * System.Threading.CancellationToken -> Azure.ResourceManager.ArmOperation
Public Overridable Function FailoverPriorityChange (waitUntil As WaitUntil, failoverParameters As CosmosDBFailoverPolicies, Optional cancellationToken As CancellationToken = Nothing) As ArmOperation

Parameters

waitUntil
WaitUntil

Completed if the method should wait to return until the long-running operation has completed on the service; Started if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples.

failoverParameters
CosmosDBFailoverPolicies

The new failover policies for the database account.

cancellationToken
CancellationToken

The cancellation token to use.

Returns

Exceptions

failoverParameters is null.

Applies to