Instance Failover Groups - Failover
Redundansväxlar från den aktuella primära hanterade instansen till den här hanterade instansen.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/instanceFailoverGroups/{failoverGroupName}/failover?api-version=2021-11-01
URI-parametrar
| Namn | I | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
|
failover
|
path | True |
string |
Namnet på redundansgruppen. |
|
location
|
path | True |
string |
Namnet på den region där resursen finns. |
|
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. |
|
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. |
Svaren
| Namn | Typ | Beskrivning |
|---|---|---|
| 200 OK |
Har växlat över. |
|
| 202 Accepted |
Har godkänts |
|
| Other Status Codes |
Felsvar: ***
|
Exempel
Planned failover of a failover group
Exempelförfrågan
POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/Japan West/instanceFailoverGroups/failover-group-test-3/failover?api-version=2021-11-01
Exempelsvar
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanWest/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 East",
"replicationRole": "Secondary"
}
],
"managedInstancePairs": [
{
"primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance",
"partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance"
}
]
}
}
Definitioner
| Namn | Beskrivning |
|---|---|
|
Instance |
En redundansgrupp för instanser. |
|
Instance |
Skrivskyddad slutpunkt för redundansklusterinstansen. |
|
Instance |
Skrivskyddad slutpunkt för redundansklusterinstansen. |
|
Instance |
Den lokala replikeringsrollen för redundansklusterinstansen. |
|
Managed |
Par med hanterade instanser i redundansgruppen. |
|
Partner |
Information om partnerregion 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. |
InstanceFailoverGroup
En redundansgrupp för instanser.
| Namn | Typ | Beskrivning |
|---|---|---|
| id |
string |
Resurs-ID. |
| name |
string |
Resursnamn. |
| properties.managedInstancePairs |
Lista över hanterade instanspar i redundansgruppen. |
|
| properties.partnerRegions |
Information om partnerregion 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. |
| type |
string |
Resurstyp. |
InstanceFailoverGroupReadOnlyEndpoint
Skrivskyddad slutpunkt för redundansklusterinstansen.
| Namn | Typ | Beskrivning |
|---|---|---|
| failoverPolicy |
Redundansprincip för den skrivskyddade slutpunkten för redundansgruppen. |
InstanceFailoverGroupReadWriteEndpoint
Skrivskyddad slutpunkt för redundansklusterinstansen.
| Namn | Typ | Beskrivning |
|---|---|---|
| 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. |
InstanceFailoverGroupReplicationRole
Den lokala replikeringsrollen för redundansklusterinstansen.
| Värde | Beskrivning |
|---|---|
| Primary | |
| Secondary |
ManagedInstancePairInfo
Par med hanterade instanser i redundansgruppen.
| Namn | Typ | Beskrivning |
|---|---|---|
| partnerManagedInstanceId |
string |
ID för partnerhanterad instans i par. |
| primaryManagedInstanceId |
string |
ID för primär hanterad instans i par. |
PartnerRegionInfo
Information om partnerregion för redundansgruppen.
| Namn | Typ | Beskrivning |
|---|---|---|
| location |
string |
Geoplats för partnerhanterade instanser. |
| replicationRole |
Replikeringsrollen för partnerhanterade instanser. |
ReadOnlyEndpointFailoverPolicy
Redundansprincip för den skrivskyddade slutpunkten för redundansgruppen.
| Värde | Beskrivning |
|---|---|
| Disabled | |
| Enabled |
ReadWriteEndpointFailoverPolicy
Redundansprincip för skrivskyddad slutpunkt för redundansgruppen. Om failoverPolicy är Automatisk krävs failoverWithDataLossGracePeriodMinutes.
| Värde | Beskrivning |
|---|---|
| Manual | |
| Automatic |