Share via


Storage.StorageAccountsFailoverViaIdentity Method

Definition

A failover request can be triggered for a storage account in the event a primary endpoint becomes unavailable for any reason. The failover occurs from the storage account's primary cluster to the secondary cluster for RA-GRS accounts. The secondary cluster will become primary after failover and the account is converted to LRS. In the case of a Planned Failover, the primary and secondary clusters are swapped after failover and the account remains geo-replicated. Failover should continue to be used in the event of availability issues as Planned failover is only available while the primary and secondary endpoints are available. The primary use case of a Planned Failover is disaster recovery testing drills. This type of failover is invoked by setting FailoverType parameter to 'Planned'. Learn more about the failover options here- https://learn.microsoft.com/en-us/azure/storage/common/storage-disaster-recovery-guidance

public System.Threading.Tasks.Task StorageAccountsFailoverViaIdentity (string viaIdentity, string failoverType, Func<System.Net.Http.HttpResponseMessage,System.Threading.Tasks.Task> onOk, Microsoft.Azure.PowerShell.Cmdlets.Storage.Runtime.IEventListener eventListener, Microsoft.Azure.PowerShell.Cmdlets.Storage.Runtime.ISendAsync sender);
member this.StorageAccountsFailoverViaIdentity : string * string * Func<System.Net.Http.HttpResponseMessage, System.Threading.Tasks.Task> * Microsoft.Azure.PowerShell.Cmdlets.Storage.Runtime.IEventListener * Microsoft.Azure.PowerShell.Cmdlets.Storage.Runtime.ISendAsync -> System.Threading.Tasks.Task
Public Function StorageAccountsFailoverViaIdentity (viaIdentity As String, failoverType As String, onOk As Func(Of HttpResponseMessage, Task), eventListener As IEventListener, sender As ISendAsync) As Task

Parameters

viaIdentity
String
failoverType
String

The parameter is set to 'Planned' to indicate whether a Planned failover is requested.

onOk
Func<HttpResponseMessage,Task>

a delegate that is called when the remote service returns 200 (OK).

eventListener
IEventListener

an IEventListener instance that will receive events.

sender
ISendAsync

an instance of an Microsoft.Azure.PowerShell.Cmdlets.Storage.Runtime.ISendAsync pipeline to use to make the request.

Returns

A Task that will be complete when handling of the response is completed.

Applies to