Megosztás:

Replication Links - Failover

Szolgáltatás:
SQL Database
API-verzió:
2023-08-01

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}/databases/{databaseName}/replicationLinks/{linkId}/failover?api-version=2023-08-01

URI-paraméterek

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

string

Az adatbázis neve.
linkId
 path True

string

A replikációs hivatkozás 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 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

ReplicationLink

A feladatátvétel sikeresen megtörtént.
202 Accepted

A feladatátvételi művelet folyamatban van.

Fejlécek

Location: string
Other Status Codes

ErrorResponse

Hibaválaszok: ***

  • 400 ReplicationLinksReplicationLinkNameIsInvalid – A replikációs hivatkozás nevének érvényes guidnak kell lennie.

  • 400 GeoReplicationDatabaseNotSecondary – A művelet azt várja, hogy az adatbázis replikációs cél legyen.

  • 400 ReplicationLinksReplicationLinkTypeIsInvalid – A LinkType érvénytelen. Az érvényes értékek a STANDBY és a GEO.

  • 400 ReplicationLinksCreateIsNotSupported – A replikációs hivatkozás létrehozása nem támogatott.

  • 400 LedgerNoDropLink – A georeplikációs folyamat nem állítható le, mert az adatbázisban engedélyezve vannak a Ledger Digest-feltöltések. Tiltsa le a Ledger Digest-feltöltéseket, és próbálkozzon újra a művelettel.

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

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

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

  • 400 ManagedInstanceStoppingOrStopped – Ütköző művelet van elküldve, miközben a példány leáll/leállított állapotban van

  • 400 ManagedInstanceStarting – Ütköző művelet küldve, miközben a példány kezdő állapotban van

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

  • 400 GeoReplicationDatabaseNotSecondary – A művelet azt várja, hogy az adatbázis replikációs cél legyen.

  • 400 CannotUseTrailingWhitespacesInDatabaseName – Az adatbázisnév érvényesítése nem sikerült.

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

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

  • 400 VBSEnclaveNotSupportedForGeoReplicationWithDefaultEnclave – A georeplikáció konfigurálása nem támogatott az előnyben részesítettEnclaveType tulajdonság különböző értékeit használó adatbázisok esetében. Az elsődleges "{0}' adatbázis a '{1}' kiszolgálón a '{2}' preferredEnclaveType- t használja, míg a másodlagos '{3}' adatbázishoz megadott preferáltEnclaveType a '{4}' kiszolgálón '{5}'.

  • 400 VBSEnclaveNotSupportedForPlannedFailoverBetweenDatabasesWithDifferentPreferredEnclaveTypes – A virtualizációalapú biztonsági (VBS) enklávék nem támogatják az elsődleges és a másodlagos adatbázis közötti tervezett feladatátvételt különböző preferáltEnclaveType értékkel.

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

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

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

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

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

  • 404 SubscriptionDoesNotHaveServer – A kért kiszolgáló nem található

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

  • 404 DatabaseDoesNotExist – A felhasználó olyan adatbázisnevet adott meg, amely nem létezik ezen a kiszolgálópéldányon.

  • 409 CannotCancelOperation – A felügyeleti művelet olyan állapotban van, amely nem törölhető.

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

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

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

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship – Replikációs műveletet hajtottak végre egy olyan adatbázisban, amely nincs replikációs kapcsolatban.

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

  • 409 DuplicateGeoDrRelation – Az adatbázisok már replikációs kapcsolatban vannak. Ez egy ismétlődő kérés.

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

  • 409 ManagementServiceDatabaseBusy – Az adatbázis{0}' egy másik művelettel van elfoglalva. Próbálkozzon később a művelettel.

  • 409 Feladatátvételi csoportAlreadySetup – A művelet nem hajtható végre, mert a georeplikációs kapcsolat egy feladatátvételi csoport része. Az adatbázist el kell távolítania a csoportból, hogy külön-külön le lehessen fejezni vagy feladatátvételt lehessen végezni.

  • 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ó kérelmek maximálisnál több kérése.

  • 500 OperationTimedOut – A művelet túllépte az időkorlátot, és automatikusan visszagördült. Próbálkozzon újra a művelettel.

  • 503 TooManyRequests – A rendelkezésre álló erőforrások által feldolgozható maximális kérelmeken túli kérések.

