Databases - Failover

Ссылка

Служба:: SQL Database

Версия API:: 2021-11-01

Отработка отказа базы данных.

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

С использованием необязательных параметров:

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

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

Ответы

Имя	Тип	Описание
200 OK		Отработка отказа базы данных успешно завершена.
202 Accepted		Выполняется отработка отказа базы данных.
Other Status Codes		Ответы на ошибки: *** 400 ManagementServiceFeatureDisabled — пользователь попытался использовать отключенную функцию. 400 DatabaseFailoverThrottled — недавняя отработка отказа в базе данных или пуле, если база данных принадлежит эластичному пулу. 400 DatabaseFailoverNotSupportedOnSKU — этот тип отработки отказа, инициированной клиентом, не поддерживается для заданного номера SKU. 409 ManagementServiceDatabaseBusy — база данных "{0}" занята другой операцией. Попробуйте выполнить операцию позже. 409 DatabaseNotInStateToFailover — база данных в настоящее время находится в состоянии, которое не может быть выполнена отработка отказа.

Имя

Тип

Описание

200 OK

Отработка отказа базы данных успешно завершена.

202 Accepted

Выполняется отработка отказа базы данных.

Other Status Codes

Ответы на ошибки: ***

400 ManagementServiceFeatureDisabled — пользователь попытался использовать отключенную функцию.
400 DatabaseFailoverThrottled — недавняя отработка отказа в базе данных или пуле, если база данных принадлежит эластичному пулу.
400 DatabaseFailoverNotSupportedOnSKU — этот тип отработки отказа, инициированной клиентом, не поддерживается для заданного номера SKU.
409 ManagementServiceDatabaseBusy — база данных "{0}" занята другой операцией. Попробуйте выполнить операцию позже.
409 DatabaseNotInStateToFailover — база данных в настоящее время находится в состоянии, которое не может быть выполнена отработка отказа.

Примеры

Failover an database

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


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, com.azure.core.util.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

Пример ответа

Код состояния:: 200

Код состояния:: 202

Определения

ReplicaType

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

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

Поделиться через