Instance Failover Groups - Force Failover Allow Data Loss

Feladatátvétel az aktuális elsődleges felügyelt példányról erre a felügyelt példányra. Ez a művelet adatvesztést okozhat.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/instanceFailoverGroups/{failoverGroupName}/forceFailoverAllowDataLoss?api-version=2021-11-01

URI-paraméterek

Name In Kötelező Típus Description
failoverGroupName
path True

string

A feladatátvételi csoport neve.

locationName
path True

string

Annak a régiónak a neve, ahol az erőforrás található.

resourceGroupName
path True

string

Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.

subscriptionId
path True

string

Az Azure-előfizetést azonosító előfizetés-azonosító.

api-version
query True

string

A kéréshez használandó API-verzió.

Válaszok

Name Típus Description
200 OK

InstanceFailoverGroup

A feladatátvétel sikerült.

202 Accepted

Elfogadva

Other Status Codes

Hibaválaszok: ***

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPrimary – A példány feladatátvételi csoport kéréstörzsének létrehozása vagy frissítése során megadott elsődleges mező üres vagy érvénytelen.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPartner – A példány feladatátvételi csoportjának kéréstörzsében megadott partnerek mező üres vagy érvénytelen.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestDuplicatePartner – A megadott partnerkiszolgálók közül legalább egy már része a példány feladatátvételi csoportjának. Győződjön meg arról, hogy az elsődleges kiszolgáló és az összes megadott partnerkiszolgáló egyedi.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidManagedInstanceRegion – A példány feladatátvételi csoportjának kérelemtörzsében megadott partner által felügyelt példányrégió üres vagy érvénytelen.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount – Csak egy partnerrégió támogatott.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPairCount – Csak egy felügyelt példánypár támogatott.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint – A kérések létrehozásához vagy frissítéséhez a readWriteEndpoint mező szükséges.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalid – A példány feladatátvételi csoportjának létrehozása vagy frissítése kérelemtörzse üres vagy érvénytelen.

  • 400 InstanceFailoverGroupUpdateOrDeleteRequestOnSecondary – A példány feladatátvételi csoportjának módosítása másodlagos kiszolgálón nem engedélyezett. Hajtsa végre a kérést az elsődleges kiszolgálón.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues – Az olvasási-írási végpont türelmi időszakának értéke nem lehet negatív.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues – A példány feladatátvételi csoportjának türelmi időszakának nagyobbnak vagy egyenlőnek kell lennie a minimális türelmi időszak ""{0} percénél.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields – A feladatátvételWithDataLossGracePeriodMinutes tulajdonságot meg kell adni, ha a feladatátvételi szabályzat automatikusan be van jelölve az olvasási-írási végponthoz.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy – Az olvasási-írási végpont feladatátvételi Házirend mezőjére van szükség a létrehozási vagy frissítési kérésekhez.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy – A türelmi időszak értéke nem adható meg, ha a feladatátvételi szabályzat kézikönyve van kiválasztva az olvasási-írási végponthoz.

  • 400 InstanceFailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified – A példány feladatátvételi csoportjának létrehozása vagy frissítése kérelemtörzse nem módosíthatja a ""{0} írásvédett tulajdonságot.

  • 400 InstanceFailoverGroupFailoverRequestOnPrimary – A feladatátvételi kérelmet a példány feladatátvételi csoportjának másodlagos kiszolgálóján kell kezdeményezni.

  • 400 InstanceFailoverGroupPartnerManagedInstanceFromDifferentSubscription – Az elsődleges kiszolgáló és a feladatátvételi csoport partnerkiszolgálója különböző előfizetésekből származik. A feladatátvételi csoport kiszolgálóinak több előfizetése nem engedélyezett.

  • 400 Feladatátvételi csoportRegionMismatch – A feladatátvételi csoportban megadott partnerrégiónak meg kell egyeznie a partner által felügyelt példány által jelzett régióval.

  • 400 ServerEditionMismatch – A kiadásnak meg kell egyeznie az elsődleges kiszolgálóval replikakiszolgáló létrehozásakor.

  • 400 DnsZoneMismatch – A partnerkiszolgáló DNSZone-ja eltér a forráskiszolgáló DNSZone-jától. Ez megszakítja az InstanceFailoverGroup funkciót.

  • 400 InvalidTargetSubregion – Egy nem olvasható másodlagos kiszolgáló célkiszolgálója nem dr. párosított Azure-régióban található.

  • 400 GeoDrInstanceSizeMismatch – Az elsődleges felügyelt példány és a partner által felügyelt példány tárterülete nem azonos.

  • 400 SecurityAdalPrincipalCertExpiredError – A művelet nem hajtható végre, mert az Azure Key Vault főtanúsítványa lejárt.

  • 400 GeoDrSecondaryInstanceNotEmpty – A másodlagos felügyelt példány felhasználói adatbázisokkal rendelkezik. Példány feladatátvételi csoport létrehozásához a másodlagos felügyelt példánynak üresnek kell lennie.

  • 400 InstanceFailoverGroupIncorrectNetworkingConfiguration – A hálózati konfiguráció helytelen. Az elsődleges kiszolgáló replikációs forgalma nem éri el a másodlagos kiszolgálót.

  • 400 IncorrectReplicationLinkState – A művelet elvárja, hogy az adatbázis várt állapotban legyen a replikációs hivatkozáson.

  • 400 SecurityInvalidAzureKeyVaultRecoveryLevel – A megadott Key Vault URI érvénytelen.

  • 400 KeyMaterialNotFoundOnRemoteServer – A távoli kiszolgáló nem rendelkezik hozzáféréssel a TDE-védőként használt kulcsanyagokhoz.

  • 400 AzureKeyVaultRsaKeyNotSupported – A megadott kulcstartó nem támogatott RSA-kulcsméretet vagy kulcstípust használ. A támogatott RSA-kulcsméret 2048 vagy 3072, a kulcstípus pedig RSA vagy RSA-HSM.

  • 400 UnableToResolveRemoteServer – A távoli partnerkiszolgáló neve érvénytelen kiszolgálónév vagy DNS-kapcsolati problémák miatt nem oldható fel.

  • 400 SameKeyUriNotFoundOnRemoteServer – A másodlagos kiszolgáló nem rendelkezik a kulcsanyaggal ugyanabból a kulcstartóból, mint az elsődleges kiszolgáló titkosítási védője, és a kulcs automatikus rotálása engedélyezve van.

  • 400 RemoteDatabaseCopyPermission – A felhasználó nem rendelkezik megfelelő engedéllyel adatbázis-másolat létrehozásához a megadott kiszolgálón.

  • 400 SameKeyMaterialNotFoundOnRemoteServer – A másodlagos kiszolgáló nem rendelkezik az elsődleges kiszolgáló titkosítási védőjének kulcsanyagával.

  • 400 CannotUseReservedDatabaseName – Ebben a műveletben nem használható fenntartott adatbázisnév.

  • 400 InvalidFailoverGroupRegion – A példány feladatátvételi csoportjában megadott kiszolgálóknak különböző régiókban kell tartózkodnia az elkülönítés biztosításához.

  • 400 InstanceFailoverGroupDoesNotExist – A feladatátvételi csoport nem létezik a kiszolgálón.

  • 400 InstanceFailoverGroupNotSecondary – A feladatátvételt nem lehet kezdeményezni egy példány feladatátvételi csoportjának elsődleges kiszolgálójáról.

  • 400 InvalidServerName – Érvénytelen kiszolgálónév van megadva.

  • 400 InvalidIdentifier – Az azonosító NULL értéket vagy érvénytelen Unicode-karaktert tartalmaz.

  • 400 TokenTooLong – A megadott token túl hosszú.

  • 400 AzureKeyVaultKeyDisabled – A művelet nem hajtható végre a kiszolgálón, mert az Azure Key Vault kulcs le van tiltva.

  • 400 AzureKeyVaultInvalidExpirationDate – A művelet nem hajtható végre, mert az Azure Key Vault kulcs lejárati dátuma érvénytelen.

  • 400 SecurityAzureKeyVaultUrlNullOrEmpty – A művelet nem hajtható végre, mert az Azure Key Vault URI null értékű vagy üres.

  • 400 InvalidSku – A felhasználó érvénytelen termékváltozatot adott meg.

  • 400 InvalidAddSecondaryPermission – A felhasználó nem rendelkezik megfelelő engedéllyel a másodlagos kiszolgáló hozzáadásához.

  • 400 ServerNotFound – A kért kiszolgáló nem található.

  • 400 AzureKeyVaultNoServerIdentity – A kiszolgálóidentitás nincs megfelelően konfigurálva.

  • 400 AzureKeyVaultInvalidUri – Az Azure Key Vault érvénytelen válasza. Használjon érvényes Azure Key Vault URI-t.

  • 400 AzureKeyVaultMissingPermissions – A kiszolgáló nem rendelkezik szükséges engedélyekkel az Azure Key Vault.

  • 400 SecurityAzureKeyVaultInvalidKeyName – Érvénytelen kiszolgálókulcsnév miatt nem sikerült végrehajtani a műveletet.

  • 400 PlannedFailoverTimedOutForDatabase – A felhasználó tervezett feladatátvétel meghívott, túllépte az időkorlátot, és úgy tűnik, hogy egy adott adatbázis a hibás.

  • 400 PlannedFailoverTimedOut – A felhasználó meghívta tervezett feladatátvétel, és időtúllépést tapasztalt a partnerkezelési szolgáltatással való kapcsolatfelvétel során.

  • 400 AdalGenericError – A művelet nem hajtható végre, mert Azure Active Directory-hiba történt.

  • 400 GeoReplicationDatabaseNotSecondary – A művelet replikációs célként várja az adatbázist.

  • 400 AdalServicePrincipalNotFound – A művelet nem hajtható végre, mert egy Azure Active Directory-kódtár szolgáltatásnév nem található hiba miatt lépett fel.

  • 400 AzureKeyVaultMalformedVaultUri – A megadott Key Vault URI érvénytelen.

  • 400 FeatureDisabledOnSelectedEdition – A felhasználó olyan funkciót próbált használni, amely le van tiltva az aktuális adatbázis-kiadásban.

  • 404 OperationIdNotFound – Az azonosítóval rendelkező művelet nem létezik.

  • 404 ResourceNotFound – A kért erőforrás nem található.

  • 404 OperationIdNotFound – Az azonosítóval rendelkező művelet nem létezik.

  • 404 SourceDatabaseNotFound – A forrásadatbázis nem létezik.

  • 404 ServerNotInSubscription – A megadott kiszolgáló nem létezik a megadott előfizetésben.

  • 404 ServerNotInSubscriptionResourceGroup – A megadott kiszolgáló nem létezik a megadott erőforráscsoportban és előfizetésben.

  • 405 Nem támogatottReplicationOperation – Nem támogatott replikációs művelet lett elindítva az adatbázisban.

  • 409 OperationCancelled – A felhasználó megszakította a műveletet.

  • 409 OperationInterrupted – Az erőforráson végzett művelet nem hajtható végre, mert egy másik művelet megszakította ugyanazon az erőforráson.

  • 409 ManagedInstanceHasHybridLink – A felhasználó olyan műveletet próbált kezdeményezni, amely nem támogatott, ha a felügyelt példányhoz hibrid kapcsolat van konfigurálva.

  • 409 RemoteDatabaseExists – A céladatbázis neve már létezik a célkiszolgálón.

  • 409 ConflictingServerOperation – Folyamatban van egy művelet a kiszolgálón.

  • 409 SubscriptionDisabled – Az előfizetés le van tiltva.

  • 409 InstanceFailoverGroupAlreadyExists – A feladatátvételi csoport már létezik egy adott kiszolgálón.

  • 409 InstanceFailoverGroupBusy – A példány feladatátvételi csoportja egy másik művelettel van elfoglalva.

  • 409 GeoReplicationCannotBecomePrimaryDuringUndo – A felhasználó feladatátvételt kísérelt meg, vagy kényszerítette a geohivatkozás leállítását, miközben a másodlagos olyan állapotban van, ahol fizikailag nem konzisztens, ezért nem léphet be az elsődleges szerepkörbe.

  • 409 InstanceFailoverGroupDnsRecordInUse – A kért végponthoz duplikált DNS-rekord tartozik.

  • 409 ServerKeyNameAlreadyExists – A kiszolgálókulcs már létezik a kiszolgálón.

  • 409 ServerKeyUriAlreadyExists – A kiszolgálókulcs URI-ja már létezik a kiszolgálón.

  • 409 ServerKeyDoesNotExists – A kiszolgálókulcs nem létezik.

  • 409 InvalidFailoverGroupName – Érvénytelen példány feladatátvételi csoportnév lett megadva.

  • 409 UpdateSloInProgress – A felhasználó inkompatibilis műveletet próbált kezdeményezni, miközben egy SLO-frissítés folyamatban volt.

  • 409 AzureKeyVaultKeyNameNotFound – A művelet nem hajtható végre, mert az Azure Key Vault kulcsneve nem létezik.

  • 409 AzureKeyVaultKeyInUse – A kulcsot jelenleg a kiszolgáló használja.

  • 409 ConflictingSystemOperationInProgress – Rendszerkarbantartási művelet van folyamatban az adatbázison, és a további műveleteknek meg kell várniuk, amíg befejeződik.

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship – Replikáció-betöltési műveletet hajtottak végre egy olyan adatbázison, amely már van replikációs kapcsolatban.

  • 409 InvalidDatabaseStateForOperation – A művelet nem engedélyezett az adatbázison az aktuális replikációs állapotában.

  • 409 DuplicateGeoDrRelation – Az adatbázisok már replikációs kapcsolatban vannak. Ez egy duplikált kérés.

  • 429 SubscriptionTooManyCreateUpdateRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések.

  • 429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések.

  • 429 SubscriptionTooManyCreateUpdateRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések.

  • 429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések.

  • 500 OperationTimedOut – A művelet túllépte az időkorlátot, és automatikusan visszagördült. Please retry the operation.

  • 503 TooManyRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések.

  • 503 TooManyRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések.

  • 503 AzureKeyVaultConnectionFailed – A művelet nem hajtható végre a kiszolgálón, mert nem sikerült csatlakozni az Azure Key Vault

  • 503 AzureKeyVaultGenericConnectionError – A művelet nem hajtható végre, mert hiba történt Key Vault információ lekérésekor.

  • 504 RequestTimeout – A szolgáltatáskérés túllépte az engedélyezett időtúllépést.