Példák

Mintakérelem

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/4891ca10-ebd0-47d7-9182-c722651780fb/failover?api-version=2023-08-01

Mintaválasz

Állapotkód:
200 
{
  "properties": {
    "partnerServer": "testsvr",
    "partnerDatabase": "gamma-db",
    "partnerDatabaseId": "/subscriptions/00000000-1111-2222-3333-555555555555/resourceGroups/Second-Default/providers/Microsoft.Sql/servers/testsvr/databases/gamma-db",
    "partnerLocation": "Japan East",
    "role": "Primary",
    "partnerRole": "Secondary",
    "replicationMode": "ASYNC",
    "startTime": "2018-06-21T08:12:43.783Z",
    "percentComplete": 100,
    "replicationState": "CATCH_UP",
    "isTerminationAllowed": true,
    "linkType": "GEO"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/sourcesvr/databases/gamma-db/replicationLinks/4891ca10-ebd0-47d7-9182-c722651780fb",
  "name": "4891ca10-ebd0-47d7-9182-c722651780fb"
}
Állapotkód:
202 
Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/JapanWest/replicationLinksOperationResults/replicationlink-group-test-3?api-version=2022-05-01-preview

Definíciók

Name Description
ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.
ErrorDetail

A hiba részletei.
ErrorResponse

Hibaválasz
ReplicationLink

Replikációs hivatkozás.
ReplicationLinkType

Hivatkozás típusa (GEO, NAMED, STANDBY). A frissítési művelet nem támogatja a NAMED nevet.
ReplicationRole

Helyi replikációs szerepkör.
ReplicationState

Replikáció állapota (FÜGGŐBEN, VETÉS, FELZÁRKÓZÁS, FELFÜGGESZTVE).

ErrorAdditionalInfo

Objektum

Az erőforrás-kezelési hiba további információi.

Name Típus Description
info

object

A további információk.
type

string

A további információtípus.

ErrorDetail

Objektum

A hiba részletei.

Name Típus Description
additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.
code

string

A hibakód.
details

ErrorDetail[]

A hiba részletei.
message

string

A hibaüzenet.
target

string

A hibacél.

ErrorResponse

Objektum

Hibaválasz

Name Típus Description
error

ErrorDetail

A hibaobjektum.
Objektum

Replikációs hivatkozás.

Name Típus Description
id

string

Erőforrás-azonosító.
name

string

Erőforrás neve.
properties.isTerminationAllowed

boolean

Azt jelzi, hogy a felhasználónak jelenleg engedélyezve van-e a hivatkozás leállítása.
properties.linkType

ReplicationLinkType

Hivatkozás típusa (GEO, NAMED, STANDBY). A frissítési művelet nem támogatja a NAMED nevet.
properties.partnerDatabase

string

Erőforráspartner-adatbázis.
properties.partnerDatabaseId

string

Erőforráspartner adatbázis-azonosítója.
properties.partnerLocation

string

Erőforráspartner helye.
properties.partnerRole

ReplicationRole

Partnerreplikációs szerepkör.
properties.partnerServer

string

Erőforrás-partnerkiszolgáló.
properties.percentComplete

integer (int32)

A vetés befejezésének százalékos aránya a hivatkozáshoz.
properties.replicationMode

string

Replikációs mód.
properties.replicationState

ReplicationState

Replikáció állapota (FÜGGŐBEN, VETÉS, FELZÁRKÓZÁS, FELFÜGGESZTVE).
properties.role

ReplicationRole

Helyi replikációs szerepkör.
properties.startTime

string (date-time)

A hivatkozás létrehozásának időpontja.
type

string

Erőforrás típusa.

ReplicationLinkType

Enumerálás

Hivatkozás típusa (GEO, NAMED, STANDBY). A frissítési művelet nem támogatja a NAMED nevet.

Érték Description
GEO
NAMED
STANDBY

ReplicationRole

Enumerálás

Helyi replikációs szerepkör.

Érték Description
Primary
Secondary
NonReadableSecondary
Source
Copy

ReplicationState

Enumerálás

Replikáció állapota (FÜGGŐBEN, VETÉS, FELZÁRKÓZÁS, FELFÜGGESZTVE).

Érték Description
PENDING
SEEDING
CATCH_UP
SUSPENDED