Esegue il failover di un'istanza gestita.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/failover?api-version=2021-11-01
Con parametri facoltativi:
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/failover?replicaType={replicaType}&api-version=2021-11-01
Parametri dell'URI
| Nome |
In |
Necessario |
Tipo |
Descrizione |
|
managedInstanceName
|
path |
True
|
string
|
Nome dell'istanza gestita di cui eseguire il failover.
|
|
resourceGroupName
|
path |
True
|
string
|
Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale.
|
|
subscriptionId
|
path |
True
|
string
|
ID sottoscrizione che identifica una sottoscrizione di Azure.
|
|
api-version
|
query |
True
|
string
|
Versione dell'API da usare per la richiesta.
|
|
replicaType
|
query |
|
ReplicaType
|
Tipo di replica di cui eseguire il failover.
|
Risposte
| Nome |
Tipo |
Descrizione |
|
200 OK
|
|
Completato il failover dell'istanza gestita.
|
|
202 Accepted
|
|
Il failover dell'istanza gestita è in corso.
|
|
Other Status Codes
|
|
Risposte di errore:
400 ManagedInstanceFailoverThrottled: è stato eseguito un failover recente nell'istanza gestita.
400 ManagedInstanceFailoverNotSupportedOnSKU: questo tipo di failover avviato dal cliente non è supportato nello SKU specificato.
404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato
404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.
404 OperationIdNotFound- L'operazione con ID non esiste.
409 ManagedInstanceFailoverFullBackupMissing : il backup automatizzato deve completare il primo backup completo per un nuovo database.
409 ManagedInstanceNotInStateToFailover: l'istanza gestita è attualmente in uno stato in modo che non sia possibile eseguire il failover.
409 OperationCancelled - L'operazione è stata annullata dall'utente.
409 Operazione interrotta- Impossibile completare l'operazione sulla risorsa perché è stata interrotta da un'altra operazione sulla stessa risorsa.
429 SubscriptionTooManyCreateUpdateRequests: richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.
429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.
500 OperationTimedOut: timeout dell'operazione e rollback automatico. Ripetere l'operazione.
503 TooManyRequests: richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.
|
Esempio
Failover a managed instance.
Esempio di richiesta
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
Definizioni
ReplicaType
Tipo di replica di cui eseguire il failover.
| Nome |
Tipo |
Descrizione |
|
Primary
|
string
|
|
|
ReadableSecondary
|
string
|
|