Failover Groups - Create Or Update
Skapar eller uppdaterar en redundansgrupp.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/failoverGroups/{failoverGroupName}?api-version=2023-08-01
URI-parametrar
| Name | I | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
failover
|
path | True |
string |
Namnet på redundansgruppen. |
|
resource
|
path | True |
string |
Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen. |
|
server
|
path | True |
string |
Namnet på servern som innehåller redundansgruppen. |
|
subscription
|
path | True |
string |
Det prenumerations-ID som identifierar en Azure-prenumeration. |
|
api-version
|
query | True |
string |
DEN API-version som ska användas för begäran. |
Begärandetext
| Name | Obligatorisk | Typ | Description |
|---|---|---|---|
| properties.partnerServers | True |
Lista över partnerserverinformation för redundansgruppen. |
|
| properties.readWriteEndpoint | True |
Skrivskyddad slutpunkt för redundansklusterinstansen. |
|
| properties.databases |
string[] (arm-id) |
Lista över databaser i redundansgruppen. |
|
| properties.readOnlyEndpoint |
Skrivskyddad slutpunkt för redundansklusterinstansen. |
||
| properties.secondaryType |
Databasers sekundära typ på partnerservern. |
||
| tags |
object |
Resurstaggar. |
Svar
| Name | Typ | Description |
|---|---|---|
| 200 OK |
Redundansgruppen har uppdaterats. |
|
| 201 Created |
Redundansgruppen har skapats. |
|
| 202 Accepted |
Accepterad Sidhuvuden Location: string |
|
| Other Status Codes |
Felsvar: ***
|
Exempel
| Create failover group |
| Create failover group with standby secondary database on partner server. |
Create failover group
Exempelbegäran
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"
]
}
}
Exempelsvar
{
"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.
Exempelbegäran
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"
}
}
Exempelsvar
{
"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
Definitioner
| Name | Description |
|---|---|
|
Error |
Ytterligare information om resurshanteringsfelet. |
|
Error |
Felinformationen. |
|
Error |
Felsvar |
|
Failover |
En redundansgrupp. |
|
Failover |
Databasers sekundära typ på partnerservern. |
|
Failover |
Skrivskyddad slutpunkt för redundansklusterinstansen. |
|
Failover |
Skrivskyddad slutpunkt för redundansklusterinstansen. |
|
Failover |
Den lokala replikeringsrollen för redundansklusterinstansen. |
|
Partner |
Partnerserverinformation för redundansgruppen. |
|
Read |
Redundansprincip för den skrivskyddade slutpunkten för redundansgruppen. |
|
Read |
Redundansprincip för skrivskyddad slutpunkt för redundansgruppen. Om failoverPolicy är Automatisk krävs failoverWithDataLossGracePeriodMinutes. |
ErrorAdditionalInfo
Ytterligare information om resurshanteringsfelet.
| Name | Typ | Description |
|---|---|---|
| info |
object |
Ytterligare information. |
| type |
string |
Ytterligare informationstyp. |
ErrorDetail
Felinformationen.
| Name | Typ | Description |
|---|---|---|
| additionalInfo |
Ytterligare information om felet. |
|
| code |
string |
Felkoden. |
| details |
Felinformationen. |
|
| message |
string |
Felmeddelandet. |
| target |
string |
Felmålet. |
ErrorResponse
Felsvar
| Name | Typ | Description |
|---|---|---|
| error |
Felobjektet. |
FailoverGroup
En redundansgrupp.
| Name | Typ | Description |
|---|---|---|
| id |
string |
Resurs-ID. |
| location |
string |
Resursplats. |
| name |
string |
Resursnamn. |
| properties.databases |
string[] (arm-id) |
Lista över databaser i redundansgruppen. |
| properties.partnerServers |
Lista över partnerserverinformation för redundansgruppen. |
|
| properties.readOnlyEndpoint |
Skrivskyddad slutpunkt för redundansklusterinstansen. |
|
| properties.readWriteEndpoint |
Skrivskyddad slutpunkt för redundansklusterinstansen. |
|
| properties.replicationRole |
Den lokala replikeringsrollen för redundansklusterinstansen. |
|
| properties.replicationState |
string |
Replikeringstillstånd för redundansklusterinstansen. |
| properties.secondaryType |
Databasers sekundära typ på partnerservern. |
|
| tags |
object |
Resurstaggar. |
| type |
string |
Resurstyp. |
FailoverGroupDatabasesSecondaryType
Databasers sekundära typ på partnerservern.
| Värde | Description |
|---|---|
| Geo | |
| Standby |
FailoverGroupReadOnlyEndpoint
Skrivskyddad slutpunkt för redundansklusterinstansen.
| Name | Typ | Description |
|---|---|---|
| failoverPolicy |
Redundansprincip för den skrivskyddade slutpunkten för redundansgruppen. |
|
| targetServer |
string (arm-id) |
Målpartnerservern där den skrivskyddade slutpunkten pekar på. |
FailoverGroupReadWriteEndpoint
Skrivskyddad slutpunkt för redundansklusterinstansen.
| Name | Typ | Description |
|---|---|---|
| failoverPolicy |
Redundansprincip för skrivskyddad slutpunkt för redundansgruppen. Om failoverPolicy är Automatisk krävs failoverWithDataLossGracePeriodMinutes. |
|
| failoverWithDataLossGracePeriodMinutes |
integer (int32) |
Respitperiod före redundansväxling med dataförlust görs för läs- och skrivslutpunkten. Om failoverPolicy är Automatisk krävs failoverWithDataLossGracePeriodMinutes. |
FailoverGroupReplicationRole
Den lokala replikeringsrollen för redundansklusterinstansen.
| Värde | Description |
|---|---|
| Primary | |
| Secondary |
PartnerInfo
Partnerserverinformation för redundansgruppen.
| Name | Typ | Description |
|---|---|---|
| id |
string (arm-id) |
Resursidentifierare för partnerservern. |
| location |
string |
Geoplats för partnerservern. |
| replicationRole |
Replikeringsrollen för partnerservern. |
ReadOnlyEndpointFailoverPolicy
Redundansprincip för den skrivskyddade slutpunkten för redundansgruppen.
| Värde | Description |
|---|---|
| Disabled | |
| Enabled |
ReadWriteEndpointFailoverPolicy
Redundansprincip för skrivskyddad slutpunkt för redundansgruppen. Om failoverPolicy är Automatisk krävs failoverWithDataLossGracePeriodMinutes.
| Värde | Description |
|---|---|
| Manual | |
| Automatic |