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
failoverGroupName
path True

string

Namnet på redundansgruppen.

locationName
path True

string

Namnet på den region där resursen finns.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Namnet på resursgruppen. Namnet är skiftlägesokänsligt.

subscriptionId
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

InstanceFailoverGroup

Azure-operationen slutfördes framgångsrikt.

202 Accepted

Resursåtgärden har godkänts.

Sidhuvuden

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

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

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/Japan West/instanceFailoverGroups/failover-group-test-3/forceFailoverAllowDataLoss?api-version=2025-01-01

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
createdByType

Den typ av identitet som skapade resursen.

ErrorAdditionalInfo

Resurshanteringsfelet ytterligare information.

ErrorDetail

Detaljerna om felet.

ErrorResponse

Felsvar

InstanceFailoverGroup

En redundansgrupp för instanser.

InstanceFailoverGroupReadOnlyEndpoint

Skrivskyddad slutpunkt för redundansklusterinstansen.

InstanceFailoverGroupReadWriteEndpoint

Skrivskyddad slutpunkt för redundansklusterinstansen.

InstanceFailoverGroupReplicationRole

Den lokala replikeringsrollen för redundansklusterinstansen.

ManagedInstancePairInfo

Par med hanterade instanser i redundansgruppen.

PartnerRegionInfo

Information om partnerregion för redundansgruppen.

ReadOnlyEndpointFailoverPolicy

Redundansprincip för den skrivskyddade slutpunkten för redundansgruppen.

ReadWriteEndpointFailoverPolicy

Redundansprincip för skrivskyddad slutpunkt för redundansgruppen. Om failoverPolicy är Automatisk krävs failoverWithDataLossGracePeriodMinutes.

SecondaryInstanceType

Typ av geo-sekundär instans. Ange "Vänteläge" om instansen endast används som dr-alternativ.

systemData

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

ErrorAdditionalInfo[]

Felet ytterligare information.

code

string

Felkoden.

details

ErrorDetail[]

Felinformationen.

message

string

Felmeddelandet.

target

string

Felmålet.

ErrorResponse

Felsvar

Name Typ Description
error

ErrorDetail

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

ManagedInstancePairInfo[]

Lista över hanterade instanspar i redundansgruppen.

properties.partnerRegions

PartnerRegionInfo[]

Information om partnerregion för redundansgruppen.

properties.readOnlyEndpoint

InstanceFailoverGroupReadOnlyEndpoint

Skrivskyddad slutpunkt för redundansklusterinstansen.

properties.readWriteEndpoint

InstanceFailoverGroupReadWriteEndpoint

Skrivskyddad slutpunkt för redundansklusterinstansen.

properties.replicationRole

InstanceFailoverGroupReplicationRole

Den lokala replikeringsrollen för redundansklusterinstansen.

properties.replicationState

string

Replikeringstillstånd för redundansklusterinstansen.

properties.secondaryType

SecondaryInstanceType

Typ av geo-sekundär instans. Ange "Vänteläge" om instansen endast används som dr-alternativ.

systemData

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

ReadOnlyEndpointFailoverPolicy

Redundansprincip för den skrivskyddade slutpunkten för redundansgruppen.

InstanceFailoverGroupReadWriteEndpoint

Skrivskyddad slutpunkt för redundansklusterinstansen.

Name Typ Description
failoverPolicy

ReadWriteEndpointFailoverPolicy

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

InstanceFailoverGroupReplicationRole

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

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

createdByType

Den typ av identitet som senast ändrade resursen.