Példák

Forced failover of a failover group allowing data loss

Sample Request

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=2021-11-01

Sample Response

{
  "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"
      }
    ]
  }
}

Definíciók

Name Description
InstanceFailoverGroup

Egy példány feladatátvételi csoportja.

InstanceFailoverGroupReadOnlyEndpoint

A feladatátvételi csoport példányának írásvédett végpontja.

InstanceFailoverGroupReadWriteEndpoint

A feladatátvételi csoport példányának írási-olvasási végpontja.

InstanceFailoverGroupReplicationRole

A feladatátvételi csoport példányának helyi replikációs szerepköre.

ManagedInstancePairInfo

Felügyelt példánypárok a feladatátvételi csoportban.

PartnerRegionInfo

A feladatátvételi csoport partnerrégiójának adatai.

ReadOnlyEndpointFailoverPolicy

A feladatátvételi csoport írásvédett végpontjának feladatátvételi szabályzata.

ReadWriteEndpointFailoverPolicy

A feladatátvételi csoport olvasási-írási végpontjának feladatátvételi szabályzata. Ha a feladatátvételi házirend Automatikus, akkor a feladatátvételWithDataLossGracePeriodMinutes szükséges.

InstanceFailoverGroup

Egy példány feladatátvételi csoportja.

Name Típus Description
id

