@@ -361,10 +361,20 @@ public partial interface IStorageAccountsOperations
361
361
/// </exception>
362
362
Task < AzureOperationResponse < ListServiceSasResponse > > ListServiceSASWithHttpMessagesAsync ( string resourceGroupName , string accountName , ServiceSasParameters parameters , Dictionary < string , List < string > > customHeaders = null , CancellationToken cancellationToken = default ( CancellationToken ) ) ;
363
363
/// <summary>
364
- /// Failover request can be triggered for a storage account in case of
365
- /// availability issues. The failover occurs from the storage account's
366
- /// primary cluster to secondary cluster for RA-GRS accounts. The
367
- /// secondary cluster will become primary after failover.
364
+ /// A failover request can be triggered for a storage account in the
365
+ /// event a primary endpoint becomes unavailable for any reason. The
366
+ /// failover occurs from the storage account's primary cluster to the
367
+ /// secondary cluster for RA-GRS accounts. The secondary cluster will
368
+ /// become primary after failover and the account is converted to LRS.
369
+ /// In the case of a Planned Failover, the primary and secondary
370
+ /// clusters are swapped after failover and the account remains
371
+ /// geo-replicated. Failover should continue to be used in the event of
372
+ /// availability issues as Planned failover is only available while the
373
+ /// primary and secondary endpoints are available. The primary use case
374
+ /// of a Planned Failover is disaster recovery testing drills. This
375
+ /// type of failover is invoked by setting FailoverType parameter to
376
+ /// 'Planned'. Learn more about the failover options here-
377
+ /// https://learn.microsoft.com/en-us/azure/storage/common/storage-disaster-recovery-guidance
368
378
/// </summary>
369
379
/// <param name='resourceGroupName'>
370
380
/// The name of the resource group within the user's subscription. The
@@ -375,6 +385,10 @@ public partial interface IStorageAccountsOperations
375
385
/// group. Storage account names must be between 3 and 24 characters in
376
386
/// length and use numbers and lower-case letters only.
377
387
/// </param>
388
+ /// <param name='failoverType'>
389
+ /// The parameter is set to 'Planned' to indicate whether a Planned
390
+ /// failover is requested. Possible values include: 'Planned'
391
+ /// </param>
378
392
/// <param name='customHeaders'>
379
393
/// The headers that will be added to request.
380
394
/// </param>
@@ -387,7 +401,7 @@ public partial interface IStorageAccountsOperations
387
401
/// <exception cref="Microsoft.Rest.ValidationException">
388
402
/// Thrown when a required parameter is null
389
403
/// </exception>
390
- Task < AzureOperationResponse > FailoverWithHttpMessagesAsync ( string resourceGroupName , string accountName , Dictionary < string , List < string > > customHeaders = null , CancellationToken cancellationToken = default ( CancellationToken ) ) ;
404
+ Task < AzureOperationResponse > FailoverWithHttpMessagesAsync ( string resourceGroupName , string accountName , FailoverType ? failoverType = default ( FailoverType ? ) , Dictionary < string , List < string > > customHeaders = null , CancellationToken cancellationToken = default ( CancellationToken ) ) ;
391
405
/// <summary>
392
406
/// Live Migration of storage account to enable Hns
393
407
/// </summary>
@@ -541,10 +555,20 @@ public partial interface IStorageAccountsOperations
541
555
/// </exception>
542
556
Task < AzureOperationResponse < StorageAccount > > BeginCreateWithHttpMessagesAsync ( string resourceGroupName , string accountName , StorageAccountCreateParameters parameters , Dictionary < string , List < string > > customHeaders = null , CancellationToken cancellationToken = default ( CancellationToken ) ) ;
543
557
/// <summary>
544
- /// Failover request can be triggered for a storage account in case of
545
- /// availability issues. The failover occurs from the storage account's
546
- /// primary cluster to secondary cluster for RA-GRS accounts. The
547
- /// secondary cluster will become primary after failover.
558
+ /// A failover request can be triggered for a storage account in the
559
+ /// event a primary endpoint becomes unavailable for any reason. The
560
+ /// failover occurs from the storage account's primary cluster to the
561
+ /// secondary cluster for RA-GRS accounts. The secondary cluster will
562
+ /// become primary after failover and the account is converted to LRS.
563
+ /// In the case of a Planned Failover, the primary and secondary
564
+ /// clusters are swapped after failover and the account remains
565
+ /// geo-replicated. Failover should continue to be used in the event of
566
+ /// availability issues as Planned failover is only available while the
567
+ /// primary and secondary endpoints are available. The primary use case
568
+ /// of a Planned Failover is disaster recovery testing drills. This
569
+ /// type of failover is invoked by setting FailoverType parameter to
570
+ /// 'Planned'. Learn more about the failover options here-
571
+ /// https://learn.microsoft.com/en-us/azure/storage/common/storage-disaster-recovery-guidance
548
572
/// </summary>
549
573
/// <param name='resourceGroupName'>
550
574
/// The name of the resource group within the user's subscription. The
@@ -555,6 +579,10 @@ public partial interface IStorageAccountsOperations
555
579
/// group. Storage account names must be between 3 and 24 characters in
556
580
/// length and use numbers and lower-case letters only.
557
581
/// </param>
582
+ /// <param name='failoverType'>
583
+ /// The parameter is set to 'Planned' to indicate whether a Planned
584
+ /// failover is requested. Possible values include: 'Planned'
585
+ /// </param>
558
586
/// <param name='customHeaders'>
559
587
/// The headers that will be added to request.
560
588
/// </param>
@@ -567,7 +595,7 @@ public partial interface IStorageAccountsOperations
567
595
/// <exception cref="Microsoft.Rest.ValidationException">
568
596
/// Thrown when a required parameter is null
569
597
/// </exception>
570
- Task < AzureOperationResponse > BeginFailoverWithHttpMessagesAsync ( string resourceGroupName , string accountName , Dictionary < string , List < string > > customHeaders = null , CancellationToken cancellationToken = default ( CancellationToken ) ) ;
598
+ Task < AzureOperationResponse > BeginFailoverWithHttpMessagesAsync ( string resourceGroupName , string accountName , FailoverType ? failoverType = default ( FailoverType ? ) , Dictionary < string , List < string > > customHeaders = null , CancellationToken cancellationToken = default ( CancellationToken ) ) ;
571
599
/// <summary>
572
600
/// Live Migration of storage account to enable Hns
573
601
/// </summary>
0 commit comments