Instance Failover Groups - Create Or Update

Служба:

SQL Database

Версия API:

2021-11-01

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

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/instanceFailoverGroups/{failoverGroupName}?api-version=2021-11-01

Параметры URI

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

Текст запроса

Имя	Обязательно	Тип	Описание
properties.managedInstancePairs	True	ManagedInstancePairInfo[]	Список пар управляемых экземпляров в группе отработки отказа.
properties.partnerRegions	True	PartnerRegionInfo[]	Сведения о регионе партнера для группы отработки отказа.
properties.readWriteEndpoint	True	InstanceFailoverGroupReadWriteEndpoint	Конечная точка для чтения и записи экземпляра группы отработки отказа.
properties.readOnlyEndpoint		InstanceFailoverGroupReadOnlyEndpoint	Доступная только для чтения конечная точка экземпляра группы отработки отказа.

Ответы

Имя	Тип	Описание
200 OK	InstanceFailoverGroup	Группа отработки отказа успешно обновлена.
201 Created	InstanceFailoverGroup	Группа отработки отказа успешно создана.
202 Accepted		Принято
Other Status Codes		Ответы об ошибках: *** 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPrimary — данное основное поле в тексте запроса группы отработки отказа экземпляра пустое или недопустимое. 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPartner — заданное поле партнера в тексте запроса группы отработки отказа экземпляра является пустым или недопустимым. 400 InstanceFailoverGroupCreateOrUpdateRequestDuplicatePartner — один или несколько предоставленных серверов-партнеров уже входят в группу отработки отказа экземпляров. Убедитесь, что сервер-источник и все серверы-партнеры уникальны. 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidManagedInstanceRegion — предоставленный регион управляемого экземпляра партнера в тексте запроса группы отработки отказа экземпляров пуст или недопустим. 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount — поддерживается только один регион партнера. 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPairCount — поддерживается только одна пара управляемых экземпляров. 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint — для запросов на создание или обновление требуется поле readWriteEndpoint. 400 InstanceFailoverGroupCreateOrUpdateRequestInvalid — текст запроса группы отработки отказа экземпляра пуст или недопустим. 400 InstanceFailoverGroupUpdateOrDeleteRequestOnSecondary — изменения группы отработки отказа экземпляров не допускаются на сервере-получателе. Выполните запрос на сервере-источнике. 400 InstanceFailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues — значение льготного периода для конечной точки чтения и записи должно быть неотрицательным. 400 InstanceFailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues — значение льготного периода для группы отработки отказа экземпляра должно быть больше или равно минимальному льготному периоду минут{0} 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields — свойство failoverWithDataLossGracePeriodMinutes должно быть указано, если для конечной точки чтения и записи выбрана политика отработки отказа Автоматически. 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy — поле failoverPolicy для конечной точки чтения и записи требуется для запросов на создание или обновление. 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy — значение льготного периода не должно быть указано, если для конечной точки чтения и записи выбрана политика отработки отказа Вручную. 400 InstanceFailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified — текст запроса группы отработки отказа экземпляра не должен изменять свойство только для чтения "{0}". 400 InstanceFailoverGroupFailoverRequestOnPrimary — запрос на отработку отказа должен быть инициирован на сервере-получателе группы отработки отказа экземпляра. 400 InstanceFailoverGroupPartnerManagedInstanceFromDifferentSubscription — сервер-источник и сервер-партнер группы отработки отказа относятся к разным подпискам. Перекрестная подписка для серверов группы отработки отказа не допускается. 400 FailoverGroupRegionMismatch — регион партнера, указанный в разделе Группа отработки отказа, должен соответствовать региону указанного управляемого экземпляра партнера. 400 ServerEditionMismatch — выпуск должен совпадать с основным сервером при создании сервера реплика. 400 DnsZoneMismatch — DNSZone на сервере-партнере отличается от DNSZone на исходном сервере. Это нарушает функциональность InstanceFailoverGroup. 400 InvalidTargetSubregion — целевой сервер нечитаемой вторичной базы данных не находится в парном регионе Azure для аварийного восстановления. 400 GeoDrInstanceSizeMismatch — основной управляемый экземпляр и управляемый экземпляр партнера имеют разный размер хранилища. 400 SecurityAdalPrincipalCertExpiredError — не удалось завершить операцию, так как истек срок действия сертификата субъекта Key Vault Azure. 400 GeoDrSecondaryInstanceNotEmpty — вторичный управляемый экземпляр имеет пользовательские базы данных. Чтобы создать группу отработки отказа экземпляра, вторичный управляемый экземпляр должен быть пустым. 400 InstanceFailoverGroupIncorrectNetworkingConfiguration — неправильная конфигурация сети. Трафик репликации сервера-источника не может достичь сервера-получателя. 400 IncorrectReplicationLinkState — операция ожидает, что база данных будет находиться в ожидаемом состоянии по каналу репликации. 400 SecurityInvalidAzureKeyVaultRecoveryLevel — указанный URI Key Vault является недопустимым. 400 KeyMaterialNotFoundOnRemoteServer — удаленный сервер не имеет доступа к материалу ключа, используемому в качестве предохранителя TDE. 400 AzureKeyVaultRsaKeyNotSupported — предоставленное хранилище ключей использует неподдерживаемый размер или тип ключа RSA. Поддерживаемый размер ключа RSA — 2048 или 3072, а тип ключа — RSA или RSA-HSM. 400 UnableToResolveRemoteServer — не удалось разрешить имя удаленного сервера-партнера из-за недопустимого имени сервера или проблем с подключением к DNS. 400 SameKeyUriNotFoundOnRemoteServer — сервер-получатель не содержит материал ключа из того же хранилища ключей, что и предохранитель шифрования сервера-источника с включенной автоматической сменой ключей. 400 RemoteDatabaseCopyPermission — у пользователя нет достаточных разрешений на создание копии базы данных на указанном сервере. 400 SameKeyMaterialNotFoundOnRemoteServer — сервер-получатель не имеет материала ключа предохранителя шифрования основного сервера. 400 CannotUseReservedDatabaseName — не удается использовать зарезервированное имя базы данных в этой операции. 400 InvalidFailoverGroupRegion — серверы, указанные в группе отработки отказа экземпляров, должны находиться в разных регионах для обеспечения изоляции. 400 InstanceFailoverGroupDoesNotExist — группа отработки отказа не существует на сервере. 400 InstanceFailoverGroupNotSecondary — отработка отказа не может быть инициирована с сервера-источника в группе отработки отказа экземпляра. 400 InvalidServerName — указано недопустимое имя сервера. 400 InvalidIdentifier — идентификатор содержит значение NULL или недопустимый символ Юникода. 400 TokenTooLong — предоставленный маркер слишком длинный. 400 AzureKeyVaultKeyDisabled — не удалось выполнить операцию на сервере, так как ключ Key Vault Azure отключен. 400 AzureKeyVaultInvalidExpirationDate — не удалось выполнить операцию, так как недопустимая дата окончания срока действия ключа Key Vault Azure. 400 SecurityAzureKeyVaultUrlNullOrEmpty — не удалось выполнить операцию, так как URI Key Vault Azure имеет значение NULL или пуст. 400 InvalidSku — пользователь указал недопустимый номер SKU. 400 InvalidAddSecondaryPermission — пользователь не имеет достаточных разрешений для добавления вторичной базы данных на указанный сервер. 400 ServerNotFound — запрошенный сервер не найден. 400 AzureKeyVaultNoServerIdentity — удостоверение сервера настроено неправильно. 400 AzureKeyVaultInvalidUri — недопустимый ответ от azure Key Vault. Используйте допустимый URI Key Vault Azure. 400 AzureKeyVaultMissingPermissions — на сервере отсутствуют необходимые разрешения на Key Vault Azure. 400 SecurityAzureKeyVaultInvalidKeyName — не удалось выполнить операцию из-за недопустимого имени ключа сервера. 400 PlannedFailoverTimedOutForDatabase — пользователь вызвал плановая отработка отказа, истекло время ожидания, и конкретная база данных, как представляется, должна blame. 400 PlannedFailoverTimedOut — пользователь вызвал плановая отработка отказа, и время ожидания истекло при попытке связаться со службой управления партнерами. 400 AdalGenericError — не удалось завершить операцию, так как обнаружена ошибка Azure Active Directory. 400 GeoReplicationDatabaseNotSecondary — операция ожидает, что база данных будет целевым объектом репликации. 400 AdalServicePrincipalNotFound — не удалось выполнить операцию, так как обнаружена ошибка субъект-служба библиотеки Azure Active Directory не найдена. 400 AzureKeyVaultMalformedVaultUri — указанный URI Key Vault является недопустимым. 400 FeatureDisabledOnSelectedEdition — пользователь попытался использовать функцию, которая отключена в текущем выпуске базы данных. 404 OperationIdNotFound — операция с идентификатором не существует. 404 ResourceNotFound — запрошенный ресурс не найден. 404 OperationIdNotFound — операция с идентификатором не существует. 404 SourceDatabaseNotFound — база данных-источник не существует. 404 ServerNotInSubscription — указанный сервер не существует в указанной подписке. 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке. 405 UnsupportedReplicationOperation — в базе данных была инициирована неподдерживаемая операция репликации. 409 OperationCancelled — операция была отменена пользователем. 409 OperationInterrupted — не удалось завершить операцию с ресурсом, так как она была прервана другой операцией с тем же ресурсом. 409 ManagedInstanceHasHybridLink — пользователь пытался инициировать операцию, которая не поддерживается, если у управляемого экземпляра настроена гибридная связь. 409 RemoteDatabaseExists — имя целевой базы данных уже существует на целевом сервере. 409 ConflictingServerOperation — в настоящее время выполняется операция для сервера. 409 SubscriptionDisabled — подписка отключена. 409 InstanceFailoverGroupAlreadyExists — группа отработки отказа уже существует на данном сервере. 409 InstanceFailoverGroupBusy — группа отработки отказа экземпляра занята другой операцией. 409 GeoReplicationCannotBecomePrimaryDuringUndo — пользователь пытался выполнить отработку отказа или принудительно завершить геосвязь, пока вторичная ссылка находится в состоянии, когда она может быть физически несоотступна и поэтому не может войти в основную роль. 409 InstanceFailoverGroupDnsRecordInUse — для запрошенной конечной точки существует повторяющаяся запись DNS. 409 ServerKeyNameAlreadyExists — ключ сервера уже существует на сервере. 409 ServerKeyUriAlreadyExists — URI ключа сервера уже существует на сервере. 409 ServerKeyDoesNotExists. Ключ сервера не существует. 409 InvalidFailoverGroupName — указано недопустимое имя группы отработки отказа экземпляра. 409 UpdateSloInProgress — пользователь пытался инициировать несовместимую операцию во время обновления SLO. 409 AzureKeyVaultKeyNameNotFound — не удалось выполнить операцию, так как имя ключа Key Vault Azure не существует. 409 AzureKeyVaultKeyInUse — ключ в настоящее время используется сервером. 409 ConflictingSystemOperationInProgress — в базе данных выполняется операция обслуживания системы, и для дальнейших операций необходимо дождаться ее завершения. 409 InvalidOperationForDatabaseNotInReplicationRelationship — операция заполнения репликации была выполнена в базе данных, которая уже находится в связи репликации. 409 InvalidDatabaseStateForOperation — операция не разрешена для базы данных в текущем состоянии репликации. 409 DuplicateGeoDrRelation — базы данных уже находятся в отношении репликации. Это повторяющийся запрос. 429 SubscriptionTooManyCreateUpdateRequests — запросы сверх максимального количества запросов, которые могут быть обработаны доступными ресурсами. 429 SubscriptionTooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами. 429 SubscriptionTooManyCreateUpdateRequests — запросы сверх максимального количества запросов, которые могут быть обработаны доступными ресурсами. 429 SubscriptionTooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами. 500 OperationTimedOut — время ожидания операции истекло и автоматически откатывается. Повторите операцию. 503 TooManyRequests — запросы сверх максимального числа запросов, которые могут быть обработаны доступными ресурсами. 503 TooManyRequests — запросы сверх максимального числа запросов, которые могут быть обработаны доступными ресурсами. 503 AzureKeyVaultConnectionFailed — не удалось выполнить операцию на сервере, так как попытки подключения к Azure Key Vault завершились сбоем 503 AzureKeyVaultGenericConnectionError — не удалось выполнить операцию, так как при попытке получить Key Vault сведения возникла ошибка . 504 RequestTimeout — превышено допустимое время ожидания запроса на обслуживание.

