Databases - Failover

Service:

SQL Database

API Version:

2021-11-01

Feladatátvétel egy adatbázist.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
databaseName	path	True	string	A feladatátvételre kijelölt adatbázis neve.
resourceGroupName	path	True	string	Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.
serverName	path	True	string	A kiszolgáló neve.
subscriptionId	path	True	string	Az Azure-előfizetést azonosító előfizetés-azonosító.
api-version	query	True	string	A kéréshez használandó API-verzió.
replicaType	query		ReplicaType	A feladatátvételre kijelölt replika típusa.

Válaszok

Name	Típus	Description
200 OK		Az adatbázis feladatátvétele sikeresen befejeződött.
202 Accepted		Az adatbázis feladatátvétele folyamatban van.
Other Status Codes		Hibaválaszok: *** 400 ManagementServiceFeatureDisabled – A felhasználó letiltott funkciót próbált használni. 400 DatabaseFailoverThrottled – Nemrégiben történt feladatátvétel az adatbázison vagy a készleten, ha az adatbázis rugalmas készletbe tartozik. 400 DatabaseFailoverNotSupportedOnSKU – Ez az ügyfél által kezdeményezett feladatátvételi típus nem támogatott az adott termékváltozaton. 409 ManagementServiceDatabaseBusy – A(z) adatbázis{0} egy másik művelettel van elfoglalva. Próbálkozzon később a művelettel. 409 DatabaseNotInStateToFailover – Az adatbázis jelenleg olyan állapotban van, hogy a feladatátvétel nem hajtható végre.

Példák

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

Definíciók

ReplicaType

A feladatátvételre kijelölt replika típusa.

Name	Típus	Description
Primary	string
ReadableSecondary	string