Replication Links - Failover

Служба:

SQL Database

Версия API:

2021-11-01

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

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

Параметры URI

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

Ответы

Имя	Тип	Описание
200 OK	ReplicationLink	Отработка отказа выполнена успешно.
202 Accepted		Выполняется операция отработки отказа.
Other Status Codes		Ответы об ошибках: *** 400 ReplicationLinksReplicationLinkNameIsInvalid — имя ссылки репликации должно быть допустимым идентификатором GUID. 400 GeoReplicationDatabaseNotSecondary — операция ожидает, что база данных будет целевым объектом репликации. 400 LedgerNoDropLink — георепликация не может быть остановлена, так как в базе данных включены дайджест-отправки реестра. Отключите дайджест-отправку реестра и повторите операцию. 400 CannotUseTrailingWhitespacesInDatabaseName — сбой проверки имени базы данных. 400 GeoReplicationDatabaseNotSecondary — операция ожидает, что база данных будет целевым объектом репликации. 400 CannotUseReservedDatabaseName — не удается использовать зарезервированное имя базы данных в этой операции. 400 InvalidServerName — указано недопустимое имя сервера. 400 PlannedFailoverTimedOut — пользователь вызвал плановая отработка отказа, и время ожидания истекло при попытке связаться со службой управления партнерами. 400 InvalidIdentifier — идентификатор содержит значение NULL или недопустимый символ Юникода. 400 IncorrectReplicationLinkState — операция ожидает, что база данных будет находиться в ожидаемом состоянии по каналу репликации. 404 OperationIdNotFound — операция с идентификатором не существует. 404 ResourceNotFound — запрошенный ресурс не найден. 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден. 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке. 404 OperationIdNotFound — операция с идентификатором не существует. 404 DatabaseDoesNotExist — пользователь указал имя базы данных, которое не существует в этом экземпляре сервера. 409 OperationCancelled — операция была отменена пользователем. 409 OperationInterrupted — не удалось завершить операцию с ресурсом, так как она была прервана другой операцией с тем же ресурсом. 409 InvalidOperationForDatabaseNotInReplicationRelationship — операция заполнения репликации была выполнена в базе данных, которая уже находится в связи репликации. 409 GeoReplicationCannotBecomePrimaryDuringUndo — пользователь пытался выполнить отработку отказа или принудительно завершить геосвязь, пока вторичная ссылка находится в состоянии, когда она может быть физически несоотступна и поэтому не может войти в основную роль. 409 DuplicateGeoDrRelation — базы данных уже находятся в отношении репликации. Это повторяющийся запрос. 409 UpdateSloInProgress — пользователь пытался инициировать несовместимую операцию во время обновления SLO. 409 ManagementServiceDatabaseBusy — база данных "{0}" занята другой операцией. Попробуйте выполнить операцию позже. 409 ConflictingSystemOperationInProgress — в базе данных выполняется операция обслуживания системы, и для дальнейших операций необходимо дождаться ее завершения. 409 FailoverGroupAlreadySetup — операция не может быть выполнена, так как канал георепликации является частью группы отработки отказа. Необходимо удалить базу данных из группы, чтобы завершить или выполнить отработку отказа по отдельности. 429 SubscriptionTooManyCreateUpdateRequests — запросы сверх максимального количества запросов, которые могут быть обработаны доступными ресурсами. 429 SubscriptionTooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами. 500 OperationTimedOut — время ожидания операции истекло и автоматически откатывается. Повторите операцию. 503 TooManyRequests — запросы сверх максимального числа запросов, которые могут быть обработаны доступными ресурсами.

Примеры

Planned failover of a replication link

Образец запроса

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/4891ca10-ebd0-47d7-9182-c722651780fb/failover?api-version=2021-11-01

Java

/**
 * Samples for ReplicationLinks Failover.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ReplicationLinkFailover.json
     */
    /**
     * Sample code: Planned failover of a replication link.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void plannedFailoverOfAReplicationLink(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getReplicationLinks().failover("Default", "sourcesvr", "gamma-db",
            "4891ca10-ebd0-47d7-9182-c722651780fb", 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

{
  "properties": {
    "partnerServer": "testsvr",
    "partnerDatabase": "gamma-db",
    "partnerLocation": "Japan East",
    "role": "Primary",
    "partnerRole": "Secondary",
    "replicationMode": "ASYNC",
    "startTime": "2018-06-21T08:12:43.783Z",
    "percentComplete": 100,
    "replicationState": "CATCH_UP",
    "isTerminationAllowed": true,
    "linkType": "GEO"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/4891ca10-ebd0-47d7-9182-c722651780fb",
  "name": "4891ca10-ebd0-47d7-9182-c722651780fb"
}

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

202

Определения

Имя	Описание
ReplicationLink	Ссылка репликации.
ReplicationLinkType	Тип ссылки (GEO, NAMED, STANDBY).
ReplicationRole	Роль локальной репликации.
ReplicationState	Состояние репликации (PENDING, SEEDING, CATCHUP, SUSPENDED).

ReplicationLink

Ссылка репликации.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.isTerminationAllowed	boolean	Указывает, разрешено ли пользователю завершить ссылку.
properties.linkType	ReplicationLinkType	Тип ссылки (GEO, NAMED, STANDBY).
properties.partnerDatabase	string	База данных партнера по ресурсам.
properties.partnerLocation	string	Расположение партнера по ресурсам.
properties.partnerRole	ReplicationRole	Роль репликации партнера.
properties.partnerServer	string	Сервер-партнер по ресурсам.
properties.percentComplete	integer	Процент завершения заполнения для ссылки.
properties.replicationMode	string	Режим репликации.
properties.replicationState	ReplicationState	Состояние репликации (PENDING, SEEDING, CATCHUP, SUSPENDED).
properties.role	ReplicationRole	Роль локальной репликации.
properties.startTime	string	Время создания ссылки.
type	string	Тип ресурса.

ReplicationLinkType

Тип ссылки (GEO, NAMED, STANDBY).

Имя	Тип	Описание
GEO	string
NAMED	string
STANDBY	string

ReplicationRole

Роль локальной репликации.

Имя	Тип	Описание
Copy	string
NonReadableSecondary	string
Primary	string
Secondary	string
Source	string

ReplicationState

Состояние репликации (PENDING, SEEDING, CATCHUP, SUSPENDED).

Имя	Тип	Описание
CATCH_UP	string
PENDING	string
SEEDING	string
SUSPENDED	string