Failovers uitvoeren voor een beheerd exemplaar.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/failover?api-version=2021-11-01
Met optionele parameters:
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/failover?replicaType={replicaType}&api-version=2021-11-01
URI-parameters
Name |
In |
Vereist |
Type |
Description |
managedInstanceName
|
path |
True
|
string
|
De naam van het beheerde exemplaar voor failover.
|
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.
|
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.
|
replicaType
|
query |
|
ReplicaType
|
Het type replica waarvoor een failover moet worden uitgevoerd.
|
Antwoorden
Name |
Type |
Description |
200 OK
|
|
De failover van het beheerde exemplaar is voltooid.
|
202 Accepted
|
|
Failover van beheerd exemplaar wordt uitgevoerd.
|
Other Status Codes
|
|
Foutreacties: ***
400 ManagedInstanceFailoverThrottled : er is een recente failover op het beheerde exemplaar uitgevoerd.
400 ManagedInstanceFailoverNotSupportedOnSKU: dit type door de klant geïnitieerde failover wordt niet ondersteund op de opgegeven SKU.
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.
409 ManagedInstanceFailoverFullBackupMissing - Automatische back-up moet de eerste volledige back-up voor een nieuwe database voltooien.
409 ManagedInstanceNotInStateToFailover: het beheerde exemplaar heeft momenteel een zodanige status dat er geen failover kan worden uitgegeven.
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.
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
Failover a managed instance.
Voorbeeldaanvraag
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
Definities
ReplicaType
Het type replica waarvoor een failover moet worden uitgevoerd.
Name |
Type |
Description |
Primary
|
string
|
|
ReadableSecondary
|
string
|
|