Managed Instances - Failover

Reference

Služba:: SQL Database

Verze rozhraní API:: 2021-11-01

Převzetí služeb při selhání spravované instance

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/failover?api-version=2021-11-01

S volitelnými parametry:

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/failover?replicaType={replicaType}&api-version=2021-11-01

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
managedInstanceName	path	True	string	Název spravované instance pro převzetí služeb při selhání.
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.
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.
replicaType	query		ReplicaType	Typ repliky, která se má převzít při selhání.

Odpovědi

Name	Typ	Description
200 OK		Převzetí služeb při selhání spravované instance se úspěšně dokončilo.
202 Accepted		Probíhá převzetí služeb při selhání spravované instance.
Other Status Codes		Chybové odpovědi: *** 400 ManagedInstanceFailoverThrottled – nedávno došlo k převzetí služeb při selhání spravované instance. 400 ManagedInstanceFailoverNotSupportedOnSKU – Tento typ převzetí služeb při selhání iniciovaného zákazníkem se v dané skladové poku nepodporuje. 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. 409 ManagedInstanceFailoverFullBackupMissing – Automatizované zálohování potřebuje k dokončení prvního úplného zálohování nové databáze. 409 ManagedInstanceNotInStateToFailover – spravovaná instance je v současné době ve stavu, kdy nelze provést převzetí služeb při selhání. 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. 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.

Name

Typ

Description

200 OK

Převzetí služeb při selhání spravované instance se úspěšně dokončilo.

202 Accepted

Probíhá převzetí služeb při selhání spravované instance.

Other Status Codes

Chybové odpovědi: ***

400 ManagedInstanceFailoverThrottled – nedávno došlo k převzetí služeb při selhání spravované instance.
400 ManagedInstanceFailoverNotSupportedOnSKU – Tento typ převzetí služeb při selhání iniciovaného zákazníkem se v dané skladové poku nepodporuje.
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.
409 ManagedInstanceFailoverFullBackupMissing – Automatizované zálohování potřebuje k dokončení prvního úplného zálohování nové databáze.
409 ManagedInstanceNotInStateToFailover – spravovaná instance je v současné době ve stavu, kdy nelze provést převzetí služeb při selhání.
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.
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

Failover a managed instance.

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/managedInstances/instanceName/failover?replicaType=Primary&api-version=2021-11-01


import com.azure.resourcemanager.sql.models.ReplicaType;

/**
 * Samples for ManagedInstances Failover.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/FailoverManagedInstance.json
     */
    /**
     * Sample code: Failover a managed instance.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void failoverAManagedInstance(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstances().failover("group1", "instanceName",
            ReplicaType.PRIMARY, 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

Stavový kód:: 202

Definice

ReplicaType

Typ repliky, která se má převzít při selhání.

Name	Typ	Description
Primary	string
ReadableSecondary	string

Sdílet prostřednictvím