Failover Groups - List By Server

Перечисляет группы отработки отказа на сервере.

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

Параметры URI

Имя В Обязательно Тип Описание
resourceGroupName
path True

string

Имя группы ресурсов, к которой относится ресурс. Это значение можно получить от API-интерфейса диспетчера ресурсов Azure или портала.

serverName
path True

string

Имя сервера, содержащего группу отработки отказа.

subscriptionId
path True

string

Идентификатор подписки Azure.

api-version
query True

string

Версия API для использования в запросе.

Ответы

Имя Тип Описание
200 OK

FailoverGroupListResult

Группы отработки отказа успешно получены.

Other Status Codes

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

  • 400 FailoverGroupCreateOrUpdateRequestInvalidDatabases — предоставленные идентификаторы баз данных не являются правильно созданными идентификаторами ресурсов базы данных. Пример правильного форматирования см. в разделе https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 FailoverGroupCreateOrUpdateRequestInvalidPartner — заданное поле партнеров в тексте запроса на создание или обновление группы отработки отказа пустое или недопустимое. Укажите допустимое значение этого поля. Примеры правильно отформатированных запросов см. в разделе https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 FailoverGroupCreateOrUpdateRequestDuplicatePartner — один или несколько из предоставленных серверов-партнеров уже входят в группу отработки отказа. Убедитесь, что сервер-источник и все серверы партнеров являются уникальными.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidDatabaseServer — одна или несколько предоставленных баз данных не существуют на сервере-источнике группы отработки отказа. Убедитесь, что все базы данных существуют на сервере-источнике.

  • 400 FailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount — поддерживается только один сервер-партнер для группы отработки отказа. Измените запрос соответствующим образом. Примеры допустимых запросов см. в разделе https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint — поле readWriteEndpoint требуется для создания или обновления запросов.

  • 400 FailoverGroupCreateOrUpdateRequestInvalid — текст запроса группы создания или обновления является пустым или недопустимым.

  • 400 FailoverGroupUpdateOrDeleteRequestOnSecondary — изменения группы отработки отказа не допускаются на сервере-получателе. Выполните запрос на сервере-источнике.

  • 400 FailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues — значение льготного периода для конечной точки чтения и записи должно быть неотрицательным.

  • 400 FailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues — значение льготного периода для группы отработки отказа должно быть больше или равно минимальному льготному периоду в{0} минутах

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields — свойство failoverWithDataLossGracePeriodMinutes должно быть указано при выборе политики отработки отказа Автоматически для конечной точки чтения и записи.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy — поле failoverPolicy для конечной точки чтения и записи требуется для запросов на создание или обновление.

  • 400 FailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy — значение льготного периода не должно предоставляться при выборе политики отработки отказа вручную для конечной точки чтения и записи. Удалите его из запроса.

  • 400 FailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified — текст запроса группы создания или обновления не должен изменять свойство только для чтения "{0}".

  • 400 FailoverGroupFailoverRequestOnPrimary — запрос отработки отказа должен быть инициирован на сервере-получателе группы отработки отказа.

  • 400 FailoverGroupPartnerServerFromDifferentSubscription — сервер-источник и серверы-партнеры группы отработки отказа относятся к разным подпискам. Перекрестная подписка для серверов группы отработки отказа не допускается.

  • 400 InvalidAddSecondaryPermission — пользователь не имеет достаточных разрешений для добавления вторичной базы данных на указанном сервере.

  • 400 InvalidSku — пользователь указал недопустимый номер SKU.

  • 400 ServerNotFound — запрошенный сервер не найден.

  • 400 FeatureDisabledOnSelectedEdition — пользователь попытался использовать функцию, которая отключена в текущем выпуске базы данных.

  • 400 TokenTooLong — предоставленный маркер слишком длинный.

  • 400 InvalidTargetSubregion — целевой сервер нечитаемой вторичной базы данных не находится в парном регионе Azure для аварийного восстановления.

  • 400 PartnerServerNotCompatible — пользователь пытается скопировать базу данных с сервера SAWA V1 на сервер Sterling или наоборот.

  • 400 IncorrectReplicationLinkState — операция ожидает, что база данных будет находиться в ожидаемом состоянии по каналу репликации.

  • 400 ResourcePoolNotFound — указанный эластичный пул не существует на указанном логическом сервере.

  • 400 AzureKeyVaultKeyDisabled — не удалось выполнить операцию на сервере, так как ключ Key Vault Azure отключен.

  • 400 AzureKeyVaultInvalidExpirationDate — не удалось выполнить операцию, так как срок действия ключа Key Vault Azure недопустим.

  • 400 SecurityAzureKeyVaultUrlNullOrEmpty — не удалось выполнить операцию, так как URI Key Vault Azure имеет значение NULL или пусто.

  • 400 AzureKeyVaultNoServerIdentity — удостоверение сервера настроено неправильно.

  • 400 AzureKeyVaultInvalidUri — недопустимый ответ от Key Vault Azure. Используйте допустимый URI Key Vault Azure.

  • 400 AzureKeyVaultMissingPermissions — на сервере отсутствуют необходимые разрешения на Key Vault Azure.

  • 400 SecurityAzureKeyVaultInvalidKeyName — не удалось выполнить операцию из-за недопустимого имени ключа сервера.

  • 400 PlannedFailoverTimedOutForDatabase — пользователь вызвал плановая отработка отказа, истекло время ожидания, и определенная база данных, как представляется, blame.

  • 400 PlannedFailoverTimedOut — пользователь вызвал плановая отработка отказа, и время ожидания истекло при попытке связаться со службой управления партнерами.

  • 400 AdalGenericError — не удалось выполнить операцию, так как возникла ошибка Azure Active Directory.

  • 400 AdalServicePrincipalNotFound — не удалось выполнить операцию, так как обнаружена ошибка субъект-служба библиотеки Azure Active Directory не найдена.

  • 400 AzureKeyVaultMalformedVaultUri — указанный URI Key Vault недопустим.

  • 400 CannotUseReservedDatabaseName — не удается использовать зарезервированное имя базы данных в этой операции.

  • 400 InvalidFailoverGroupRegion — серверы, указанные в группе отработки отказа, должны находиться в разных регионах для обеспечения изоляции.

  • 400 FailoverGroupDoesNotExist — группа отработки отказа не существует на сервере.

  • 400 FailoverGroupNotSecondary — отработка отказа не может быть инициирована с сервера-источника в группе отработки отказа.

  • 400 InvalidServerName — указано недопустимое имя сервера.

  • 400 DatabaseInFailoverGroupNotPrimary — ссылка GeoDR для базы данных уже существует, но ее роль не является первичной или не является ссылкой непрерывного копирования.

  • 400 SecurityAdalPrincipalCertExpiredError — не удалось выполнить операцию, так как срок действия сертификата субъекта Key Vault Azure истек.

  • 400 UnableToCreateFailoverGroupDueToTableAuditing — группа отработки отказа не может быть создана для сервера с включенным аудитом таблиц.

  • 400 InvalidIdentifier — идентификатор содержит значение NULL или недопустимый символ Юникода.

  • 400 UnableToAddDbWithTableAuditingToFailoverGroup — база данных с включенным аудитом таблиц будет недоступна через конечную точку группы отработки отказа.

  • 400 SecurityInvalidAzureKeyVaultRecoveryLevel — указанный URI Key Vault недопустим.

  • 400 KeyMaterialNotFoundOnRemoteServer — удаленный сервер не имеет доступа к материалу ключа, используемому в качестве предохранителя TDE.

  • 400 LimitOfFailoverGroupsPerServerExceeded — создание группы отработки отказа превысит допустимое количество групп отработки отказа на сервер.

  • 400 SameKeyUriNotFoundOnRemoteServer — сервер-получатель не имеет материала ключа из того же хранилища ключей, что и предохранитель шифрования основного сервера с включенной автоматической сменой ключей.

  • 400 AzureKeyVaultRsaKeyNotSupported — предоставленное хранилище ключей использует неподдерживаемый размер ключа RSA или тип ключа. Поддерживаемый размер ключа RSA — 2048 или 3072, а тип ключа — RSA или RSA-HSM.

  • 400 SameKeyMaterialNotFoundOnRemoteServer — сервер-получатель не имеет материала ключа предохранителя шифрования основного сервера.

  • 400 GeoReplicationDatabaseNotSecondary — операция ожидает, что база данных будет целевым объектом репликации.

  • 400 GeoReplicaLimitReached — достигнут предел репликации на реплика.

  • 400 FailoverGroupWithVirtualNetworkRulesNotSupported — группы отработки отказа, настроенные с помощью политики автоматической отработки отказа, в настоящее время не поддерживаются на серверах, настроенных с помощью правил брандмауэра виртуальной сети. Настройте группу отработки отказа с помощью политики отработки отказа вручную.

  • 400 UnableToResolveRemoteServer — не удалось разрешить имя удаленного сервера-партнера из-за недопустимого имени сервера или проблем с подключением к DNS.

  • 400 RemoteDatabaseCopyPermission — у пользователя нет достаточных разрешений на создание копии базы данных на указанном сервере.

  • 400 SecurityAzureKeyVaultGeoChainError — создание вторичной базы данных(процесс, называемый цепочкой) не поддерживается при включении прозрачного шифрования данных с помощью Azure Key Vault (BYOK).

  • 404 ResourceNotFound — запрошенный ресурс не найден.

  • 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке.

  • 404 ServerNotInSubscription — указанный сервер не существует в указанной подписке.

  • 404 SourceDatabaseNotFound — база данных-источник не существует.

  • 405 UnsupportedReplicationOperation — в базе данных была инициирована неподдерживаемая операция репликации.

  • 409 ConflictingServerOperation — в настоящее время выполняется операция для сервера.

  • 409 SubscriptionDisabled — подписка отключена.

  • 409 ConflictingSystemOperationInProgress — в базе данных выполняется операция обслуживания системы, и для дальнейших операций необходимо дождаться ее завершения.

  • 409 GeoReplicationCannotBecomePrimaryDuringUndo — пользователь пытался выполнить отработку отказа или принудительно завершить геосвязь, пока вторичная ссылка находится в состоянии, когда она может быть физически несоотступна и поэтому не может войти в основную роль.

  • 409 ServerKeyNameAlreadyExists — ключ сервера уже существует на сервере.

  • 409 ServerKeyUriAlreadyExists — URI ключа сервера уже существует на сервере.

  • 409 ServerKeyDoesNotExists. Ключ сервера не существует.

  • 409 UpdateSloInProgress — пользователь пытался инициировать несовместимую операцию во время обновления SLO.

  • 409 AzureKeyVaultKeyNameNotFound — не удалось выполнить операцию, так как имя ключа Key Vault Azure не существует.

  • 409 AzureKeyVaultKeyInUse — ключ в настоящее время используется сервером.

  • 409 FailoverGroupAlreadyExists — группа отработки отказа уже существует на данном сервере. Используйте другое имя группы отработки отказа.

  • 409 FailoverGroupBusy — группа отработки отказа занята другой операцией.

  • 409 DatabaseBelongsToOtherFailoverGroup — база данных принадлежит другой группе отработки отказа и не может считаться частью этой группы.

  • 409 DatabaseBeingAddedToFailoverGroup — база данных в настоящее время добавляется в группу отработки отказа. Клиент должен дождаться завершения этой операции, чтобы устранить проблему.

  • 409 DatabaseBeingRemovedFromFailoverGroup — база данных в настоящее время удаляется из группы отработки отказа. Клиент должен дождаться завершения этой операции, чтобы выдать добавление.

  • 409 FailoverGroupDnsRecordInUse — для запрошенной конечной точки существует повторяющаяся запись DNS.

  • 409 InvalidFailoverGroupName — указано недопустимое имя группы отработки отказа.

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship — операция заполнения репликации была выполнена в базе данных, которая уже находится в связи репликации.

  • 409 InvalidDatabaseStateForOperation — операция не разрешена для базы данных в текущем состоянии репликации.

  • 409 DuplicateGeoDrRelation — базы данных уже находятся в отношении репликации. Это повторяющийся запрос.

  • 409 RemoteDatabaseExists — имя целевой базы данных уже существует на целевом сервере.

  • 429 SubscriptionTooManyCreateUpdateRequests — запросы сверх максимального количества запросов, которые могут быть обработаны доступными ресурсами.

  • 429 SubscriptionTooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами.

  • 503 TooManyRequests — запросы сверх максимального числа запросов, которые могут быть обработаны доступными ресурсами.

  • 503 AzureKeyVaultConnectionFailed — не удалось выполнить операцию на сервере, так как попытки подключения к Azure Key Vault завершились сбоем

  • 503 AzureKeyVaultGenericConnectionError — не удалось выполнить операцию, так как при попытке получить Key Vault сведения возникла ошибка .

  • 503 DatabaseUnavailable — операция завершилась сбоем, так как база данных недоступна.

  • 504 RequestTimeout — превышено допустимое время ожидания запроса на обслуживание.

