故障轉移受控實例。
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
URI 參數
名稱 |
位於 |
必要 |
類型 |
Description |
managedInstanceName
|
path |
True
|
string
|
要故障轉移的受控實例名稱。
|
resourceGroupName
|
path |
True
|
string
|
包含資源的資源群組名稱。 您可以從 Azure 資源管理員 API 或入口網站取得這個值。
|
subscriptionId
|
path |
True
|
string
|
可識別 Azure 訂用帳戶的訂用帳戶識別碼。
|
api-version
|
query |
True
|
string
|
要用於要求的 API 版本。
|
replicaType
|
query |
|
ReplicaType
|
要故障轉移的複本類型。
|
回應
名稱 |
類型 |
Description |
200 OK
|
|
成功完成受控實例故障轉移。
|
202 Accepted
|
|
受控實例故障轉移正在進行中。
|
Other Status Codes
|
|
錯誤回應: ≦
400 ManagedInstanceFailoverThrottled - 受控實例上有最近的故障轉移。
400 ManagedInstanceFailoverNotSupportedOnSKU - 指定 SKU 不支援這種類型的客戶起始故障轉移。
404 SubscriptionDoesNotHaveServer - 找不到要求的伺服器
404 ServerNotInSubscriptionResourceGroup - 指定的伺服器不存在於指定的資源群組和訂用帳戶中。
404 OperationIdNotFound - 標識符為的作業不存在。
409 ManagedInstanceFailoverFullBackupMissing - 自動備份必須完成新資料庫的第一個完整備份。
409 ManagedInstanceNotInStateToFailover - 受控實例目前處於無法發出故障轉移的狀態。
409 OperationCancelled - 使用者已取消作業。
409 OperationInterrupted - 無法完成資源上的作業,因為它被相同資源上的另一個作業中斷。
429 SubscriptionTooManyCreateUpdateRequests - 超出可用資源可處理之最大要求的要求。
429 SubscriptionTooManyRequests - 超出可用資源可處理的最大要求。
500 OperationTimedOut - 作業逾時並自動回復。 請重試該作業。
503 TooManyRequests - 超出可用資源可處理之最大要求的要求。
|
範例
Failover a managed instance.
Sample Request
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
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
定義
ReplicaType
要故障轉移的複本類型。
名稱 |
類型 |
Description |
Primary
|
string
|
|
ReadableSecondary
|
string
|
|