Dela via


Replication Links - Failover

Redundansväxlar från den aktuella primära servern till den här servern.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/replicationLinks/{linkId}/failover?api-version=2021-11-01

URI-parametrar

Name I Obligatorisk Typ Description
databaseName
path True

string

Namnet på databasen.

linkId
path True

string

Namnet på replikeringslänken.

resourceGroupName
path True

string

Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.

serverName
path True

string

Namnet på servern.

subscriptionId
path True

string

Det prenumerations-ID som identifierar en Azure-prenumeration.

api-version
query True

string

DEN API-version som ska användas för begäran.

Svar

Name Typ Description
200 OK

ReplicationLink

Har växlats över.

202 Accepted

Redundansåtgärd pågår.

Other Status Codes

Felsvar: ***

  • 400 ReplicationLinksReplicationLinkNameIsInvalid – Replikeringslänkens namn ska vara ett giltigt GUID.

  • 400 GeoReplicationDatabaseNotSecondary – Åtgärden förväntar sig att databasen är ett replikeringsmål.

  • 400 LedgerNoDropLink – Geo-replikering kan inte stoppas eftersom Ledger Digest Uploads är aktiverat för databasen. Inaktivera Ledger Digest Uploads (Sammanfattade transaktionsregister) och försök igen.

  • 400 CannotUseTrailingWhitespacesInDatabaseName – Verifieringen av databasnamn misslyckades.

  • 400 GeoReplicationDatabaseNotSecondary – Åtgärden förväntar sig att databasen är ett replikeringsmål.

  • 400 CannotUseReservedDatabaseName – Det går inte att använda reserverade databasnamn i den här åtgärden.

  • 400 InvalidServerName – Ogiltigt servernamn har angetts.

  • 400 PlannedFailoverTimedOut – Användaren anropade planerad felövergång och tidsgränsen uppnåddes vid försök att kontakta partnerhanteringstjänsten.

  • 400 InvalidIdentifier – identifieraren innehåller NULL eller ett ogiltigt unicode-tecken.

  • 400 IncorrectReplicationLinkState – Åtgärden förväntar sig att databasen är i ett förväntat tillstånd på replikeringslänken.

  • 404 OperationIdNotFound – åtgärden med ID finns inte.

  • 404 ResourceNotFound – Den begärda resursen hittades inte.

  • 404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte

  • 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen.

  • 404 OperationIdNotFound – åtgärden med ID finns inte.

  • 404 DatabaseDoesNotExist – Användaren har angett ett databasnamn som inte finns på den här serverinstansen.

  • 409 OperationCancelled – Åtgärden har avbrutits av användaren.

  • 409 OperationInterrupted – Det gick inte att slutföra åtgärden på resursen eftersom den avbröts av en annan åtgärd på samma resurs.

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship – En replikerings seeding-åtgärd utfördes på en databas som redan finns i en replikeringsrelation.

  • 409 GeoReplicationCannotBecomePrimaryDuringUndo – Användaren försökte redundanshantera eller tvinga fram en geo-länk medan den sekundära är i ett tillstånd där den kanske inte är fysiskt konsekvent och därför inte kan ange den primära rollen.

  • 409 DuplicateGeoDrRelation – databaserna är redan i en replikeringsrelation. Det här är en dubblettbegäran.

  • 409 UpdateSloInProgress – Användaren försökte initiera en inkompatibel åtgärd medan en SLO-uppdatering pågick.

  • 409 ManagementServiceDatabaseBusy – databasen är{0} upptagen med en annan åtgärd. Försök utföra åtgärden senare.

  • 409 ConflictingSystemOperationInProgress – En systemunderhållsåtgärd pågår på databasen och ytterligare åtgärder måste vänta tills den har slutförts.

  • 409 FailoverGroupAlreadySetup – Åtgärden kan inte utföras eftersom geo-replikeringslänken är en del av en redundansgrupp. Du måste ta bort databasen från gruppen för att kunna avsluta eller redundans.

  • 429 SubscriptionTooManyCreateUpdateRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

  • 429 SubscriptionTooManyRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

  • 500 OperationTimedOut – Tidsgränsen för åtgärden uppnåddes och återställdes automatiskt. Försök att utföra åtgärden igen.

  • 503 TooManyRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

Exempel

Exempelbegäran

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

Exempelsvar

{
  "properties": {
    "partnerServer": "testsvr",
    "partnerDatabase": "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"
}

Definitioner

Name Description
ReplicationLink

En replikeringslänk.

ReplicationLinkType

Länktyp (GEO, NAMNGIVEN, VÄNTELÄGE).

ReplicationRole

Lokal replikeringsroll.

ReplicationState

Replikeringstillstånd (VÄNTAR, SEEDING, CATCHUP, SUSPENDED).

En replikeringslänk.

Name Typ Description
id

string

Resurs-ID.

name

string

Resursnamn.

properties.isTerminationAllowed

boolean

Om användaren för närvarande tillåts att avsluta länken.

properties.linkType

ReplicationLinkType

Länktyp (GEO, NAMNGIVEN, VÄNTELÄGE).

properties.partnerDatabase

string

Resurspartnerdatabas.

properties.partnerLocation

string

Plats för resurspartner.

properties.partnerRole

ReplicationRole

Partnerreplikeringsroll.

properties.partnerServer

string

Resurspartnerserver.

properties.percentComplete

integer

Procent för seeding-slutförande för länken.

properties.replicationMode

string

Replikeringsläge.

properties.replicationState

ReplicationState

Replikeringstillstånd (VÄNTAR, SEEDING, CATCHUP, SUSPENDED).

properties.role

ReplicationRole

Lokal replikeringsroll.

properties.startTime

string

Tidpunkt då länken skapades.

type

string

Resurstyp.

ReplicationLinkType

Länktyp (GEO, NAMNGIVEN, VÄNTELÄGE).

Name Typ Description
GEO

string

NAMED

string

STANDBY

string

ReplicationRole

Lokal replikeringsroll.

Name Typ Description
Copy

string

NonReadableSecondary

string

Primary

string

Secondary

string

Source

string

ReplicationState

Replikeringstillstånd (VÄNTAR, SEEDING, CATCHUP, SUSPENDED).

Name Typ Description
CATCH_UP

string

PENDING

string

SEEDING

string

SUSPENDED

string