Instance Failover Groups - Force Failover Allow Data Loss
Redundansväxlar från den aktuella primära hanterade instansen till den här hanterade instansen. Den här åtgärden kan leda till dataförlust.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/instanceFailoverGroups/{failoverGroupName}/forceFailoverAllowDataLoss?api-version=2025-01-01
URI-parametrar
| Name | I | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
failover
|
path | True |
string |
Namnet på redundansgruppen. |
|
location
|
path | True |
string |
Namnet på den region där resursen finns. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Namnet på resursgruppen. Namnet är skiftlägesokänsligt. |
|
subscription
|
path | True |
string (uuid) |
ID för målprenumerationen. Värdet måste vara ett UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Den API-version som ska användas för den här åtgärden. |
Svar
| Name | Typ | Description |
|---|---|---|
| 200 OK |
Azure-operationen slutfördes framgångsrikt. |
|
| 202 Accepted |
Resursåtgärden har godkänts. Sidhuvuden
|
|
| Other Status Codes |
Ett oväntat felsvar. |
Säkerhet
azure_auth
Azure Active Directory OAuth2 Flow.
Typ:
oauth2
Flow:
implicit
Auktoriseringswebbadress:
https://login.microsoftonline.com/common/oauth2/authorize
Omfattningar
| Name | Description |
|---|---|
| user_impersonation | personifiera ditt användarkonto |
Exempel
Forced failover of a failover group allowing data loss
Exempelbegäran
Exempelsvar
{
"name": "failover-group-test-3",
"type": "Microsoft.Sql/locations/instanceFailoverGroups",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanWest/instanceFailoverGroups/failover-group-test-3",
"properties": {
"managedInstancePairs": [
{
"partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance",
"primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance"
}
],
"partnerRegions": [
{
"location": "Japan East",
"replicationRole": "Secondary"
}
],
"readOnlyEndpoint": {
"failoverPolicy": "Disabled"
},
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"replicationRole": "Primary",
"replicationState": "CATCH_UP",
"secondaryType": "Geo"
}
}
Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/JapanWest/instanceFailoverGroupOperationResults/failover-group-test-3?api-version=2022-05-01-preview
Definitioner
| Name | Description |
|---|---|
|
created |
Den typ av identitet som skapade resursen. |
|
Error |
Resurshanteringsfelet ytterligare information. |
|
Error |
Detaljerna om felet. |
|
Error |
Felsvar |
|
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. |
|
Secondary |
Typ av geo-sekundär instans. Ange "Vänteläge" om instansen endast används som dr-alternativ. |
|
system |
Metadata som rör skapande och senaste ändring av resursen. |
createdByType
Den typ av identitet som skapade resursen.
| Värde | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Resurshanteringsfelet ytterligare information.
| Name | Typ | Description |
|---|---|---|
| info |
object |
Den ytterligare informationen. |
| type |
string |
Typen av ytterligare information. |
ErrorDetail
Detaljerna om felet.
| Name | Typ | Description |
|---|---|---|
| additionalInfo |
Felet ytterligare information. |
|
| code |
string |
Felkoden. |
| details |
Felinformationen. |
|
| message |
string |
Felmeddelandet. |
| target |
string |
Felmålet. |
ErrorResponse
Felsvar
| Name | Typ | Description |
|---|---|---|
| error |
Felet objektet. |
InstanceFailoverGroup
En redundansgrupp för instanser.
| Name | Typ | Description |
|---|---|---|
| id |
string (arm-id) |
Fullständigt kvalificerat resurs-ID för resursen. T.ex. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Namnet på resursen |
| 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. |
| properties.secondaryType |
Typ av geo-sekundär instans. Ange "Vänteläge" om instansen endast används som dr-alternativ. |
|
| systemData |
Azure Resource Manager-metadata som innehåller creationBy och modifiedBy-information. |
|
| type |
string |
Resurstypen. T.ex. "Microsoft. Compute/virtualMachines" eller "Microsoft. Storage/storageAccounts" |
InstanceFailoverGroupReadOnlyEndpoint
Skrivskyddad slutpunkt för redundansklusterinstansen.
| Name | Typ | Description |
|---|---|---|
| failoverPolicy |
Redundansprincip för den skrivskyddade slutpunkten för redundansgruppen. |
InstanceFailoverGroupReadWriteEndpoint
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. |
InstanceFailoverGroupReplicationRole
Den lokala replikeringsrollen för redundansklusterinstansen.
| Värde | Description |
|---|---|
| Primary |
Primär |
| Secondary |
Secondary |
ManagedInstancePairInfo
Par med hanterade instanser i redundansgruppen.
| Name | Typ | Description |
|---|---|---|
| partnerManagedInstanceId |
string |
ID på Partner Managed Instance i par. |
| primaryManagedInstanceId |
string |
ID för Primary Managed Instance i par. |
PartnerRegionInfo
Information om partnerregion för redundansgruppen.
| Name | Typ | Description |
|---|---|---|
| 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 | Description |
|---|---|
| Disabled |
Inaktiverad |
| Enabled |
Aktiverad |
ReadWriteEndpointFailoverPolicy
Redundansprincip för skrivskyddad slutpunkt för redundansgruppen. Om failoverPolicy är Automatisk krävs failoverWithDataLossGracePeriodMinutes.
| Värde | Description |
|---|---|
| Manual |
Manuell |
| Automatic |
Automatiskt |
SecondaryInstanceType
Typ av geo-sekundär instans. Ange "Vänteläge" om instansen endast används som dr-alternativ.
| Värde | Description |
|---|---|
| Geo |
Geo |
| Standby |
Vänteläge |
systemData
Metadata som rör skapande och senaste ändring av resursen.
| Name | Typ | Description |
|---|---|---|
| createdAt |
string (date-time) |
Tidsstämpeln för resursskapande (UTC). |
| createdBy |
string |
Identiteten som skapade resursen. |
| createdByType |
Den typ av identitet som skapade resursen. |
|
| lastModifiedAt |
string (date-time) |
Tidsstämpeln för senaste ändring av resurs (UTC) |
| lastModifiedBy |
string |
Identiteten som senast ändrade resursen. |
| lastModifiedByType |
Den typ av identitet som senast ändrade resursen. |