string

Erőforrás-azonosító.

name

string

Erőforrás neve.

properties.managedInstancePairs

ManagedInstancePairInfo[]

A feladatátvételi csoport felügyelt példánypárjainak listája.

properties.partnerRegions

PartnerRegionInfo[]

A feladatátvételi csoport partnerrégiójának adatai.

properties.readOnlyEndpoint

InstanceFailoverGroupReadOnlyEndpoint

A feladatátvételi csoport példányának írásvédett végpontja.

properties.readWriteEndpoint

InstanceFailoverGroupReadWriteEndpoint

A feladatátvételi csoport példányának írási-olvasási végpontja.

properties.replicationRole

InstanceFailoverGroupReplicationRole

A feladatátvételi csoport példányának helyi replikációs szerepköre.

properties.replicationState

string

A feladatátvételi csoport példányának replikációs állapota.

type

string

Erőforrástípus.

InstanceFailoverGroupReadOnlyEndpoint

A feladatátvételi csoport példányának írásvédett végpontja.

Name Típus Description
failoverPolicy

ReadOnlyEndpointFailoverPolicy

A feladatátvételi csoport írásvédett végpontjának feladatátvételi szabályzata.

InstanceFailoverGroupReadWriteEndpoint

A feladatátvételi csoport példányának írási-olvasási végpontja.

