Replication Links - Failover

Tjänst:

SQL Database

API-version:

2021-11-01

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

Planned failover of a replication link

Exempelbegäran

HTTP

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

Java

/**
 * Samples for ReplicationLinks Failover.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ReplicationLinkFailover.json
     */
    /**
     * Sample code: Planned failover of a replication link.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void plannedFailoverOfAReplicationLink(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getReplicationLinks().failover("Default", "sourcesvr", "gamma-db",
            "4891ca10-ebd0-47d7-9182-c722651780fb", com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Exempelsvar

Statuskod:

200

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

Statuskod:

202

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).

ReplicationLink

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