Managed Instances - Failover

Service:

SQL Database

API Version:

2021-11-01

Failover instans terkelola.

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

With optional parameters:

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
managedInstanceName	path	True	string	Nama instans terkelola 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.
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 instans terkelola.
202 Accepted		Failover instans terkelola sedang berlangsung.
Other Status Codes		Respons Kesalahan: *** 400 ManagedInstanceFailoverThrottled - Ada failover terbaru pada instans terkelola. 400 ManagedInstanceFailoverNotSupportedOnSKU - Jenis failover yang dimulai pelanggan ini tidak didukung pada SKU yang diberikan. 404 SubscriptionDoesNotHaveServer - Server yang diminta tidak ditemukan 404 ServerNotInSubscriptionResourceGroup - Server yang ditentukan tidak ada di grup sumber daya dan langganan yang ditentukan. 404 OperationIdNotFound - Operasi dengan Id tidak ada. 409 ManagedInstanceFailoverFullBackupMissing - Pencadangan otomatis perlu menyelesaikan pencadangan penuh pertama untuk database baru. 409 ManagedInstanceNotInStateToFailover - Instans terkelola saat ini dalam keadaan sehingga failover tidak dapat dikeluarkan. 409 OperationCancelled - Operasi telah dibatalkan oleh pengguna. 409 OperationInterrupted - Operasi pada sumber daya tidak dapat diselesaikan karena terganggu oleh operasi lain pada sumber daya yang sama. 429 SubscriptionTooManyCreateUpdateRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 429 SubscriptionTooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 500 OperationTimedOut - Waktu operasi habis dan secara otomatis digulung balik. Coba lagi operasi ini. 503 TooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

Contoh

Failover a managed instance.

Sample Request

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/managedInstances/instanceName/failover?replicaType=Primary&api-version=2021-11-01

Java

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

/** Samples for ManagedInstances Failover. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/FailoverManagedInstance.json
     */
    /**
     * Sample code: Failover a managed instance.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void failoverAManagedInstance(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstances().failover("group1", "instanceName",
            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