Примеры

Create failover group

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

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/Japan East/instanceFailoverGroups/failover-group-test-3?api-version=2021-11-01

{
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "partnerRegions": [
      {
        "location": "Japan West"
      }
    ],
    "managedInstancePairs": [
      {
        "primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance",
        "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance"
      }
    ]
  }
}

Java

import com.azure.resourcemanager.sql.fluent.models.InstanceFailoverGroupInner;
import com.azure.resourcemanager.sql.models.InstanceFailoverGroupReadOnlyEndpoint;
import com.azure.resourcemanager.sql.models.InstanceFailoverGroupReadWriteEndpoint;
import com.azure.resourcemanager.sql.models.ManagedInstancePairInfo;
import com.azure.resourcemanager.sql.models.PartnerRegionInfo;
import com.azure.resourcemanager.sql.models.ReadOnlyEndpointFailoverPolicy;
import com.azure.resourcemanager.sql.models.ReadWriteEndpointFailoverPolicy;
import java.util.Arrays;

/**
 * Samples for InstanceFailoverGroups CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/InstanceFailoverGroupCreateOrUpdate.
     * json
     */
    /**
     * Sample code: Create failover group.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createFailoverGroup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getInstanceFailoverGroups()
            .createOrUpdate("Default", "Japan East", "failover-group-test-3", new InstanceFailoverGroupInner()
                .withReadWriteEndpoint(new InstanceFailoverGroupReadWriteEndpoint()
                    .withFailoverPolicy(ReadWriteEndpointFailoverPolicy.AUTOMATIC)
                    .withFailoverWithDataLossGracePeriodMinutes(480))
                .withReadOnlyEndpoint(new InstanceFailoverGroupReadOnlyEndpoint()
                    .withFailoverPolicy(ReadOnlyEndpointFailoverPolicy.DISABLED))
                .withPartnerRegions(Arrays.asList(new PartnerRegionInfo().withLocation("Japan West")))
                .withManagedInstancePairs(Arrays.asList(new ManagedInstancePairInfo().withPrimaryManagedInstanceId(
                    "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance")
                    .withPartnerManagedInstanceId(
                        "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance"))),
                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

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanEast/instanceFailoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/locations/instanceFailoverGroups",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "replicationRole": "Primary",
    "replicationState": "CATCH_UP",
    "partnerRegions": [
      {
        "location": "Japan West",
        "replicationRole": "Secondary"
      }
    ],
    "managedInstancePairs": [
      {
        "primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance",
        "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance"
      }
    ]
  }
}

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

201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanEast/instanceFailoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/locations/instanceFailoverGroups",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "replicationRole": "Primary",
    "replicationState": "CATCH_UP",
    "partnerRegions": [
      {
        "location": "Japan West",
        "replicationRole": "Secondary"
      }
    ],
    "managedInstancePairs": [
      {
        "primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance",
        "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance"
      }
    ]
  }
}

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

202

Определения

Имя	Описание
InstanceFailoverGroup	Группа отработки отказа экземпляра.
InstanceFailoverGroupReadOnlyEndpoint	Доступная только для чтения конечная точка экземпляра группы отработки отказа.
InstanceFailoverGroupReadWriteEndpoint	Конечная точка для чтения и записи экземпляра группы отработки отказа.
InstanceFailoverGroupReplicationRole	Роль локальной репликации экземпляра группы отработки отказа.
ManagedInstancePairInfo	Пары Управляемых экземпляров в группе отработки отказа.
PartnerRegionInfo	Сведения о регионе партнера для группы отработки отказа.
ReadOnlyEndpointFailoverPolicy	Политика отработки отказа конечной точки только для чтения для группы отработки отказа.
ReadWriteEndpointFailoverPolicy	Политика отработки отказа конечной точки чтения и записи для группы отработки отказа. Если параметр failoverPolicy имеет значение Автоматически, требуется отработка отказаWithDataLossGracePeriodMinutes.

InstanceFailoverGroup

Группа отработки отказа экземпляра.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.managedInstancePairs	ManagedInstancePairInfo[]	Список пар управляемых экземпляров в группе отработки отказа.
properties.partnerRegions	PartnerRegionInfo[]	Сведения о регионе партнера для группы отработки отказа.
properties.readOnlyEndpoint	InstanceFailoverGroupReadOnlyEndpoint	Доступная только для чтения конечная точка экземпляра группы отработки отказа.
properties.readWriteEndpoint	InstanceFailoverGroupReadWriteEndpoint	Конечная точка для чтения и записи экземпляра группы отработки отказа.
properties.replicationRole	InstanceFailoverGroupReplicationRole	Роль локальной репликации экземпляра группы отработки отказа.
properties.replicationState	string	Состояние репликации экземпляра группы отработки отказа.
type	string	Тип ресурса.

InstanceFailoverGroupReadOnlyEndpoint

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

Имя	Тип	Описание
failoverPolicy	ReadOnlyEndpointFailoverPolicy	Политика отработки отказа конечной точки только для чтения для группы отработки отказа.

InstanceFailoverGroupReadWriteEndpoint

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

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

InstanceFailoverGroupReplicationRole

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

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

ManagedInstancePairInfo

Пары Управляемых экземпляров в группе отработки отказа.

Имя	Тип	Описание
partnerManagedInstanceId	string	Идентификатор партнера Управляемый экземпляр в паре.
primaryManagedInstanceId	string	Идентификатор основного Управляемый экземпляр в паре.

PartnerRegionInfo

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

Имя	Тип	Описание
location	string	Географическое расположение управляемых экземпляров партнера.
replicationRole	InstanceFailoverGroupReplicationRole	Роль репликации управляемых экземпляров партнера.

ReadOnlyEndpointFailoverPolicy

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

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

ReadWriteEndpointFailoverPolicy

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

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