Failover Groups - Failover

Feladatátvétel az aktuális elsődleges kiszolgálóról erre a kiszolgálóra.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/failoverGroups/{failoverGroupName}/failover?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.

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.

serverName
path True

string

A feladatátvételi csoportot tartalmazó kiszolgáló neve.

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álni kívánt API-verzió.

Válaszok

Name Típus Description
200 OK

FailoverGroup

A feladatátvétel sikerült.

202 Accepted

Elfogadva

Other Status Codes

Hibaválaszok: ***

  • 400 Feladatátvételi csoportCreateOrUpdateRequestInvalidDatabases – A megadott adatbázis-azonosítók nem megfelelően összeállított adatbázis-erőforrásazonosítók. A megfelelő formázás példájáért lásd: https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 Feladatátvételi csoportLétrehozásOrUpdateRequestInvalidPartner – A feladatátvételi csoport kérelemtörzsének létrehozása vagy frissítése során megadott partnerek mező üres vagy érvénytelen. Adja meg a mező érvényes értékét. A megfelelően formázott kérésekre példákat a következő témakörben talál: https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

  • 400 Feladatátvételi csoportLétrehozásOrUpdateRequestDuplicatePartner – A megadott partnerkiszolgálók közül legalább egy már része a feladatátvételi csoportnak. Győződjön meg arról, hogy az elsődleges kiszolgáló és az összes megadott partnerkiszolgáló egyedi.

  • 400 Feladatátvételi csoportLétrehozásOrUpdateRequestInvalidDatabaseServer – A megadott adatbázisok közül legalább egy nem létezik a feladatátvételi csoport elsődleges kiszolgálóján. Győződjön meg arról, hogy az összes adatbázis létezik az elsődleges kiszolgálón.

  • 400 Feladatátvételi csoportLétrehozásOrUpdateRequestUnsupportedPartnerCount – A feladatátvételi csoporthoz csak egy partnerkiszolgáló támogatott. Ennek megfelelően módosítsa a kérést. Érvényes kérések példáiért lásd: https://docs.microsoft.com/en-us/rest/api/sql/failovergroups/createorupdate

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

  • 400 Feladatátvételi csoportLétrehozásOrUpdateRequestInvalid – A feladatátvételi csoport létrehozásának vagy frissítésének kérelemtörzse üres vagy érvénytelen.

  • 400 Feladatátvételi csoportUpdateOrDeleteRequestOnSecondary – A feladatátvételi csoport módosításai nem engedélyezettek másodlagos kiszolgálón. Hajtsa végre a kérést az elsődleges kiszolgálón.

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

  • 400 Feladatátvételi csoportLétrehozásOrUpdateRequestLessThanMinimumGracePeriodValues – A feladatátvételi csoport türelmi időszakának értéke nem lehet nagyobb vagy egyenlő a minimális türelmi időszak ""{0} percével vagy értékével

  • 400 Feladatátvételi csoportLétrehozásOrUpdateRequestInvalidReadWriteEndpointFields – A failoverWithDataLossGracePeriodMinutes 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 Feladatátvételi csoportCreateOrUpdateRequestInvalidReadWriteFailoverPolicy – 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 Feladatátvételi csoportLétrehozásOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy – A türelmi időszak értéke nem adható meg, ha a feladatátvételi szabályzat manuális beállítása van kiválasztva az olvasási-írási végponthoz. Távolítsa el a kérésből.

  • 400 Feladatátvételi csoportLétrehozásOrUpdateRequestReadOnlyPropertyModified – A feladatátvételi csoport létrehozásának vagy frissítésének kérelemtörzse nem módosíthatja a ""{0} írásvédett tulajdonságot.

  • 400 FailoverGroupFailoverRequestOnPrimary – A feladatátvételi kérelmet a feladatátvételi csoport másodlagos kiszolgálóján kell kezdeményezni.

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

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

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

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

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

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

  • 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 PartnerServerNotCompatible – A felhasználó egy SAWA V1-kiszolgálóról próbál adatbázist egy Sterling-kiszolgálóra másolni, vagy fordítva.

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

  • 400 ResourcePoolNotFound – A megadott rugalmas készlet nem létezik a megadott logikai kiszolgálón.

  • 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 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 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 CannotUseReservedDatabaseName – Ebben a műveletben nem használható fenntartott adatbázisnév.

  • 400 InvalidFailoverGroupRegion – A feladatátvételi csoportban 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 FailoverGroupDoesNotExist – A feladatátvételi csoport nem létezik kiszolgálón.

  • 400 Feladatátvételi csoportNotSecondary – Feladatátvétel nem kezdeményezhető feladatátvételi csoport elsődleges kiszolgálójáról.

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

  • 400 DatabaseInFailoverGroupNotPrimary – Az adatbázis geoDR-hivatkozása már létezik, de szerepköre nem "Elsődleges", vagy nem folyamatos másolási hivatkozás.

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

  • 400 UnableToCreateFailoverGroupDueToTableAuditing – A feladatátvételi csoport nem hozható létre olyan kiszolgálóhoz, amelyen be van kapcsolva a táblanaplózás.

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

  • 400 UnableToAddDbWithTableAuditingToFailoverGroup – A táblanaplózást engedélyező adatbázis nem lesz elérhető a feladatátvételi csoport végponton keresztül.

  • 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 LimitOfFailoverGroupsPerServerExceeded – Az új feladatátvételi csoport létrehozása meghaladja a feladatátvételi csoportok kiszolgálónként engedélyezett számát.

  • 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 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 SameKeyMaterialNotFoundOnRemoteServer – A másodlagos kiszolgáló nem rendelkezik az elsődleges kiszolgáló titkosítási védőjének kulcsanyagával.

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

  • 400 GeoReplicaLimitReached – Elérte a replikánkénti replikáció korlátját.

  • 400 Feladatátvételi csoportWithVirtualNetworkRulesNotSupported – Az automatikus feladatátvételi szabályzattal konfigurált feladatátvételi csoportok jelenleg nem támogatottak a virtuális hálózati tűzfalszabályokkal konfigurált kiszolgálókon. Konfigurálja a feladatátvételi csoportot manuális feladatátvételi szabályzattal.

  • 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 RemoteDatabaseCopyPermission – A felhasználó nem rendelkezik elegendő engedéllyel ahhoz, hogy adatbázis-másolatot hozzon létre a megadott kiszolgálón.

  • 400 SecurityAzureKeyVaultGeoChainError – A másodlagos (láncolásnak nevezett) folyamat másodlagos létrehozása nem támogatott az Transzparens adattitkosítás engedélyezésekor az Azure Key Vault (BYOK) használatával.

  • 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 ServerNotInSubscriptionResourceGroup – A megadott kiszolgáló nem létezik a megadott erőforráscsoportban és előfizetésben.

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

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

  • 405 Nem támogatottReplicationOperation – Nem támogatott replikációs művelet indult el 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 ugyanazon az erőforráson egy másik művelet megszakította.

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

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

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

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

  • 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 UpdateSloInProgress – A felhasználó inkompatibilis műveletet próbált kezdeményezni, miközben SLO-frissítés volt folyamatban.

  • 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 Feladatátvételi csoportAlreadyExists – A feladatátvételi csoport már létezik egy adott kiszolgálón. Használjon másik feladatátvételi csoportnevet.

  • 409 FailoverGroupBusy – A feladatátvételi csoport egy másik művelettel van elfoglalva.

  • 409 DatabaseBelongsToOtherFailoverGroup – Az adatbázis más feladatátvételi csoporthoz tartozik, és nem tekinthető ennek a csoportnak.

  • 409 DatabaseBeingAddedToFailoverGroup – Az adatbázis jelenleg a feladatátvételi csoporthoz van hozzáadva, az ügyfélnek meg kell várnia, amíg a művelet befejeződik az eltávolítással.

  • 409 DatabaseBeingRemovedFromFailoverGroup – Az adatbázist jelenleg eltávolítják a feladatátvételi csoportból, az ügyfélnek meg kell várnia, amíg a művelet befejeződik a hozzáadás kiadásához.

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

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

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

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

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

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

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

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

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

  • 429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken 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érelmeken túli kérések.

  • 503 TooManyRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken 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.

  • 503 DatabaseUnavailable – A művelet meghiúsult, mert az adatbázis nem érhető el.

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

