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 Resource Manager или портала.
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 Не удается использоватьUseTrailingWhitespacesInDatabaseName. Ошибка проверки имени базы данных. 400 GeoReplicationDatabaseNotSecondary — операция ожидает, что база данных будет целевым объектом репликации. 400 CannotUseReservedDatabaseName— не удается использовать зарезервированное имя базы данных в этой операции. 400 InvalidServerName — указано недопустимое имя сервера. 400 PlannedFailoverTimedOut — пользователь вызвал плановую отработку отказа и истекло время ожидания при попытке связаться со службой управления партнерами. 400 InvalidIdentifier — идентификатор содержит значение NULL или недопустимый символ юникода. 400 НеправильноReplicationLinkState — операция ожидает, что база данных будет находиться в ожидаемом состоянии по ссылке репликации. 404 OperationIdNotFound — операция с идентификатором не существует. 404 ResourceNotFound — запрошенный ресурс не найден. 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке. 404 OperationIdNotFound — операция с идентификатором не существует. 404 DatabaseDoesNotExist — пользователь указал имя базы данных, которое не существует на этом экземпляре сервера. 409 OperationCancelled — операция отменена пользователем. 409 Operation Прервана — операция с ресурсом не удалось завершить, так как она была прервана другой операцией в том же ресурсе. 409 InvalidOperationForDatabaseNotInReplicationRelationship — операция заполнения репликации была выполнена в базе данных, которая уже находится в связи репликации. 409 GeoReplicationCannotBecomePrimaryDuringUndo — пользователь попытался выполнить отработку отказа или принудительно завершить геосоединение, пока вторичный находится в состоянии, где он не может быть физически согласован и поэтому не может войти в основную роль. 409 DuplicateGeoDrRelation — базы данных уже находятся в связи репликации. Это повторяющийся запрос. 409 UpdateSloInProgresss — пользователь пытался инициировать несовместимую операцию во время выполнения обновления SLO. 409 ManagementServiceDatabaseBusy — база данных "{0}" занята другой операцией. Повторите операцию позже. 409 ConflictingSystemOperationInProgresss — операция обслуживания системы выполняется в базе данных и дальнейшие операции должны ждать завершения. 409 FailoverGroupAlreadySetup — операция не может быть выполнена, так как ссылка георепликации является частью группы отработки отказа. Чтобы отдельно завершить или отработку отказа, необходимо удалить базу данных из группы. 429 SubscriptionTooManyCreateUpdateRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами. 429 SubscriptionTooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами. 500 OperationTimedOut — время ожидания операции истекло и автоматически откатился. Повторите операцию. 503 TooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами.

Имя

Тип

Описание

200 OK

ReplicationLink

Успешно выполнен отработка отказа.

202 Accepted

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

Other Status Codes

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

400 ReplicationLinksReplicationLinkNameIsInvalid — имя ссылки репликации должно быть допустимым guid.
400 GeoReplicationDatabaseNotSecondary — операция ожидает, что база данных будет целевым объектом репликации.
400 LedgerNoDropLink — георепликация не может быть остановлена, так как база данных включает дайджест-отправки реестра. Отключите дайджест-отправку реестра и повторите операцию.
400 Не удается использоватьUseTrailingWhitespacesInDatabaseName. Ошибка проверки имени базы данных.
400 GeoReplicationDatabaseNotSecondary — операция ожидает, что база данных будет целевым объектом репликации.
400 CannotUseReservedDatabaseName— не удается использовать зарезервированное имя базы данных в этой операции.
400 InvalidServerName — указано недопустимое имя сервера.
400 PlannedFailoverTimedOut — пользователь вызвал плановую отработку отказа и истекло время ожидания при попытке связаться со службой управления партнерами.
400 InvalidIdentifier — идентификатор содержит значение NULL или недопустимый символ юникода.
400 НеправильноReplicationLinkState — операция ожидает, что база данных будет находиться в ожидаемом состоянии по ссылке репликации.
404 OperationIdNotFound — операция с идентификатором не существует.
404 ResourceNotFound — запрошенный ресурс не найден.
404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден
404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке.
404 OperationIdNotFound — операция с идентификатором не существует.
404 DatabaseDoesNotExist — пользователь указал имя базы данных, которое не существует на этом экземпляре сервера.
409 OperationCancelled — операция отменена пользователем.
409 Operation Прервана — операция с ресурсом не удалось завершить, так как она была прервана другой операцией в том же ресурсе.
409 InvalidOperationForDatabaseNotInReplicationRelationship — операция заполнения репликации была выполнена в базе данных, которая уже находится в связи репликации.
409 GeoReplicationCannotBecomePrimaryDuringUndo — пользователь попытался выполнить отработку отказа или принудительно завершить геосоединение, пока вторичный находится в состоянии, где он не может быть физически согласован и поэтому не может войти в основную роль.
409 DuplicateGeoDrRelation — базы данных уже находятся в связи репликации. Это повторяющийся запрос.
409 UpdateSloInProgresss — пользователь пытался инициировать несовместимую операцию во время выполнения обновления SLO.
409 ManagementServiceDatabaseBusy — база данных "{0}" занята другой операцией. Повторите операцию позже.
409 ConflictingSystemOperationInProgresss — операция обслуживания системы выполняется в базе данных и дальнейшие операции должны ждать завершения.
409 FailoverGroupAlreadySetup — операция не может быть выполнена, так как ссылка георепликации является частью группы отработки отказа. Чтобы отдельно завершить или отработку отказа, необходимо удалить базу данных из группы.
429 SubscriptionTooManyCreateUpdateRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами.
429 SubscriptionTooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами.
500 OperationTimedOut — время ожидания операции истекло и автоматически откатился. Повторите операцию.
503 TooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами.

Примеры

Planned failover of a replication link

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


/**
 * 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	Состояние репликации (ОЖИДАНИЕ, НАЧАЛЬНОЕ ЗНАЧЕНИЕ, ПЕРЕХВАТ, ПРИОСТАНОВКА).

ReplicationLink

Object

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

Имя	Тип	Описание
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 (int32)	Процент заполнения для ссылки.
properties.replicationMode	string	Режим репликации.
properties.replicationState	ReplicationState	Состояние репликации (ОЖИДАНИЕ, НАЧАЛЬНОЕ ЗНАЧЕНИЕ, ПЕРЕХВАТ, ПРИОСТАНОВКА).
properties.role	ReplicationRole	Локальная роль репликации.
properties.startTime	string (date-time)	Время создания ссылки.
type	string	Тип ресурса.

ReplicationLinkType

Перечисление

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

Значение	Описание
GEO
NAMED
STANDBY

ReplicationRole

Перечисление

Локальная роль репликации.

Значение	Описание
Copy
NonReadableSecondary
Primary
Secondary
Source

ReplicationState

Перечисление

Состояние репликации (ОЖИДАНИЕ, НАЧАЛЬНОЕ ЗНАЧЕНИЕ, ПЕРЕХВАТ, ПРИОСТАНОВКА).

Значение	Описание
CATCH_UP
PENDING
SEEDING
SUSPENDED

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

Replication Links - Failover

Параметры URI

Ответы

Примеры

Planned failover of a replication link

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

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

Определения

ReplicationLink

ReplicationLinkType

ReplicationRole

ReplicationState

Дополнительные ресурсы