Databases - Failover

Service:

SQL Database

API Version:

2021-11-01

Failover database.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
databaseName	path	True	string	Nama database untuk failover.
resourceGroupName	path	True	string	Nama grup sumber daya yang berisi sumber daya. Anda dapat memperoleh nilai ini dari Azure Resource Manager API atau portal.
serverName	path	True	string	Nama server.
subscriptionId	path	True	string	ID langganan yang mengidentifikasi langganan Azure.
api-version	query	True	string	Versi API yang digunakan untuk permintaan.
replicaType	query		ReplicaType	Jenis replika yang akan di-failover.

Respons

Nama	Jenis	Deskripsi
200 OK		Berhasil menyelesaikan failover database.
202 Accepted		Kegagalan database sedang berlangsung.
Other Status Codes		Respons Kesalahan: *** 400 ManagementServiceFeatureDisabled - Pengguna mencoba menggunakan fitur yang dinonaktifkan. 400 DatabaseFailoverThrottled - Ada failover terbaru pada database atau kumpulan jika database berada dalam kumpulan elastis. 400 DatabaseFailoverNotSupportedOnSKU - Jenis failover yang dimulai pelanggan ini tidak didukung pada SKU yang diberikan. 409 ManagementServiceDatabaseBusy - Database '{0}' sibuk dengan operasi lain. Silakan coba operasi Anda nanti. 409 DatabaseNotInStateToFailover - Database saat ini dalam keadaan sehingga failover tidak dapat dikeluarkan.

Contoh

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

Definisi

ReplicaType

Jenis replika yang akan di-failover.

Nama	Jenis	Deskripsi
Primary	string
ReadableSecondary	string