Példák

Planned failover of a failover group

Sample Request

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server/failoverGroups/failover-group-test-3/failover?api-version=2021-11-01

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server/failoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/servers/failoverGroups",
  "location": "Japan West",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 120
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "replicationRole": "Primary",
    "replicationState": "CATCH_UP",
    "partnerServers": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server",
        "location": "Japan East",
        "replicationRole": "Secondary"
      }
    ],
    "databases": [
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server/databases/testdb-1",
      "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server/databases/testdb-2"
    ]
  }
}

Definíciók

Name Description
FailoverGroup

Feladatátvételi csoport.

FailoverGroupReadOnlyEndpoint

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

FailoverGroupReadWriteEndpoint

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

FailoverGroupReplicationRole

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

PartnerInfo

A feladatátvételi csoport partnerkiszolgáló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.

FailoverGroup

Feladatátvételi csoport.

Name Típus Description
id

string

Erőforrás-azonosító.

location

string

Erőforrás helye.

name

string

Erőforrás neve.

properties.databases

string[]

A feladatátvételi csoport adatbázisainak listája.

properties.partnerServers

PartnerInfo[]

A feladatátvételi csoport partnerkiszolgálói adatainak listája.

properties.readOnlyEndpoint

FailoverGroupReadOnlyEndpoint

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

properties.readWriteEndpoint

FailoverGroupReadWriteEndpoint

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

properties.replicationRole

FailoverGroupReplicationRole

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.

tags

object

Erőforráscímkék.

type

string

Erőforrástípus.

FailoverGroupReadOnlyEndpoint

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.

FailoverGroupReadWriteEndpoint

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.

FailoverGroupReplicationRole

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

Name Típus Description
Primary

string

Secondary

string

PartnerInfo

A feladatátvételi csoport partnerkiszolgálójának adatai.

Name Típus Description
id

string

A partnerkiszolgáló erőforrás-azonosítója.

location

string

A partnerkiszolgáló földrajzi helye.

replicationRole

FailoverGroupReplicationRole

A partnerkiszolgáló 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