Instance Failover Groups - Failover

Riferimento

Servizio:: SQL Database

Versione API:: 2021-11-01

Esegue il failover dall'istanza gestita primaria corrente a questa istanza gestita.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
failoverGroupName	path	True	string	Nome del gruppo di failover.
locationName	path	True	string	Nome dell'area in cui si trova la risorsa.
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.

Risposte

Nome	Tipo	Descrizione
200 OK	InstanceFailoverGroup	Failover completato.
202 Accepted		Accettato
Other Status Codes		Risposte di errore: 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPrimary: il campo primario specificato nel corpo della richiesta del gruppo di failover dell'istanza di creazione o aggiornamento è vuoto o non valido. 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPartner: il campo partner specificato nel corpo della richiesta del gruppo di failover dell'istanza di creazione o aggiornamento è vuoto o non valido. 400 InstanceFailoverGroupCreateOrUpdateRequestDuplicatePartner: uno o più server partner forniti fanno già parte del gruppo di failover dell'istanza. Assicurarsi che il server primario e tutti i server partner specificati siano univoci. 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidManagedInstanceRegion: l'area dell'istanza gestita del partner fornita nel corpo della richiesta del gruppo di failover dell'istanza è vuota o non valida. 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount: è supportata una sola area partner. 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPairCount: è supportata una sola coppia di istanze gestite. 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint: il campo readWriteEndpoint è necessario per le richieste di creazione o aggiornamento. 400 InstanceFailoverGroupCreateOrUpdateRequestInvalid- Il corpo della richiesta del gruppo di failover dell'istanza di creazione o aggiornamento è vuoto o non valido. 400 InstanceFailoverGroupUpdateOrDeleteRequestOnSecondary: le modifiche al gruppo di failover dell'istanza non sono consentite in un server secondario. Eseguire la richiesta nel server primario. 400 InstanceFailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues: il valore del periodo di tolleranza per l'endpoint di lettura/scrittura deve essere non negativo. 400 InstanceFailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues- Il valore del periodo di tolleranza per il gruppo di failover dell'istanza deve essere maggiore o uguale al periodo di tolleranza minimo dei minuti '{0}' 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields - Il failover della proprietàWithDataLossGracePeriodMinutes deve essere specificato quando viene selezionato Il criterio di failover Automatico per l'endpoint di lettura/scrittura. 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy: il campo failoverPolicy per l'endpoint di lettura/scrittura è necessario per le richieste di creazione o aggiornamento. 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy- Il valore del periodo di tolleranza non deve essere specificato quando viene selezionato Manuale dei criteri di failover per l'endpoint di lettura/scrittura. 400 InstanceFailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified: il corpo della richiesta del gruppo di failover dell'istanza di creazione o aggiornamento non deve modificare la proprietà di sola lettura '{0}'. 400 InstanceFailoverGroupFailoverRequestOnPrimary: la richiesta di failover deve essere avviata nel server secondario del gruppo di failover dell'istanza. 400 InstanceFailoverGroupPartnerManagedInstanceFromDifferentSubscription : il server primario e il server partner del gruppo di failover provengono da sottoscrizioni diverse. La sottoscrizione incrociata per i server del gruppo di failover non è consentita. 400 FailoverGroupRegionMismatch - Area partner specificata in Gruppo di failover deve corrispondere all'area dell'istanza gestita del partner indicata. 400 ServerEditionMismatch - Edition deve essere uguale al server primario durante la creazione di un server di replica. 400 DnsZoneMismatch: dnsZone nel server partner è diverso da DNSZone nel server di origine. Questa operazione interrompe la funzionalità InstanceFailoverGroup. 400 InvalidTargetSubregion: il server di destinazione di un database secondario non leggibile non si trova in un'area di Azure associata al ripristino di emergenza. 400 GeoDrInstanceSizeMismatch: l'istanza gestita primaria e l'istanza gestita del partner non hanno le stesse dimensioni di archiviazione. 400 SecurityAdalPrincipalCertExpiredError- Impossibile completare l'operazione perché il certificato dell'entità di Key Vault di Azure è scaduto. 400 GeoDrSecondaryInstanceNotEmpty : l'istanza gestita secondaria include database utente. Per creare un gruppo di failover di istanza, l'istanza gestita secondaria deve essere vuota. 400 InstanceFailoverGroupIncorrectNetworkingConfiguration - Configurazione di rete non corretta. Il traffico di replica del server primario non può raggiungere il server secondario. 400 IncorrectReplicationLinkState: l'operazione prevede che il database sia in uno stato previsto nel collegamento di replica. 400 SecurityInvalidAzureKeyVaultRecoveryLevel: l'URI Key Vault specificato non è valido. 400 KeyMaterialNotFoundOnRemoteServer - Il server remoto non ha accesso al materiale della chiave usato come protezione TDE. 400 AzureKeyVaultRsaKeyNotSupported: l'insieme di credenziali delle chiavi fornito usa le dimensioni o il tipo di chiave RSA non supportati. Le dimensioni della chiave RSA supportate sono 2048 o 3072 e il tipo di chiave è RSA o RSA-HSM. 400 UnableToResolveRemoteServer- Impossibile risolvere il nome del server partner remoto a causa di problemi di connettività DNS o nome server non validi. 400 SameKeyUriNotFoundOnRemoteServer - Il server secondario non dispone del materiale della chiave dello stesso insieme di credenziali delle chiavi della protezione di crittografia del server primario con rotazione automatica della chiave abilitata. 400 RemoteDatabaseCopyPermission: l'utente non dispone di autorizzazioni sufficienti per creare una copia del database nel server specificato. 400 SameKeyMaterialNotFoundOnRemoteServer - Il server secondario non dispone del materiale della chiave della protezione di crittografia del server primario. 400 CannotUseReservedDatabaseName- Impossibile utilizzare il nome del database riservato in questa operazione. 400 InvalidFailoverGroupRegion: i server specificati in un gruppo di failover dell'istanza devono risiedere in aree diverse per garantire l'isolamento. 400 InstanceFailoverGroupDoesNotExist - Il gruppo di failover non esiste in un server. 400 InstanceFailoverGroupNotSecondary: il failover non può essere avviato dal server primario in un gruppo di failover di istanza. 400 InvalidServerName - Nome server non valido specificato. 400 InvalidIdentifier: l'identificatore contiene NULL o un carattere Unicode non valido. 400 TokenTooLong: il token fornito è troppo lungo. 400 AzureKeyVaultKeyDisabled- Impossibile completare l'operazione nel server perché la chiave di Key Vault di Azure è disabilitata. 400 AzureKeyVaultInvalidExpirationDate- Impossibile completare l'operazione perché la data di scadenza della chiave di Azure Key Vault non è valida. 400 SecurityAzureKeyVaultUrlNullOrEmpty- Impossibile completare l'operazione perché l'URI di Azure Key Vault è null o vuoto. 400 InvalidSku: l'utente ha specificato uno SKU non valido. 400 InvalidAddSecondaryPermission: l'utente non dispone di autorizzazioni sufficienti per aggiungere secondario nel server specificato. 400 ServerNotFound: il server richiesto non è stato trovato. 400 AzureKeyVaultNoServerIdentity: l'identità del server non è configurata correttamente. 400 AzureKeyVaultInvalidUri: risposta non valida da Azure Key Vault. Usare un URI di Azure Key Vault valido. 400 AzureKeyVaultMissingPermissions: il server non dispone delle autorizzazioni necessarie per l'Key Vault di Azure. 400 SecurityAzureKeyVaultInvalidKeyName- Impossibile completare l'operazione a causa di un nome di chiave del server non valido. 400 PlannedFailoverTimedOutForDatabase - L'utente ha richiamato failover pianificato, si è timeout e un database specifico sembra essere colpa. 400 PlannedFailoverTimedOut : l'utente ha richiamato failover pianificato e si è timeout durante il tentativo di contattare il servizio di gestione dei partner. 400 AdalGenericError- Impossibile completare l'operazione perché è stato rilevato un errore di Azure Active Directory. 400 GeoReplicationDatabaseNotSecondary: l'operazione prevede che il database sia una destinazione di replica. 400 AdalServicePrincipalNotFound- Impossibile completare l'operazione perché è stato rilevato un errore di entità servizio della libreria di Azure Active Directory. 400 AzureKeyVaultMalformedVaultUri: l'URI Key Vault specificato non è valido. 400 FeatureDisabledOnSelectedEdition : l'utente ha tentato di usare una funzionalità disabilitata nell'edizione di database corrente. 404 OperationIdNotFound- L'operazione con ID non esiste. 404 ResourceNotFound: la risorsa richiesta non è stata trovata. 404 OperationIdNotFound- L'operazione con ID non esiste. 404 SourceDatabaseNotFound: il database di origine non esiste. 404 ServerNotInSubscription : il server specificato non esiste nella sottoscrizione specificata. 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati. 405 UnsupportedReplicationOperation: un'operazione di replica non supportata è stata avviata nel database. 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. 409 ManagedInstanceHasHybridLink - Utente ha tentato di avviare l'operazione non supportata quando l'istanza gestita ha un collegamento ibrido configurato. 409 RemoteDatabaseExists : il nome del database di destinazione esiste già nel server di destinazione. 409 ConflictingServerOperation: un'operazione è attualmente in corso per il server. 409 SubscriptionDisabled : la sottoscrizione è disabilitata. 409 InstanceFailoverGroupAlreadyExists - Il gruppo di failover esiste già in un determinato server. 409 InstanceFailoverGroupBusy : il gruppo di failover dell'istanza è occupato con un'altra operazione. 409 GeoReplicationCannotBecomePrimaryDuringUndo - L'utente ha tentato di eseguire il failover o di terminare un collegamento geografico mentre il secondario è in uno stato in cui potrebbe non essere fisicamente coerente e quindi non può immettere il ruolo primario. 409 InstanceFailoverGroupDnsRecordInUse : esiste un record DNS duplicato per l'endpoint richiesto. 409 ServerKeyNameAlreadyExists : la chiave del server esiste già nel server. 409 ServerKeyUriAlreadyExists - L'URI della chiave del server esiste già nel server. 409 ServerKeyDoesNotExists - La chiave server non esiste. 409 InvalidFailoverGroupName - Nome gruppo di failover dell'istanza non valido è stato fornito. 409 UpdateSloInProgress : l'utente ha tentato di avviare un'operazione incompatibile durante l'esecuzione di un aggiornamento SLO. 409 AzureKeyVaultKeyKeyNameNotFound- Impossibile completare l'operazione perché il nome della chiave di Azure Key Vault non esiste. 409 AzureKeyVaultKeyInUse: la chiave è attualmente usata dal server. 409 ConflictingSystemOperationInProgress : un'operazione di manutenzione del sistema è in corso nel database e ulteriori operazioni devono attendere il completamento. 409 InvalidOperationForDatabaseNotInReplicationRelationship : un'operazione di seeding della replica è stata eseguita in un database già in una relazione di replica. 409 InvalidDatabaseStateForOperation: l'operazione non è consentita nel database nello stato di replica corrente. 409 DuplicateGeoDrRelation: i database sono già in una relazione di replica. Si tratta di una richiesta duplicata. 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili. 429 SubscriptionTooManyRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili. 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili. 429 SubscriptionTooManyRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili. 500 OperationTimedOut: l'operazione viene timeout e viene eseguito automaticamente il rollback. Ripetere l'operazione. 503 TooManyRequests : richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 503 TooManyRequests : richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 503 AzureKeyVaultConnectionFailed - Impossibile completare l'operazione nel server perché i tentativi di connessione ad Azure Key Vault non sono riusciti 503 AzureKeyVaultGenericConnectionError - Impossibile completare l'operazione perché si è verificato un errore durante il tentativo di recuperare informazioni Key Vault . 504 RequestTimeout : la richiesta di servizio ha superato il timeout consentito.