Примеры

List failover group

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

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups?api-version=2021-11-01

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

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test",
      "name": "failover-group-test",
      "type": "Microsoft.Sql/servers/failoverGroups",
      "location": "Japan East",
      "properties": {
        "readWriteEndpoint": {
          "failoverPolicy": "Automatic",
          "failoverWithDataLossGracePeriodMinutes": 480
        },
        "readOnlyEndpoint": {
          "failoverPolicy": "Disabled"
        },
        "replicationRole": "Primary",
        "replicationState": "CATCH_UP",
        "partnerServers": [
          {
            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server",
            "location": "Japan West",
            "replicationRole": "Secondary"
          }
        ],
        "databases": []
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-2",
      "name": "failover-group-test-2",
      "type": "Microsoft.Sql/servers/failoverGroups",
      "location": "Japan East",
      "properties": {
        "readWriteEndpoint": {
          "failoverPolicy": "Automatic",
          "failoverWithDataLossGracePeriodMinutes": 480
        },
        "readOnlyEndpoint": {
          "failoverPolicy": "Disabled"
        },
        "replicationRole": "Primary",
        "replicationState": "CATCH_UP",
        "partnerServers": [
          {
            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server",
            "location": "Japan West",
            "replicationRole": "Secondary"
          }
        ],
        "databases": []
      }
    }
  ]
}

