Failover Groups - Create Or Update
Создает или обновляет группу отработки отказа.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/failoverGroups/{failoverGroupName}?api-version=2023-08-01
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
failover
|
path | True |
string |
Имя группы отработки отказа. |
resource
|
path | True |
string |
Имя группы ресурсов, содержащей ресурс. Это значение можно получить из API Azure Resource Manager или портала. |
server
|
path | True |
string |
Имя сервера, содержащего группу отработки отказа. |
subscription
|
path | True |
string |
Идентификатор подписки, идентифицирующий подписку Azure. |
api-version
|
query | True |
string |
Версия API, используемая для запроса. |
Текст запроса
Имя | Обязательно | Тип | Описание |
---|---|---|---|
properties.partnerServers | True |
Список сведений о сервере партнера для группы отработки отказа. |
|
properties.readWriteEndpoint | True |
Конечная точка чтения и записи экземпляра группы отработки отказа. |
|
properties.databases |
string[] (arm-id) |
Список баз данных в группе отработки отказа. |
|
properties.readOnlyEndpoint |
Конечная точка группы отработки отказа только для чтения. |
||
properties.secondaryType |
Вторичный тип баз данных на сервере партнера. |
||
tags |
object |
Теги ресурсов. |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
Успешно обновлена группа отработки отказа. |
|
201 Created |
Успешно создана группа отработки отказа. |
|
202 Accepted |
Принятый Заголовки Location: string |
|
Other Status Codes |
Ответы на ошибки: ***
|
Примеры
Create failover group |
Create failover group with standby secondary database on partner server. |
Create failover group
Образец запроса
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3?api-version=2023-08-01
{
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled"
},
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
}
],
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
]
}
}
Пример ответа
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3",
"name": "failover-group-test-3",
"type": "Microsoft.Sql/servers/failoverGroups",
"location": "Japan East",
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled",
"targetServer": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
},
"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": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
]
}
}
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3",
"name": "failover-group-test-3",
"type": "Microsoft.Sql/servers/failoverGroups",
"location": "Japan East",
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled",
"targetServer": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
},
"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": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
]
}
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/japaneast/failoverGroupOperationResults/11111111-1111-1111-1111-111111111111
Create failover group with standby secondary database on partner server.
Образец запроса
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3?api-version=2023-08-01
{
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled"
},
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
}
],
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
],
"secondaryType": "Standby"
}
}
Пример ответа
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3",
"name": "failover-group-test-3",
"type": "Microsoft.Sql/servers/failoverGroups",
"location": "Japan East",
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled",
"targetServer": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
},
"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": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
]
}
}
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3",
"name": "failover-group-test-3",
"type": "Microsoft.Sql/servers/failoverGroups",
"location": "Japan East",
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled",
"targetServer": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
},
"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": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
]
}
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/japaneast/failoverGroupOperationResults/11111111-1111-1111-1111-111111111111
Определения
Имя | Описание |
---|---|
Error |
Дополнительные сведения об ошибке управления ресурсами. |
Error |
Сведения об ошибке. |
Error |
Ответ на ошибку |
Failover |
Группа отработки отказа. |
Failover |
Вторичный тип баз данных на сервере партнера. |
Failover |
Конечная точка группы отработки отказа только для чтения. |
Failover |
Конечная точка чтения и записи экземпляра группы отработки отказа. |
Failover |
Локальная роль репликации экземпляра группы отработки отказа. |
Partner |
Сведения о сервере партнера для группы отработки отказа. |
Read |
Политика отработки отказа конечной точки только для чтения для группы отработки отказа. |
Read |
Политика отработки отказа конечной точки чтения и записи для группы отработки отказа. Если отработка отказа является автоматической, требуется отработка отказаWithDataLossGracePeriodMinutes. |
ErrorAdditionalInfo
Дополнительные сведения об ошибке управления ресурсами.
Имя | Тип | Описание |
---|---|---|
info |
object |
Дополнительные сведения. |
type |
string |
Дополнительный тип сведений. |
ErrorDetail
Сведения об ошибке.
Имя | Тип | Описание |
---|---|---|
additionalInfo |
Дополнительные сведения об ошибке. |
|
code |
string |
Код ошибки. |
details |
Сведения об ошибке. |
|
message |
string |
Сообщение об ошибке. |
target |
string |
Целевой объект ошибки. |
ErrorResponse
Ответ на ошибку
Имя | Тип | Описание |
---|---|---|
error |
Объект ошибки. |
FailoverGroup
Группа отработки отказа.
Имя | Тип | Описание |
---|---|---|
id |
string |
Идентификатор ресурса. |
location |
string |
Расположение ресурса. |
name |
string |
Имя ресурса. |
properties.databases |
string[] (arm-id) |
Список баз данных в группе отработки отказа. |
properties.partnerServers |
Список сведений о сервере партнера для группы отработки отказа. |
|
properties.readOnlyEndpoint |
Конечная точка группы отработки отказа только для чтения. |
|
properties.readWriteEndpoint |
Конечная точка чтения и записи экземпляра группы отработки отказа. |
|
properties.replicationRole |
Локальная роль репликации экземпляра группы отработки отказа. |
|
properties.replicationState |
string |
Состояние репликации экземпляра группы отработки отказа. |
properties.secondaryType |
Вторичный тип баз данных на сервере партнера. |
|
tags |
object |
Теги ресурсов. |
type |
string |
Тип ресурса. |
FailoverGroupDatabasesSecondaryType
Вторичный тип баз данных на сервере партнера.
Значение | Описание |
---|---|
Geo | |
Standby |
FailoverGroupReadOnlyEndpoint
Конечная точка группы отработки отказа только для чтения.
Имя | Тип | Описание |
---|---|---|
failoverPolicy |
Политика отработки отказа конечной точки только для чтения для группы отработки отказа. |
|
targetServer |
string (arm-id) |
Целевой сервер партнера, на который указывает конечная точка только для чтения. |
FailoverGroupReadWriteEndpoint
Конечная точка чтения и записи экземпляра группы отработки отказа.
Имя | Тип | Описание |
---|---|---|
failoverPolicy |
Политика отработки отказа конечной точки чтения и записи для группы отработки отказа. Если отработка отказа является автоматической, требуется отработка отказаWithDataLossGracePeriodMinutes. |
|
failoverWithDataLossGracePeriodMinutes |
integer (int32) |
Льготный период перед отработкой отказа с потерей данных пытается выполнить для конечной точки чтения и записи. Если отработка отказа является автоматической, требуется отработка отказаWithDataLossGracePeriodMinutes. |
FailoverGroupReplicationRole
Локальная роль репликации экземпляра группы отработки отказа.
Значение | Описание |
---|---|
Primary | |
Secondary |
PartnerInfo
Сведения о сервере партнера для группы отработки отказа.
Имя | Тип | Описание |
---|---|---|
id |
string (arm-id) |
Идентификатор ресурса сервера партнера. |
location |
string |
Географическое расположение сервера партнера. |
replicationRole |
Роль репликации сервера-партнера. |
ReadOnlyEndpointFailoverPolicy
Политика отработки отказа конечной точки только для чтения для группы отработки отказа.
Значение | Описание |
---|---|
Disabled | |
Enabled |
ReadWriteEndpointFailoverPolicy
Политика отработки отказа конечной точки чтения и записи для группы отработки отказа. Если отработка отказа является автоматической, требуется отработка отказаWithDataLossGracePeriodMinutes.
Значение | Описание |
---|---|
Automatic | |
Manual |