Nome

Tipo

Descrizione

200 OK

InstanceFailoverGroup

Failover completato.

202 Accepted

Accettato

Other Status Codes

Risposte di errore:

400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPrimary: il campo primario specificato nel corpo della richiesta del gruppo di failover dell'istanza di creazione o aggiornamento è vuoto o non valido.
400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPartner: il campo partner specificato nel corpo della richiesta del gruppo di failover dell'istanza di creazione o aggiornamento è vuoto o non valido.
400 InstanceFailoverGroupCreateOrUpdateRequestDuplicatePartner: uno o più server partner forniti fanno già parte del gruppo di failover dell'istanza. Assicurarsi che il server primario e tutti i server partner specificati siano univoci.
400 InstanceFailoverGroupCreateOrUpdateRequestInvalidManagedInstanceRegion: l'area dell'istanza gestita del partner fornita nel corpo della richiesta del gruppo di failover dell'istanza è vuota o non valida.
400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount: è supportata una sola area partner.
400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPairCount: è supportata una sola coppia di istanze gestite.
400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint: il campo readWriteEndpoint è necessario per le richieste di creazione o aggiornamento.
400 InstanceFailoverGroupCreateOrUpdateRequestInvalid- Il corpo della richiesta del gruppo di failover dell'istanza di creazione o aggiornamento è vuoto o non valido.
400 InstanceFailoverGroupUpdateOrDeleteRequestOnSecondary: le modifiche al gruppo di failover dell'istanza non sono consentite in un server secondario. Eseguire la richiesta nel server primario.
400 InstanceFailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues: il valore del periodo di tolleranza per l'endpoint di lettura/scrittura deve essere non negativo.
400 InstanceFailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues- Il valore del periodo di tolleranza per il gruppo di failover dell'istanza deve essere maggiore o uguale al periodo di tolleranza minimo dei minuti '{0}'
400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields - Il failover della proprietàWithDataLossGracePeriodMinutes deve essere specificato quando viene selezionato Il criterio di failover Automatico per l'endpoint di lettura/scrittura.
400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy: il campo failoverPolicy per l'endpoint di lettura/scrittura è necessario per le richieste di creazione o aggiornamento.
400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy- Il valore del periodo di tolleranza non deve essere specificato quando viene selezionato Manuale dei criteri di failover per l'endpoint di lettura/scrittura.
400 InstanceFailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified: il corpo della richiesta del gruppo di failover dell'istanza di creazione o aggiornamento non deve modificare la proprietà di sola lettura '{0}'.
400 InstanceFailoverGroupFailoverRequestOnPrimary: la richiesta di failover deve essere avviata nel server secondario del gruppo di failover dell'istanza.
400 InstanceFailoverGroupPartnerManagedInstanceFromDifferentSubscription : il server primario e il server partner del gruppo di failover provengono da sottoscrizioni diverse. La sottoscrizione incrociata per i server del gruppo di failover non è consentita.
400 FailoverGroupRegionMismatch - Area partner specificata in Gruppo di failover deve corrispondere all'area dell'istanza gestita del partner indicata.
400 ServerEditionMismatch - Edition deve essere uguale al server primario durante la creazione di un server di replica.
400 DnsZoneMismatch: dnsZone nel server partner è diverso da DNSZone nel server di origine. Questa operazione interrompe la funzionalità InstanceFailoverGroup.
400 InvalidTargetSubregion: il server di destinazione di un database secondario non leggibile non si trova in un'area di Azure associata al ripristino di emergenza.
400 GeoDrInstanceSizeMismatch: l'istanza gestita primaria e l'istanza gestita del partner non hanno le stesse dimensioni di archiviazione.
400 SecurityAdalPrincipalCertExpiredError- Impossibile completare l'operazione perché il certificato dell'entità di Key Vault di Azure è scaduto.
400 GeoDrSecondaryInstanceNotEmpty : l'istanza gestita secondaria include database utente. Per creare un gruppo di failover di istanza, l'istanza gestita secondaria deve essere vuota.
400 InstanceFailoverGroupIncorrectNetworkingConfiguration - Configurazione di rete non corretta. Il traffico di replica del server primario non può raggiungere il server secondario.
400 IncorrectReplicationLinkState: l'operazione prevede che il database sia in uno stato previsto nel collegamento di replica.
400 SecurityInvalidAzureKeyVaultRecoveryLevel: l'URI Key Vault specificato non è valido.
400 KeyMaterialNotFoundOnRemoteServer - Il server remoto non ha accesso al materiale della chiave usato come protezione TDE.
400 AzureKeyVaultRsaKeyNotSupported: l'insieme di credenziali delle chiavi fornito usa le dimensioni o il tipo di chiave RSA non supportati. Le dimensioni della chiave RSA supportate sono 2048 o 3072 e il tipo di chiave è RSA o RSA-HSM.
400 UnableToResolveRemoteServer- Impossibile risolvere il nome del server partner remoto a causa di problemi di connettività DNS o nome server non validi.
400 SameKeyUriNotFoundOnRemoteServer - Il server secondario non dispone del materiale della chiave dello stesso insieme di credenziali delle chiavi della protezione di crittografia del server primario con rotazione automatica della chiave abilitata.
400 RemoteDatabaseCopyPermission: l'utente non dispone di autorizzazioni sufficienti per creare una copia del database nel server specificato.
400 SameKeyMaterialNotFoundOnRemoteServer - Il server secondario non dispone del materiale della chiave della protezione di crittografia del server primario.
400 CannotUseReservedDatabaseName- Impossibile utilizzare il nome del database riservato in questa operazione.
400 InvalidFailoverGroupRegion: i server specificati in un gruppo di failover dell'istanza devono risiedere in aree diverse per garantire l'isolamento.
400 InstanceFailoverGroupDoesNotExist - Il gruppo di failover non esiste in un server.
400 InstanceFailoverGroupNotSecondary: il failover non può essere avviato dal server primario in un gruppo di failover di istanza.
400 InvalidServerName - Nome server non valido specificato.
400 InvalidIdentifier: l'identificatore contiene NULL o un carattere Unicode non valido.
400 TokenTooLong: il token fornito è troppo lungo.
400 AzureKeyVaultKeyDisabled- Impossibile completare l'operazione nel server perché la chiave di Key Vault di Azure è disabilitata.
400 AzureKeyVaultInvalidExpirationDate- Impossibile completare l'operazione perché la data di scadenza della chiave di Azure Key Vault non è valida.
400 SecurityAzureKeyVaultUrlNullOrEmpty- Impossibile completare l'operazione perché l'URI di Azure Key Vault è null o vuoto.
400 InvalidSku: l'utente ha specificato uno SKU non valido.
400 InvalidAddSecondaryPermission: l'utente non dispone di autorizzazioni sufficienti per aggiungere secondario nel server specificato.
400 ServerNotFound: il server richiesto non è stato trovato.
400 AzureKeyVaultNoServerIdentity: l'identità del server non è configurata correttamente.
400 AzureKeyVaultInvalidUri: risposta non valida da Azure Key Vault. Usare un URI di Azure Key Vault valido.
400 AzureKeyVaultMissingPermissions: il server non dispone delle autorizzazioni necessarie per l'Key Vault di Azure.
400 SecurityAzureKeyVaultInvalidKeyName- Impossibile completare l'operazione a causa di un nome di chiave del server non valido.
400 PlannedFailoverTimedOutForDatabase - L'utente ha richiamato failover pianificato, si è timeout e un database specifico sembra essere colpa.
400 PlannedFailoverTimedOut : l'utente ha richiamato failover pianificato e si è timeout durante il tentativo di contattare il servizio di gestione dei partner.
400 AdalGenericError- Impossibile completare l'operazione perché è stato rilevato un errore di Azure Active Directory.
400 GeoReplicationDatabaseNotSecondary: l'operazione prevede che il database sia una destinazione di replica.
400 AdalServicePrincipalNotFound- Impossibile completare l'operazione perché è stato rilevato un errore di entità servizio della libreria di Azure Active Directory.
400 AzureKeyVaultMalformedVaultUri: l'URI Key Vault specificato non è valido.
400 FeatureDisabledOnSelectedEdition : l'utente ha tentato di usare una funzionalità disabilitata nell'edizione di database corrente.
404 OperationIdNotFound- L'operazione con ID non esiste.
404 ResourceNotFound: la risorsa richiesta non è stata trovata.
404 OperationIdNotFound- L'operazione con ID non esiste.
404 SourceDatabaseNotFound: il database di origine non esiste.
404 ServerNotInSubscription : il server specificato non esiste nella sottoscrizione specificata.
404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.
405 UnsupportedReplicationOperation: un'operazione di replica non supportata è stata avviata nel database.
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.
409 ManagedInstanceHasHybridLink - Utente ha tentato di avviare l'operazione non supportata quando l'istanza gestita ha un collegamento ibrido configurato.
409 RemoteDatabaseExists : il nome del database di destinazione esiste già nel server di destinazione.
409 ConflictingServerOperation: un'operazione è attualmente in corso per il server.
409 SubscriptionDisabled : la sottoscrizione è disabilitata.
409 InstanceFailoverGroupAlreadyExists - Il gruppo di failover esiste già in un determinato server.
409 InstanceFailoverGroupBusy : il gruppo di failover dell'istanza è occupato con un'altra operazione.
409 GeoReplicationCannotBecomePrimaryDuringUndo - L'utente ha tentato di eseguire il failover o di terminare un collegamento geografico mentre il secondario è in uno stato in cui potrebbe non essere fisicamente coerente e quindi non può immettere il ruolo primario.
409 InstanceFailoverGroupDnsRecordInUse : esiste un record DNS duplicato per l'endpoint richiesto.
409 ServerKeyNameAlreadyExists : la chiave del server esiste già nel server.
409 ServerKeyUriAlreadyExists - L'URI della chiave del server esiste già nel server.
409 ServerKeyDoesNotExists - La chiave server non esiste.
409 InvalidFailoverGroupName - Nome gruppo di failover dell'istanza non valido è stato fornito.
409 UpdateSloInProgress : l'utente ha tentato di avviare un'operazione incompatibile durante l'esecuzione di un aggiornamento SLO.
409 AzureKeyVaultKeyKeyNameNotFound- Impossibile completare l'operazione perché il nome della chiave di Azure Key Vault non esiste.
409 AzureKeyVaultKeyInUse: la chiave è attualmente usata dal server.
409 ConflictingSystemOperationInProgress : un'operazione di manutenzione del sistema è in corso nel database e ulteriori operazioni devono attendere il completamento.
409 InvalidOperationForDatabaseNotInReplicationRelationship : un'operazione di seeding della replica è stata eseguita in un database già in una relazione di replica.
409 InvalidDatabaseStateForOperation: l'operazione non è consentita nel database nello stato di replica corrente.
409 DuplicateGeoDrRelation: i database sono già in una relazione di replica. Si tratta di una richiesta duplicata.
429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili.
429 SubscriptionTooManyRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili.
429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili.
429 SubscriptionTooManyRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili.
500 OperationTimedOut: l'operazione viene timeout e viene eseguito automaticamente il rollback. Ripetere l'operazione.
503 TooManyRequests : richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.
503 TooManyRequests : richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.
503 AzureKeyVaultConnectionFailed - Impossibile completare l'operazione nel server perché i tentativi di connessione ad Azure Key Vault non sono riusciti
503 AzureKeyVaultGenericConnectionError - Impossibile completare l'operazione perché si è verificato un errore durante il tentativo di recuperare informazioni Key Vault .
504 RequestTimeout : la richiesta di servizio ha superato il timeout consentito.