Определения

Имя Описание
FailoverGroup

Группа отработки отказа.

FailoverGroupListResult

Список групп отработки отказа.

FailoverGroupReadOnlyEndpoint

Конечная точка только для чтения экземпляра группы отработки отказа.

FailoverGroupReadWriteEndpoint

Конечная точка чтения и записи экземпляра группы отработки отказа.

FailoverGroupReplicationRole

Роль локальной репликации экземпляра группы отработки отказа.

PartnerInfo

Сведения о сервере-партнере для группы отработки отказа.

ReadOnlyEndpointFailoverPolicy

Политика отработки отказа конечной точки только для чтения для группы отработки отказа.

ReadWriteEndpointFailoverPolicy

Политика отработки отказа конечной точки чтения и записи для группы отработки отказа. Если параметр failoverPolicy имеет значение Автоматически, то требуется отработка отказаWithDataLossGracePeriodMinutes.

FailoverGroup

Группа отработки отказа.

Имя Тип Описание
id

string

Идентификатор ресурса.

location

string

Расположение ресурса.

name

string

Имя ресурса.

properties.databases

string[]

Список баз данных в группе отработки отказа.

properties.partnerServers

PartnerInfo[]

Список сведений о сервере-партнере для группы отработки отказа.

properties.readOnlyEndpoint

