Replication Links - Failover

Služba:

SQL Database

Verze rozhraní API:

2021-11-01

Převzetí služeb při selhání z aktuálního primárního serveru na tento 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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
databaseName	path	True	string	Název databáze.
linkId	path	True	string	Název odkazu replikace.
resourceGroupName	path	True	string	Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API azure Resource Manager nebo z portálu.
serverName	path	True	string	Název serveru.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Odpovědi

Name	Typ	Description
200 OK	ReplicationLink	Převzetí služeb při selhání proběhlo úspěšně.
202 Accepted		Probíhá operace převzetí služeb při selhání.
Other Status Codes		Chybové odpovědi: *** 400 ReplicationLinksReplicationLinkNameIsInvalid – Název odkazu na replikaci by měl být platný identifikátor GUID. 400 GeoReplicationDatabaseNotSecondary – operace očekává, že databáze bude cílem replikace. 400 LedgerNoDropLink – Geografickou replikaci nelze zastavit, protože databáze má povolené nahrání hodnot digest ledger. Zakažte nahrání digestu Ledger a zkuste operaci zopakovat. 400 CannotUseTrailingWhitespacesInDatabaseName – ověření názvu databáze se nezdařilo. 400 GeoReplicationDatabaseNotSecondary – operace očekává, že databáze bude cílem replikace. 400 CannotUseReservedDatabaseName – V této operaci nelze použít název rezervované databáze. 400 InvalidServerName – zadaný neplatný název serveru. 400 PlannedFailoverTimedOut – uživatel vyvolal plánovaný přechod na záložní systém a při pokusu o kontaktování služby pro správu partnerů vypršel časový limit. 400 InvalidIdentifier – identifikátor obsahuje null nebo neplatný znak unicode. 400 IncorrectReplicationLinkState – operace očekává, že databáze bude v očekávaném stavu na odkazu replikace. 404 OperationIdNotFound – operace s ID neexistuje. 404 ResourceNotFound – požadovaný prostředek nebyl nalezen. 404 SubscriptionDoesNotHaveServer – požadovaný server nebyl nalezen. 404 ServerNotInSubscriptionResourceGroup – zadaný server neexistuje v zadané skupině prostředků a předplatném. 404 OperationIdNotFound – operace s ID neexistuje. 404 DatabaseDoesNotExist – Uživatel zadal název databáze, který na této instanci serveru neexistuje. 409 OperationCancelled – operace byla zrušena uživatelem. 409 OperationInterrupted – Operaci s prostředkem nebylo možné dokončit, protože byla přerušena jinou operací se stejným prostředkem. 409 InvalidOperationForDatabaseNotInReplicationRelationship – U databáze, která je již v relaci replikace, byla provedena operace seeding replikace. 409 GeoReplicationCannotBecomePrimaryDuringUndo – uživatel se pokusil o převzetí služeb při selhání nebo vynucení ukončení geografického propojení, zatímco sekundární je ve stavu, kdy nemusí být fyzicky konzistentní, a proto nemůže vstoupit do primární role. 409 DuplicateGeoDrRelation – databáze jsou již v relaci replikace. Jedná se o duplicitní požadavek. 409 UpdateSloInProgress – uživatel se pokusil zahájit nekompatibilní operaci v době, kdy probíhala aktualizace SLO. 409 ManagementServiceDatabaseBusy – Databáze{0} je zaneprázdněná jinou operací. Zkuste operaci provést později. 409 ConflictingSystemOperationInProgress – v databázi probíhá operace údržby systému a další operace musí počkat na dokončení. 409 FailoverGroupAlreadySetup – operaci nelze provést, protože propojení geografické replikace je součástí skupiny převzetí služeb při selhání. Databázi musíte ze skupiny odebrat, abyste ji mohli jednotlivě ukončit nebo provést převzetí služeb při selhání. 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 500 OperationTimedOut – časový limit operace vypršel a automaticky se vrátila zpět. Opakujte operaci. 503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.

Příklady

Planned failover of a replication link

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:

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

Stavový kód:

202

Definice

Name	Description
ReplicationLink	Replikační odkaz.
ReplicationLinkType	Typ propojení (GEO, POJMENOVANÝ, POHOTOVOSTNÍ).
ReplicationRole	Role místní replikace.
ReplicationState	STAV REPLIKACE (ČEKÁ NA VYŘÍZENÍ, SEEDING, CATCHUP, SUSPENDEDED)

ReplicationLink

Replikační odkaz.

Name	Typ	Description
id	string	ID prostředku.
name	string	Název prostředku.
properties.isTerminationAllowed	boolean	Určuje, jestli má uživatel aktuálně povoleno ukončit propojení.
properties.linkType	ReplicationLinkType	Typ propojení (GEO, POJMENOVANÝ, POHOTOVOSTNÍ).
properties.partnerDatabase	string	Databáze partnera poskytujícího prostředky.
properties.partnerLocation	string	Umístění partnera poskytujícího prostředky.
properties.partnerRole	ReplicationRole	Role replikace partnera.
properties.partnerServer	string	Server partnera poskytujícího prostředky.
properties.percentComplete	integer	Procento dokončení seedingu pro odkaz.
properties.replicationMode	string	Režim replikace.
properties.replicationState	ReplicationState	STAV REPLIKACE (ČEKÁ NA VYŘÍZENÍ, SEEDING, CATCHUP, SUSPENDEDED)
properties.role	ReplicationRole	Role místní replikace.
properties.startTime	string	Čas, ve kterém byl odkaz vytvořen.
type	string	Typ prostředku.

ReplicationLinkType

Typ propojení (GEO, POJMENOVANÝ, POHOTOVOSTNÍ).

Name	Typ	Description
GEO	string
NAMED	string
STANDBY	string

ReplicationRole

Role místní replikace.

Name	Typ	Description
Copy	string
NonReadableSecondary	string
Primary	string
Secondary	string
Source	string

ReplicationState

STAV REPLIKACE (ČEKÁ NA VYŘÍZENÍ, SEEDING, CATCHUP, SUSPENDEDED)

Name	Typ	Description
CATCH_UP	string
PENDING	string
SEEDING	string
SUSPENDED	string