Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Databases - Failover
Dienst:
SQL Database
API-Version:
2023-08-01
Failovert eine Datenbank.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?api-version=2023-08-01
Mit optionalen Parametern:
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?replicaType={replicaType}&api-version=2023-08-01
URI-Parameter
Name
In
Erforderlich
Typ
Beschreibung
databaseName
path
True
string
Der Name der Datenbank, die failovern soll.
resourceGroupName
path
True
string
Der Name der Ressourcengruppe, die die Ressource enthält. Sie können diesen Wert aus der Azure Resource Manager-API oder dem Portal abrufen.
serverName
path
True
string
Der Name des Servers.
subscriptionId
path
True
string
Die Abonnement-ID, die ein Azure-Abonnement identifiziert.
api-version
query
True
string
Die API-Version, die für die Anforderung verwendet werden soll.
400 DatabaseFailoverNotSupportedOnSKU – Dieser Typ von vom Kunden initiiertes Failover wird für die angegebene SKU nicht unterstützt.
400 DatabaseFailoverThrottled – Es gab ein kürzlich ausgeführtes Failover in der Datenbank oder im Pool, wenn die Datenbank zu einem elastischen Pool gehört.
400 ManagementServiceFeatureDisabled – Der Benutzer hat versucht, ein Feature zu verwenden, das deaktiviert ist.
404 OperationIdNotFound – Der Vorgang mit der ID ist nicht vorhanden.
409 DatabaseNotInStateToFailover – Die Datenbank befindet sich derzeit in einem Zustand, sodass kein Failover ausgegeben werden kann.
409 ManagementServiceDatabaseBusy - Datenbank '{0}' ist mit einem anderen Vorgang beschäftigt. Versuchen Sie es bitte später.
409 CannotCancelOperation – Der Verwaltungsvorgang befindet sich in einem Zustand, der nicht abgebrochen werden kann.
409 OperationCancelled – Der Vorgang wurde vom Benutzer abgebrochen.
409 OperationInterrupted – Der Vorgang für die Ressource konnte nicht abgeschlossen werden, weil er durch einen anderen Vorgang in derselben Ressource unterbrochen wurde.
429 SubscriptionTooManyCreateUpdateRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.
429 SubscriptionTooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.
500 OperationTimedOut – Timeout des Vorgangs und automatisches Zurücksetzen. Versuchen Sie den Vorgang erneut.
503 TooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.
POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/testServer/databases/testDatabase/failover?replicaType=Primary&api-version=2023-08-01
using Azure;
using Azure.ResourceManager;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Models;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;
// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/FailoverDatabase.json
// this example is just showing the usage of "Databases_Failover" operation, for the dependent resources, they will have to be created separately.
// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);
// this example assumes you already have this SqlDatabaseResource created on azure
// for more information of creating SqlDatabaseResource, please refer to the document of SqlDatabaseResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "group1";
string serverName = "testServer";
string databaseName = "testDatabase";
ResourceIdentifier sqlDatabaseResourceId = SqlDatabaseResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, databaseName);
SqlDatabaseResource sqlDatabase = client.GetSqlDatabaseResource(sqlDatabaseResourceId);
// invoke the operation
ReplicaType? replicaType = ReplicaType.Primary;
await sqlDatabase.FailoverAsync(WaitUntil.Completed, replicaType: replicaType);
Console.WriteLine("Succeeded");