FailoverGroupReadOnlyEndpoint

Конечная точка только для чтения экземпляра группы отработки отказа.

properties.readWriteEndpoint

FailoverGroupReadWriteEndpoint

Конечная точка чтения и записи экземпляра группы отработки отказа.

properties.replicationRole

FailoverGroupReplicationRole

Роль локальной репликации экземпляра группы отработки отказа.

properties.replicationState

string

Состояние репликации экземпляра группы отработки отказа.

tags

object

Теги ресурсов.

type

string

Тип ресурса.

FailoverGroupListResult

Список групп отработки отказа.

Имя Тип Описание
nextLink

string

Ссылка для получения следующей страницы результатов.

value

FailoverGroup[]

Массив результатов.

FailoverGroupReadOnlyEndpoint

Конечная точка только для чтения экземпляра группы отработки отказа.

Имя Тип Описание
failoverPolicy

ReadOnlyEndpointFailoverPolicy

Политика отработки отказа конечной точки только для чтения для группы отработки отказа.

FailoverGroupReadWriteEndpoint

Конечная точка чтения и записи экземпляра группы отработки отказа.

Имя Тип Описание
failoverPolicy

ReadWriteEndpointFailoverPolicy

Политика отработки отказа конечной точки чтения и записи для группы отработки отказа. Если параметр failoverPolicy имеет значение Автоматически, то требуется отработка отказаWithDataLossGracePeriodMinutes.

failoverWithDataLossGracePeriodMinutes

integer

Для конечной точки чтения и записи выполняется льготный период перед отработкой отказа с потерей данных. Если параметр failoverPolicy имеет значение Автоматически, то требуется отработка отказаWithDataLossGracePeriodMinutes.

FailoverGroupReplicationRole

Роль локальной репликации экземпляра группы отработки отказа.

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

string

Secondary

string

PartnerInfo

Сведения о сервере-партнере для группы отработки отказа.

Имя Тип Описание
id

string

Идентификатор ресурса сервера-партнера.

location

string

Географическое расположение сервера-партнера.

replicationRole

FailoverGroupReplicationRole

Роль репликации сервера-партнера.

ReadOnlyEndpointFailoverPolicy

Политика отработки отказа конечной точки только для чтения для группы отработки отказа.

Имя Тип Описание
Disabled

string

Enabled

string

ReadWriteEndpointFailoverPolicy

Политика отработки отказа конечной точки чтения и записи для группы отработки отказа. Если параметр failoverPolicy имеет значение Автоматически, то требуется отработка отказаWithDataLossGracePeriodMinutes.

Имя Тип Описание
Automatic

string

Manual

string