Managed Instances - Failover

Service:

SQL Database

API Version:

2021-11-01

Выполняет отработку отказа управляемого экземпляра.

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

Имя	В	Обязательно	Тип	Описание
managedInstanceName	path	True	string	Имя управляемого экземпляра для отработки отказа.
resourceGroupName	path	True	string	Имя группы ресурсов, к которой относится ресурс. Это значение можно получить от API-интерфейса диспетчера ресурсов Azure или портала.
subscriptionId	path	True	string	Идентификатор подписки Azure.
api-version	query	True	string	Версия API для использования в запросе.
replicaType	query		ReplicaType	Тип реплика для отработки отказа.

Ответы

Имя	Тип	Описание
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

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

Определения

ReplicaType

Тип реплика для отработки отказа.

Имя	Тип	Описание
Primary	string
ReadableSecondary	string