Databases - Failover

Service:

SQL Database

API Version:

2021-11-01

Przełączanie bazy danych w tryb failover.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?api-version=2021-11-01

With optional parameters:

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/failover?replicaType={replicaType}&api-version=2021-11-01

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
databaseName	path	True	string	Nazwa bazy danych do przejścia w tryb failover.
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager lub portalu.
serverName	path	True	string	Nazwa serwera.
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.
replicaType	query		ReplicaType	Typ repliki do przełączenia w tryb failover.

Odpowiedzi

Nazwa	Typ	Opis
200 OK		Pomyślnie ukończono tryb failover bazy danych.
202 Accepted		Tryb failover bazy danych jest w toku.
Other Status Codes		Odpowiedzi na błędy: *** 400 ManagementServiceFeatureDisabled — użytkownik próbował użyć funkcji, która jest wyłączona. 400 DatabaseFailoverThrottled — ostatnio przełączono bazę danych lub pulę w tryb failover, jeśli baza danych należy do elastycznej puli. 400 DatabaseFailoverNotSupportedOnSKU — ten typ trybu failover zainicjowanego przez klienta nie jest obsługiwany w danej jednostce SKU. 409 ManagementServiceDatabaseBusy — baza danych "{0}" jest zajęta inną operacją. Spróbuj wykonać operację później. 409 DatabaseNotInStateToFailover — baza danych jest obecnie w stanie, w którym nie można wydać trybu failover.

Przykłady

Failover an database

Sample Request

HTTP

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=2021-11-01

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.ReplicaType;

/** Samples for Databases Failover. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/FailoverDatabase.json
     */
    /**
     * Sample code: Failover an database.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void failoverAnDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabases().failover("group1", "testServer", "testDatabase",
            ReplicaType.PRIMARY, Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

Status code:

202

Definicje

ReplicaType

Typ repliki do przełączenia w tryb failover.

Nazwa	Typ	Opis
Primary	string
ReadableSecondary	string