Name Típus Description
failoverPolicy

ReadWriteEndpointFailoverPolicy

A feladatátvételi csoport olvasási-írási végpontjának feladatátvételi szabályzata. Ha a feladatátvételi házirend Automatikus, akkor a feladatátvételWithDataLossGracePeriodMinutes szükséges.

failoverWithDataLossGracePeriodMinutes

integer

Az adatvesztéssel járó feladatátvételt megelőző türelmi időszak az olvasási-írási végponton történik. Ha a feladatátvételi házirend Automatikus, akkor a feladatátvételWithDataLossGracePeriodMinutes szükséges.

InstanceFailoverGroupReplicationRole

A feladatátvételi csoport példányának helyi replikációs szerepköre.

Name Típus Description
Primary

string

Secondary

string

ManagedInstancePairInfo

Felügyelt példánypárok a feladatátvételi csoportban.

Name Típus Description
partnerManagedInstanceId

string

A partner által felügyelt példány azonosítója párban.

primaryManagedInstanceId

string

Az elsődleges felügyelt példány azonosítója párban.

PartnerRegionInfo

A feladatátvételi csoport partnerrégiójának adatai.

Name Típus Description
location

string

A partner által felügyelt példányok földrajzi helye.

replicationRole

InstanceFailoverGroupReplicationRole

A partner által felügyelt példányok replikációs szerepköre.

ReadOnlyEndpointFailoverPolicy

A feladatátvételi csoport írásvédett végpontjának feladatátvételi szabályzata.

Name Típus Description
Disabled

string

Enabled

string

ReadWriteEndpointFailoverPolicy

A feladatátvételi csoport olvasási-írási végpontjának feladatátvételi szabályzata. Ha a feladatátvételi házirend Automatikus, akkor a feladatátvételWithDataLossGracePeriodMinutes szükséges.

Name Típus Description
Automatic

string

Manual

string