Esempio

Planned failover of a failover group

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/Japan West/instanceFailoverGroups/failover-group-test-3/failover?api-version=2021-11-01


/**
 * Samples for InstanceFailoverGroups Failover.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/InstanceFailoverGroupFailover.json
     */
    /**
     * Sample code: Planned failover of a failover group.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void plannedFailoverOfAFailoverGroup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getInstanceFailoverGroups().failover("Default", "Japan West",
            "failover-group-test-3", 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

Risposta di esempio

Codice di stato:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanWest/instanceFailoverGroups/failover-group-test-3",
  "name": "failover-group-test-3",
  "type": "Microsoft.Sql/locations/instanceFailoverGroups",
  "properties": {
    "readWriteEndpoint": {
      "failoverPolicy": "Automatic",
      "failoverWithDataLossGracePeriodMinutes": 480
    },
    "readOnlyEndpoint": {
      "failoverPolicy": "Disabled"
    },
    "replicationRole": "Primary",
    "replicationState": "CATCH_UP",
    "partnerRegions": [
      {
        "location": "Japan East",
        "replicationRole": "Secondary"
      }
    ],
    "managedInstancePairs": [
      {
        "primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance",
        "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance"
      }
    ]
  }
}

Codice di stato:: 202

Definizioni

Nome	Descrizione
InstanceFailoverGroup	Un gruppo di failover dell'istanza.
InstanceFailoverGroupReadOnlyEndpoint	Endpoint di sola lettura dell'istanza del gruppo di failover.
InstanceFailoverGroupReadWriteEndpoint	Endpoint di lettura/scrittura dell'istanza del gruppo di failover.
InstanceFailoverGroupReplicationRole	Ruolo di replica locale dell'istanza del gruppo di failover.
ManagedInstancePairInfo	Coppie di istanze gestite nel gruppo di failover.
PartnerRegionInfo	Informazioni sull'area del partner per il gruppo di failover.
ReadOnlyEndpointFailoverPolicy	Criteri di failover dell'endpoint di sola lettura per il gruppo di failover.
ReadWriteEndpointFailoverPolicy	Criteri di failover dell'endpoint di lettura/scrittura per il gruppo di failover. Se failoverPolicy è Automatico, è necessario eseguire il failoverWithDataLossGracePeriodMinutes.

InstanceFailoverGroup

Un gruppo di failover dell'istanza.

Nome	Tipo	Descrizione
id	string	ID risorsa.
name	string	Nome risorsa.
properties.managedInstancePairs	ManagedInstancePairInfo[]	Elenco di coppie di istanze gestite nel gruppo di failover.
properties.partnerRegions	PartnerRegionInfo[]	Informazioni sull'area del partner per il gruppo di failover.
properties.readOnlyEndpoint	InstanceFailoverGroupReadOnlyEndpoint	Endpoint di sola lettura dell'istanza del gruppo di failover.
properties.readWriteEndpoint	InstanceFailoverGroupReadWriteEndpoint	Endpoint di lettura/scrittura dell'istanza del gruppo di failover.
properties.replicationRole	InstanceFailoverGroupReplicationRole	Ruolo di replica locale dell'istanza del gruppo di failover.
properties.replicationState	string	Stato di replica dell'istanza del gruppo di failover.
type	string	Tipo di risorsa.

InstanceFailoverGroupReadOnlyEndpoint

Endpoint di sola lettura dell'istanza del gruppo di failover.

Nome	Tipo	Descrizione
failoverPolicy	ReadOnlyEndpointFailoverPolicy	Criteri di failover dell'endpoint di sola lettura per il gruppo di failover.

InstanceFailoverGroupReadWriteEndpoint

Endpoint di lettura/scrittura dell'istanza del gruppo di failover.

Nome	Tipo	Descrizione
failoverPolicy	ReadWriteEndpointFailoverPolicy	Criteri di failover dell'endpoint di lettura/scrittura per il gruppo di failover. Se failoverPolicy è Automatico, è necessario eseguire il failoverWithDataLossGracePeriodMinutes.
failoverWithDataLossGracePeriodMinutes	integer	Periodo di tolleranza prima del tentativo di failover con perdita di dati per l'endpoint di lettura/scrittura. Se failoverPolicy è Automatico, è necessario eseguire il failoverWithDataLossGracePeriodMinutes.

InstanceFailoverGroupReplicationRole

Ruolo di replica locale dell'istanza del gruppo di failover.

Nome	Tipo	Descrizione
Primary	string
Secondary	string

ManagedInstancePairInfo

Coppie di istanze gestite nel gruppo di failover.

Nome	Tipo	Descrizione
partnerManagedInstanceId	string	ID del Istanza gestita partner in coppia.
primaryManagedInstanceId	string	ID del Istanza gestita primario in coppia.

PartnerRegionInfo

Informazioni sull'area del partner per il gruppo di failover.

Nome	Tipo	Descrizione
location	string	Posizione geografica delle istanze gestite dal partner.
replicationRole	InstanceFailoverGroupReplicationRole	Ruolo di replica delle istanze gestite dal partner.

ReadOnlyEndpointFailoverPolicy

Criteri di failover dell'endpoint di sola lettura per il gruppo di failover.

Nome	Tipo	Descrizione
Disabled	string
Enabled	string

ReadWriteEndpointFailoverPolicy

Criteri di failover dell'endpoint di lettura/scrittura per il gruppo di failover. Se failoverPolicy è Automatico, è necessario eseguire il failoverWithDataLossGracePeriodMinutes.

Nome	Tipo	Descrizione
Automatic	string
Manual	string

Condividi tramite

Instance Failover Groups - Failover

Parametri dell'URI

Risposte

Esempio

Planned failover of a failover group

Esempio di richiesta

Risposta di esempio

Definizioni

InstanceFailoverGroup

InstanceFailoverGroupReadOnlyEndpoint

InstanceFailoverGroupReadWriteEndpoint

InstanceFailoverGroupReplicationRole

ManagedInstancePairInfo

PartnerRegionInfo

ReadOnlyEndpointFailoverPolicy

ReadWriteEndpointFailoverPolicy

Risorse aggiuntive