Replication Links - Failover

Service:

SQL Database

API-versie:

2021-11-01

Failover van de huidige primaire server naar deze server.

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-parameters

Name	In	Vereist	Type	Description
databaseName	path	True	string	De naam van de database.
linkId	path	True	string	De naam van de replicatiekoppeling.
resourceGroupName	path	True	string	De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
serverName	path	True	string	De naam van de server.
subscriptionId	path	True	string	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
api-version	query	True	string	De API-versie die moet worden gebruikt voor de aanvraag.

Antwoorden

Name	Type	Description
200 OK	ReplicationLink	De failover is geslaagd.
202 Accepted		De failoverbewerking wordt uitgevoerd.
Other Status Codes		Foutreacties: *** 400 ReplicationLinksReplicationLinkNameIsInvalid: de naam van de replicatiekoppeling moet een geldige GUID zijn. 400 GeoReplicationDatabaseNotSecondary: de bewerking verwacht dat de database een replicatiedoel is. 400 LedgerNoDropLink - Geo-replicatie kan niet worden gestopt omdat de database Ledger Digest Uploads heeft ingeschakeld. Schakel Ledger Digest Uploads uit en voer de bewerking opnieuw uit. 400 CannotUseTrailingWhitespacesInDatabaseName - De validatie van de databasenaam is mislukt. 400 GeoReplicationDatabaseNotSecondary: de bewerking verwacht dat de database een replicatiedoel is. 400 CannotUseReservedDatabaseName : kan de gereserveerde databasenaam niet gebruiken in deze bewerking. 400 InvalidServerName - Ongeldige servernaam opgegeven. 400 PlannedFailoverTimedOut: gebruiker heeft geplande failover aangeroepen en er is een time-out opgetreden tijdens het contact opnemen met de partnerbeheerservice. 400 InvalidIdentifier: de id bevat NULL of een ongeldig Unicode-teken. 400 IncorrectReplicationLinkState- De bewerking verwacht dat de database een verwachte status heeft op de replicatiekoppeling. 404 OperationIdNotFound - De bewerking met id bestaat niet. 404 ResourceNotFound - De aangevraagde resource is niet gevonden. 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 ServerNotInSubscriptionResourceGroup : de opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement. 404 OperationIdNotFound - De bewerking met id bestaat niet. 404 DatabaseDoesNotExist - Gebruiker heeft een databasenaam opgegeven die niet bestaat op dit serverexemplaren. 409 OperationCancelled : de bewerking is geannuleerd door de gebruiker. 409 Bewerking onderbroken: de bewerking op de resource kan niet worden voltooid omdat deze is onderbroken door een andere bewerking op dezelfde resource. 409 InvalidOperationForDatabaseNotInReplicationRelationship : er is een replicatiesedingbewerking uitgevoerd op een database die al een replicatierelatie heeft. 409 GeoReplicationCannotBecomePrimaryDuringUndo - Gebruiker heeft geprobeerd een geo-link te failovern of geforceerd te beëindigen terwijl de secundaire verbinding zich in een toestand bevindt waarin deze mogelijk niet fysiek consistent is en dus de primaire rol niet kan invoeren. 409 DuplicateGeoDrRelation : de databases bevinden zich al in een replicatierelatie. Dit is een dubbele aanvraag. 409 UpdateSloInProgress - Gebruiker heeft geprobeerd een incompatibele bewerking te starten terwijl een SLO-update werd uitgevoerd. 409 ManagementServiceDatabaseBusy - Database '{0}' is bezig met een andere bewerking. Probeer de bewerking later uit. 409 ConflictingSystemOperationInProgress - Er wordt een systeemonderhoudsbewerking uitgevoerd op de database en verdere bewerkingen moeten wachten totdat deze is voltooid. 409 FailoverGroupAlreadySetup: de bewerking kan niet worden uitgevoerd omdat de geo-replicatiekoppeling deel uitmaakt van een failovergroep. U moet de database uit de groep verwijderen om afzonderlijk te kunnen beëindigen of failover. 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources. 429 SubscriptionTooManyRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources. 500 OperationTimedOut: er is een time-out opgetreden voor de bewerking en deze is automatisch teruggedraaid. Probeer de bewerking opnieuw uit te voeren. 503 TooManyRequests: aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

Voorbeelden

Planned failover of a replication link

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:

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

Statuscode:

202

Definities

Name	Description
ReplicationLink	Een replicatiekoppeling.
ReplicationLinkType	Koppelingstype (GEO, BENOEMD, STAND-BY).
ReplicationRole	Lokale replicatierol.
ReplicationState	Replicatiestatus (IN BEHANDELING, SEEDING, CATCHUP, ONDERBROKEN).

ReplicationLink

Object

Een replicatiekoppeling.

Name	Type	Description
id	string	Resource-id.
name	string	Resourcenaam.
properties.isTerminationAllowed	boolean	Of de gebruiker momenteel de koppeling mag beëindigen.
properties.linkType	ReplicationLinkType	Koppelingstype (GEO, BENOEMD, STAND-BY).
properties.partnerDatabase	string	Resourcepartnerdatabase.
properties.partnerLocation	string	Locatie van resourcepartner.
properties.partnerRole	ReplicationRole	Partnerreplicatierol.
properties.partnerServer	string	Bronpartnerserver.
properties.percentComplete	integer	Voltooiingspercentage seeding voor de koppeling.
properties.replicationMode	string	Replicatiemodus.
properties.replicationState	ReplicationState	Replicatiestatus (IN BEHANDELING, SEEDING, CATCHUP, ONDERBROKEN).
properties.role	ReplicationRole	Lokale replicatierol.
properties.startTime	string	Tijdstip waarop de koppeling is gemaakt.
type	string	Resourcetype.

ReplicationLinkType

Inventarisatie

Koppelingstype (GEO, BENOEMD, STAND-BY).

Waarde	Description
GEO
NAMED
STANDBY

ReplicationRole

Inventarisatie

Lokale replicatierol.

Waarde	Description
Copy
NonReadableSecondary
Primary
Secondary
Source

ReplicationState

Inventarisatie

Replicatiestatus (IN BEHANDELING, SEEDING, CATCHUP, ONDERBROKEN).

Waarde	Description
CATCH_UP
PENDING
SEEDING
SUSPENDED