Instance Failover Groups - Get

Service:: SQL Database

Version d'API:: 2023-08-01

Obtient un groupe de basculement.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/instanceFailoverGroups/{failoverGroupName}?api-version=2023-08-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
failoverGroupName	path	True	string	Nom du groupe de basculement.
locationName	path	True	string	Nom de la région où se trouve la ressource.
resourceGroupName	path	True	string	Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager ou du portail.
subscriptionId	path	True	string	ID d’abonnement qui identifie un abonnement Azure.
api-version	query	True	string	Version de l’API à utiliser pour la requête.

Réponses

Nom	Type	Description
200 OK	InstanceFailoverGroup	Récupération réussie du groupe de basculement spécifié.
Other Status Codes	ErrorResponse	Réponses d’erreur : *** 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPrimary : le champ principal donné dans le corps de la demande de groupe de basculement d’instance de création ou de mise à jour est vide ou non valide. 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPartner : le champ partenaires donné dans le corps de la demande de groupe de basculement d’instance de création ou de mise à jour est vide ou non valide. 400 InstanceFailoverGroupCreateOrUpdateRequestDuplicatePartner : un ou plusieurs des serveurs partenaires fournis font déjà partie du groupe de basculement d’instance. Vérifiez que le serveur principal et tous les serveurs partenaires donnés sont uniques. 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidManagedInstanceRegion : la région d’instance gérée partenaire fournie dans le corps de la demande de groupe de basculement d’instance est vide ou non valide. 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount : une seule région partenaire est prise en charge. 400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPairCount : une seule paire d’instances managées est prise en charge. 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint : le champ readWriteEndpoint est requis pour créer ou mettre à jour des demandes. 400 InstanceFailoverGroupCreateOrUpdateRequestInvalid : le corps de la demande de groupe de basculement de création ou de mise à jour est vide ou non valide. 400 InstanceFailoverGroupUpdateOrDeleteRequestOnSecondary : les modifications apportées au groupe de basculement d’instance ne sont pas autorisées sur un serveur secondaire. Exécutez la requête sur le serveur principal. 400 InstanceFailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues - La valeur de période de grâce pour le point de terminaison en lecture-écriture doit être non négative. 400 InstanceFailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues - La valeur de la période de grâce pour le groupe de basculement d’instance doit être supérieure ou égale à la période de grâce minimale{0}' minutes 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields - La propriété failoverWithDataLossGracePeriodMinutes doit être fournie lorsque la stratégie de basculement Automatique est sélectionnée pour le point de terminaison en lecture-écriture. 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy : le champ failoverPolicy du point de terminaison en lecture-écriture est requis pour créer ou mettre à jour des demandes. 400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy - La valeur de la période de grâce ne doit pas être fournie lorsque le manuel de stratégie de basculement est sélectionné pour le point de terminaison en lecture-écriture. 400 InstanceFailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified : le corps de la demande de groupe de basculement de création ou de mise à jour d’instance ne doit pas modifier la propriété en lecture seule '{0}'. 400 InstanceFailoverGroupFailoverRequestOnPrimary : la demande de basculement doit être lancée sur le serveur secondaire du groupe de basculement d’instance. 400 InstanceFailoverGroupPartnerManagedInstanceFromDifferentSubscription - Serveur principal et serveur partenaire du groupe de basculement proviennent de différents abonnements. L’abonnement croisé pour les serveurs du groupe de basculement n’est pas autorisé. 400 InvalidAddSecondaryPermission : l’utilisateur n’a pas l’autorisation suffisante d’ajouter secondaire sur le serveur spécifié. 400 InvalidSku : l’utilisateur a spécifié une référence SKU non valide. 400 ServerNotFound : le serveur demandé est introuvable. 400 ServerEditionMismatch - Edition doit être identique au serveur principal lors de la création d’un serveur réplica. 400 FeatureDisabledOnSelectedEdition : l’utilisateur a tenté d’utiliser une fonctionnalité désactivée dans l’édition actuelle de la base de données. 400 TokenTooLong : le jeton fourni est trop long. 400 InvalidTargetSubregion : le serveur cible d’un serveur secondaire non lisible n’est pas dans une région Azure jumelée à la récupération d’urgence. 400 ManagedInstanceStoppingOrStopped : opération en conflit envoyée pendant l’arrêt/l’état arrêté de l’instance 400 ManagedInstanceStarting - Opération en conflit envoyée pendant que l’instance est à l’état de démarrage 400 IncorrectReplicationLinkState : l’opération s’attend à ce que la base de données soit dans un état attendu sur le lien de réplication. 400 CloudLifterFogInaccessibleDbRoleMismatch - Impossible de rendre la base de données {0} sur SQL Managed Instance {1} accessible, car le rôle d’instance dans le groupe de basculement est passé de {2} à {3} pendant que la base de données était dans l’état inaccessible. Restaurez le rôle de base de données d’origine en exécutant le géo-basculement et réessayez. 400 CloudLifterGeodrBlocksDbActivate - Impossible de rendre la base de données {0} sur SQL Managed Instance {1} accessible en raison d’une opération géodr en cours. Veuillez patienter jusqu’à ce que l’opération en conflit se termine et réessayez. 400 AzureKeyVaultKeyDisabled : l’opération n’a pas pu être effectuée sur le serveur, car la clé Azure Key Vault est désactivée. 400 AzureKeyVaultInvalidExpirationDate : l’opération n’a pas pu être terminée, car la date d’expiration de la clé Azure Key Vault n’est pas valide. 400 SecurityAzureKeyVaultUrlNullOrEmpty : l’opération n’a pas pu être terminée, car l’URI Azure Key Vault est null ou vide. 400 AzureKeyVaultNoServerIdentity : l’identité du serveur n’est pas correctement configurée. 400 AzureKeyVaultInvalidUri : réponse non valide d’Azure Key Vault. Utilisez un URI Azure Key Vault valide. 400 AzureKeyVaultMissingPermissions : le serveur ne dispose pas des autorisations requises sur Azure Key Vault. 400 SecurityAzureKeyVaultInvalidKeyName : l’opération n’a pas pu être terminée en raison d’un nom de clé de serveur non valide. 400 PlannedFailoverTimedOutForDatabase - L’utilisateur a appelé le basculement planifié, il a expiré et une base de données spécifique semble être à blâmer. 400 PlannedFailoverTimedOut : l’utilisateur a appelé le basculement planifié et il a expiré lors de la tentative de contact avec le service de gestion des partenaires. 400 AdalGenericError : l’opération n’a pas pu être effectuée, car une erreur Azure Active Directory a été rencontrée. 400 AdalServicePrincipalNotFound : l’opération n’a pas pu être effectuée, car une erreur de service de bibliothèque Azure Active Directory introuvable a été rencontrée. 400 AzureKeyVaultMalformedVaultUri : l’URI Key Vault fourni n’est pas valide. 400 CannotUseReservedDatabaseName - Impossible d’utiliser le nom de la base de données réservée dans cette opération. 400 InvalidFailoverGroupRegion : les serveurs spécifiés dans un groupe de basculement d’instance doivent résider dans différentes régions pour fournir une isolation. 400 InstanceFailoverGroupDoesNotExist - Le groupe de basculement n’existe pas sur un serveur. 400 InstanceFailoverGroupNotSecondary : le basculement ne peut pas être lancé à partir du serveur principal dans un groupe de basculement d’instance. 400 ManagedInstanceGeoDRNotAllowedForInstancePool - La création d’un groupe de basculement automatique (GeoDR) n’est pas prise en charge pour les instances managées approvisionnées dans les pools d’instances. Les groupes de basculement automatique peuvent être créés uniquement pour les instances managées autonomes. 400 InvalidServerName - Nom du serveur non valide spécifié. 400 ManagedInstanceEstablishingFailoverGroupGeoPrimaryWithNewerVersionEditionThanSecondary - Impossible de créer un groupe de basculement, car le format de base de données de l’instance primaire n’est pas compatible avec le format de base de données de l’instance secondaire. Pour plus d’informations, consultez https://go.microsoft.com/fwlink/?linkid=2251601. 400 ManagedInstanceFailoverInFailoverGroupInstancesWithDifferentVersionEditions : l’opération de basculement ne peut pas être effectuée en raison d’une incompatibilité de format de base de données entre les instances du groupe de basculement. Envisagez de mettre à niveau le format de base de données de l’instance principale ou de supprimer le groupe de basculement pour promouvoir l’instance secondaire actuelle vers une instance autonome. Pour plus d’informations, consultez https://go.microsoft.com/fwlink/?linkid=2251601. 400 SecurityAdalPrincipalCertExpiredError : l’opération n’a pas pu être terminée, car le certificat principal Azure Key Vault a expiré. 400 ManagedInstanceNotAllowedInGeoDRSetupWhenFreemium : le déploiement du groupe de basculement n’est pas pris en charge avec l’offre Azure SQL Managed Instance gratuite. 400 InvalidIdentifier : l’identificateur contient NULL ou un caractère Unicode non valide. 400 SecurityInvalidAzureKeyVaultRecoveryLevel : l’URI Key Vault fourni n’est pas valide. 400 ManagedInstanceGeoFailoverCannotBeExecuted - Le géo-basculement Managed Instance ne peut pas être exécuté pour l’instant. Raison : '{0}'. 400 KeyMaterialNotFoundOnRemoteServer - Le serveur distant n’a pas accès au matériel de clé utilisé comme protecteur TDE. 400 SameKeyUriNotFoundOnRemoteServer - Le serveur secondaire n’a pas le matériel de clé du même coffre de clés que le protecteur de chiffrement du serveur principal avec la rotation automatique de la clé activée. 400 AzureKeyVaultRsaKeyNotSupported : le coffre de clés fourni utilise la taille ou le type de clé RSA non pris en charge. La taille de clé RSA prise en charge est 2048 ou 3072 et le type de clé est RSA ou RSA-HSM. 400 SameKeyMaterialNotFoundOnRemoteServer - Le serveur secondaire n’a pas le matériel clé du protecteur de chiffrement du serveur principal. 400 GeoReplicationDatabaseNotSecondary : l’opération s’attend à ce que la base de données soit une cible de réplication. 400 ManagedInstanceUpdateSloOngoing : l’opération n’a pas pu être terminée, car une modification de niveau de service est en cours pour l’instance managée '{0}.' Attendez que l’opération soit terminée et réessayez. 400 FailoverGroupRegionMismatch - La région partenaire spécifiée dans le groupe de basculement doit correspondre à la région de l’instance managée partenaire indiquée. 400 DnsZoneMismatch : DNSZone sur le serveur partenaire est différent de DNSZone sur le serveur source. Cela interrompt la fonctionnalité InstanceFailoverGroup. 400 GeoDrInstanceSizeMismatch : l’instance managée principale et l’instance managée partenaire n’ont pas la même taille de stockage. 400 UnableToResolveRemoteServer : le nom du serveur partenaire distant n’a pas pu être résolu en raison d’un nom de serveur non valide ou d’un problème de connectivité DNS. 400 GeoDrSecondaryInstanceNotEmpty : l’instance managée secondaire possède des bases de données utilisateur. Pour créer un groupe de basculement d’instance, l’instance managée secondaire doit être vide. 400 RemoteDatabaseCopyPermission : l’utilisateur n’a pas l’autorisation suffisante pour créer une copie de base de données sur le serveur spécifié. 400 InstanceFailoverGroupIncorrectNetworkingConfiguration - La configuration réseau est incorrecte. Le trafic de réplication du serveur principal ne peut pas atteindre le serveur secondaire. 404 ResourceNotFound : la ressource demandée est introuvable. 404 ServerNotInSubscriptionResourceGroup : le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés. 404 ServerNotInSubscription : le serveur spécifié n’existe pas sur l’abonnement spécifié. 404 SourceDatabaseNotFound : la base de données source n’existe pas. 405 UnsupportedReplicationOperation : une opération de réplication non prise en charge a été lancée sur la base de données. 409 ConflictingServerOperation : une opération est en cours pour le serveur. 409 SubscriptionDisabled : l’abonnement est désactivé. 409 ConflictingSystemOperationInProgress : une opération de maintenance du système est en cours sur la base de données et d’autres opérations doivent attendre qu’elle soit terminée. 409 ManagedInstanceContainsInaccessibleDatabases : l’opération n’a pas pu être terminée, car l’instance managée '{0}' contient des bases de données qui sont dans l’état Inaccessible. Supprimez les bases de données inaccessibles ou corrigez les problèmes liés à l’accès à la clé de protecteur TDE gérée par le client pour l’instance managée avant l’opération de nouvelle tentative. https://go.microsoft.com/fwlink/?linkid=2111623 409 ManagedInstanceHasHybridLink : l’utilisateur a essayé de lancer l’opération qui n’est pas prise en charge lorsque l’instance managée a un lien hybride configuré. 409 GeoReplicationCannotBecomePrimaryDuringUndo : l’utilisateur a tenté de basculer ou de forcer l’arrêt d’un géo-lien alors que le serveur secondaire est dans un état où il peut ne pas être physiquement cohérent et ne peut donc pas entrer le rôle principal. 409 ServerKeyNameAlreadyExists : la clé de serveur existe déjà sur le serveur. 409 ServerKeyUriAlreadyExists : l’URI de la clé de serveur existe déjà sur le serveur. 409 ServerKeyDoesNotExists : la clé de serveur n’existe pas. 409 UpdateSloInProgress : l’utilisateur a essayé de lancer une opération incompatible pendant qu’une mise à jour SLO était en cours. 409 AzureKeyVaultKeyNameNotFound : l’opération n’a pas pu être effectuée, car le nom de clé Azure Key Vault n’existe pas. 409 AzureKeyVaultKeyInUse : la clé est actuellement utilisée par le serveur. 409 InstanceFailoverGroupAlreadyExists : le groupe de basculement existe déjà sur un serveur donné. 409 InstanceFailoverGroupBusy : le groupe de basculement d’instance est occupé avec une autre opération. 409 InstanceFailoverGroupDnsRecordInUse : un enregistrement DNS en double existe pour le point de terminaison demandé. 409 InvalidFailoverGroupName - Nom du groupe de basculement d’instance non valide a été fourni. 409 InvalidOperationForDatabaseNotInReplicationRelationship : une opération de réplication a été effectuée sur une base de données qui n’est pas dans une relation de réplication. 409 InvalidDatabaseStateForOperation : l’opération n’est pas autorisée sur la base de données dans son état de réplication actuel. 409 DuplicateGeoDrRelation : les bases de données sont déjà dans une relation de réplication. Il s’agit d’une demande en double. 409 RemoteDatabaseExists : le nom de la base de données de destination existe déjà sur le serveur de destination. 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles. 503 TooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles. 503 AzureKeyVaultConnectionFailed : l’opération n’a pas pu être effectuée sur le serveur, car les tentatives de connexion à Azure Key Vault ont échoué 503 AzureKeyVaultGenericConnectionError : l’opération n’a pas pu être effectuée, car une erreur a été rencontrée lors de la tentative de récupération des informations Key Vault. 504 RequestTimeout : la demande de service a dépassé le délai d’expiration autorisé.

Nom

Type

Description

200 OK

InstanceFailoverGroup

Récupération réussie du groupe de basculement spécifié.

Other Status Codes

ErrorResponse

Réponses d’erreur : ***

400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPrimary : le champ principal donné dans le corps de la demande de groupe de basculement d’instance de création ou de mise à jour est vide ou non valide.
400 InstanceFailoverGroupCreateOrUpdateRequestInvalidPartner : le champ partenaires donné dans le corps de la demande de groupe de basculement d’instance de création ou de mise à jour est vide ou non valide.
400 InstanceFailoverGroupCreateOrUpdateRequestDuplicatePartner : un ou plusieurs des serveurs partenaires fournis font déjà partie du groupe de basculement d’instance. Vérifiez que le serveur principal et tous les serveurs partenaires donnés sont uniques.
400 InstanceFailoverGroupCreateOrUpdateRequestInvalidManagedInstanceRegion : la région d’instance gérée partenaire fournie dans le corps de la demande de groupe de basculement d’instance est vide ou non valide.
400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPartnerCount : une seule région partenaire est prise en charge.
400 InstanceFailoverGroupCreateOrUpdateRequestUnsupportedPairCount : une seule paire d’instances managées est prise en charge.
400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpoint : le champ readWriteEndpoint est requis pour créer ou mettre à jour des demandes.
400 InstanceFailoverGroupCreateOrUpdateRequestInvalid : le corps de la demande de groupe de basculement de création ou de mise à jour est vide ou non valide.
400 InstanceFailoverGroupUpdateOrDeleteRequestOnSecondary : les modifications apportées au groupe de basculement d’instance ne sont pas autorisées sur un serveur secondaire. Exécutez la requête sur le serveur principal.
400 InstanceFailoverGroupCreateOrUpdateRequestNegativeGracePeriodValues - La valeur de période de grâce pour le point de terminaison en lecture-écriture doit être non négative.
400 InstanceFailoverGroupCreateOrUpdateRequestLessThanMinimumGracePeriodValues - La valeur de la période de grâce pour le groupe de basculement d’instance doit être supérieure ou égale à la période de grâce minimale{0}' minutes
400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFields - La propriété failoverWithDataLossGracePeriodMinutes doit être fournie lorsque la stratégie de basculement Automatique est sélectionnée pour le point de terminaison en lecture-écriture.
400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteFailoverPolicy : le champ failoverPolicy du point de terminaison en lecture-écriture est requis pour créer ou mettre à jour des demandes.
400 InstanceFailoverGroupCreateOrUpdateRequestInvalidReadWriteEndpointFieldsForManualPolicy - La valeur de la période de grâce ne doit pas être fournie lorsque le manuel de stratégie de basculement est sélectionné pour le point de terminaison en lecture-écriture.
400 InstanceFailoverGroupCreateOrUpdateRequestReadOnlyPropertyModified : le corps de la demande de groupe de basculement de création ou de mise à jour d’instance ne doit pas modifier la propriété en lecture seule '{0}'.
400 InstanceFailoverGroupFailoverRequestOnPrimary : la demande de basculement doit être lancée sur le serveur secondaire du groupe de basculement d’instance.
400 InstanceFailoverGroupPartnerManagedInstanceFromDifferentSubscription - Serveur principal et serveur partenaire du groupe de basculement proviennent de différents abonnements. L’abonnement croisé pour les serveurs du groupe de basculement n’est pas autorisé.
400 InvalidAddSecondaryPermission : l’utilisateur n’a pas l’autorisation suffisante d’ajouter secondaire sur le serveur spécifié.
400 InvalidSku : l’utilisateur a spécifié une référence SKU non valide.
400 ServerNotFound : le serveur demandé est introuvable.
400 ServerEditionMismatch - Edition doit être identique au serveur principal lors de la création d’un serveur réplica.
400 FeatureDisabledOnSelectedEdition : l’utilisateur a tenté d’utiliser une fonctionnalité désactivée dans l’édition actuelle de la base de données.
400 TokenTooLong : le jeton fourni est trop long.
400 InvalidTargetSubregion : le serveur cible d’un serveur secondaire non lisible n’est pas dans une région Azure jumelée à la récupération d’urgence.
400 ManagedInstanceStoppingOrStopped : opération en conflit envoyée pendant l’arrêt/l’état arrêté de l’instance
400 ManagedInstanceStarting - Opération en conflit envoyée pendant que l’instance est à l’état de démarrage
400 IncorrectReplicationLinkState : l’opération s’attend à ce que la base de données soit dans un état attendu sur le lien de réplication.
400 CloudLifterFogInaccessibleDbRoleMismatch - Impossible de rendre la base de données {0} sur SQL Managed Instance {1} accessible, car le rôle d’instance dans le groupe de basculement est passé de {2} à {3} pendant que la base de données était dans l’état inaccessible. Restaurez le rôle de base de données d’origine en exécutant le géo-basculement et réessayez.
400 CloudLifterGeodrBlocksDbActivate - Impossible de rendre la base de données {0} sur SQL Managed Instance {1} accessible en raison d’une opération géodr en cours. Veuillez patienter jusqu’à ce que l’opération en conflit se termine et réessayez.
400 AzureKeyVaultKeyDisabled : l’opération n’a pas pu être effectuée sur le serveur, car la clé Azure Key Vault est désactivée.
400 AzureKeyVaultInvalidExpirationDate : l’opération n’a pas pu être terminée, car la date d’expiration de la clé Azure Key Vault n’est pas valide.
400 SecurityAzureKeyVaultUrlNullOrEmpty : l’opération n’a pas pu être terminée, car l’URI Azure Key Vault est null ou vide.
400 AzureKeyVaultNoServerIdentity : l’identité du serveur n’est pas correctement configurée.
400 AzureKeyVaultInvalidUri : réponse non valide d’Azure Key Vault. Utilisez un URI Azure Key Vault valide.
400 AzureKeyVaultMissingPermissions : le serveur ne dispose pas des autorisations requises sur Azure Key Vault.
400 SecurityAzureKeyVaultInvalidKeyName : l’opération n’a pas pu être terminée en raison d’un nom de clé de serveur non valide.
400 PlannedFailoverTimedOutForDatabase - L’utilisateur a appelé le basculement planifié, il a expiré et une base de données spécifique semble être à blâmer.
400 PlannedFailoverTimedOut : l’utilisateur a appelé le basculement planifié et il a expiré lors de la tentative de contact avec le service de gestion des partenaires.
400 AdalGenericError : l’opération n’a pas pu être effectuée, car une erreur Azure Active Directory a été rencontrée.
400 AdalServicePrincipalNotFound : l’opération n’a pas pu être effectuée, car une erreur de service de bibliothèque Azure Active Directory introuvable a été rencontrée.
400 AzureKeyVaultMalformedVaultUri : l’URI Key Vault fourni n’est pas valide.
400 CannotUseReservedDatabaseName - Impossible d’utiliser le nom de la base de données réservée dans cette opération.
400 InvalidFailoverGroupRegion : les serveurs spécifiés dans un groupe de basculement d’instance doivent résider dans différentes régions pour fournir une isolation.
400 InstanceFailoverGroupDoesNotExist - Le groupe de basculement n’existe pas sur un serveur.
400 InstanceFailoverGroupNotSecondary : le basculement ne peut pas être lancé à partir du serveur principal dans un groupe de basculement d’instance.
400 ManagedInstanceGeoDRNotAllowedForInstancePool - La création d’un groupe de basculement automatique (GeoDR) n’est pas prise en charge pour les instances managées approvisionnées dans les pools d’instances. Les groupes de basculement automatique peuvent être créés uniquement pour les instances managées autonomes.
400 InvalidServerName - Nom du serveur non valide spécifié.
400 ManagedInstanceEstablishingFailoverGroupGeoPrimaryWithNewerVersionEditionThanSecondary - Impossible de créer un groupe de basculement, car le format de base de données de l’instance primaire n’est pas compatible avec le format de base de données de l’instance secondaire. Pour plus d’informations, consultez https://go.microsoft.com/fwlink/?linkid=2251601.
400 ManagedInstanceFailoverInFailoverGroupInstancesWithDifferentVersionEditions : l’opération de basculement ne peut pas être effectuée en raison d’une incompatibilité de format de base de données entre les instances du groupe de basculement. Envisagez de mettre à niveau le format de base de données de l’instance principale ou de supprimer le groupe de basculement pour promouvoir l’instance secondaire actuelle vers une instance autonome. Pour plus d’informations, consultez https://go.microsoft.com/fwlink/?linkid=2251601.
400 SecurityAdalPrincipalCertExpiredError : l’opération n’a pas pu être terminée, car le certificat principal Azure Key Vault a expiré.
400 ManagedInstanceNotAllowedInGeoDRSetupWhenFreemium : le déploiement du groupe de basculement n’est pas pris en charge avec l’offre Azure SQL Managed Instance gratuite.
400 InvalidIdentifier : l’identificateur contient NULL ou un caractère Unicode non valide.
400 SecurityInvalidAzureKeyVaultRecoveryLevel : l’URI Key Vault fourni n’est pas valide.
400 ManagedInstanceGeoFailoverCannotBeExecuted - Le géo-basculement Managed Instance ne peut pas être exécuté pour l’instant. Raison : '{0}'.
400 KeyMaterialNotFoundOnRemoteServer - Le serveur distant n’a pas accès au matériel de clé utilisé comme protecteur TDE.
400 SameKeyUriNotFoundOnRemoteServer - Le serveur secondaire n’a pas le matériel de clé du même coffre de clés que le protecteur de chiffrement du serveur principal avec la rotation automatique de la clé activée.
400 AzureKeyVaultRsaKeyNotSupported : le coffre de clés fourni utilise la taille ou le type de clé RSA non pris en charge. La taille de clé RSA prise en charge est 2048 ou 3072 et le type de clé est RSA ou RSA-HSM.
400 SameKeyMaterialNotFoundOnRemoteServer - Le serveur secondaire n’a pas le matériel clé du protecteur de chiffrement du serveur principal.
400 GeoReplicationDatabaseNotSecondary : l’opération s’attend à ce que la base de données soit une cible de réplication.
400 ManagedInstanceUpdateSloOngoing : l’opération n’a pas pu être terminée, car une modification de niveau de service est en cours pour l’instance managée '{0}.' Attendez que l’opération soit terminée et réessayez.
400 FailoverGroupRegionMismatch - La région partenaire spécifiée dans le groupe de basculement doit correspondre à la région de l’instance managée partenaire indiquée.
400 DnsZoneMismatch : DNSZone sur le serveur partenaire est différent de DNSZone sur le serveur source. Cela interrompt la fonctionnalité InstanceFailoverGroup.
400 GeoDrInstanceSizeMismatch : l’instance managée principale et l’instance managée partenaire n’ont pas la même taille de stockage.
400 UnableToResolveRemoteServer : le nom du serveur partenaire distant n’a pas pu être résolu en raison d’un nom de serveur non valide ou d’un problème de connectivité DNS.
400 GeoDrSecondaryInstanceNotEmpty : l’instance managée secondaire possède des bases de données utilisateur. Pour créer un groupe de basculement d’instance, l’instance managée secondaire doit être vide.
400 RemoteDatabaseCopyPermission : l’utilisateur n’a pas l’autorisation suffisante pour créer une copie de base de données sur le serveur spécifié.
400 InstanceFailoverGroupIncorrectNetworkingConfiguration - La configuration réseau est incorrecte. Le trafic de réplication du serveur principal ne peut pas atteindre le serveur secondaire.
404 ResourceNotFound : la ressource demandée est introuvable.
404 ServerNotInSubscriptionResourceGroup : le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés.
404 ServerNotInSubscription : le serveur spécifié n’existe pas sur l’abonnement spécifié.
404 SourceDatabaseNotFound : la base de données source n’existe pas.
405 UnsupportedReplicationOperation : une opération de réplication non prise en charge a été lancée sur la base de données.
409 ConflictingServerOperation : une opération est en cours pour le serveur.
409 SubscriptionDisabled : l’abonnement est désactivé.
409 ConflictingSystemOperationInProgress : une opération de maintenance du système est en cours sur la base de données et d’autres opérations doivent attendre qu’elle soit terminée.
409 ManagedInstanceContainsInaccessibleDatabases : l’opération n’a pas pu être terminée, car l’instance managée '{0}' contient des bases de données qui sont dans l’état Inaccessible. Supprimez les bases de données inaccessibles ou corrigez les problèmes liés à l’accès à la clé de protecteur TDE gérée par le client pour l’instance managée avant l’opération de nouvelle tentative. https://go.microsoft.com/fwlink/?linkid=2111623
409 ManagedInstanceHasHybridLink : l’utilisateur a essayé de lancer l’opération qui n’est pas prise en charge lorsque l’instance managée a un lien hybride configuré.
409 GeoReplicationCannotBecomePrimaryDuringUndo : l’utilisateur a tenté de basculer ou de forcer l’arrêt d’un géo-lien alors que le serveur secondaire est dans un état où il peut ne pas être physiquement cohérent et ne peut donc pas entrer le rôle principal.
409 ServerKeyNameAlreadyExists : la clé de serveur existe déjà sur le serveur.
409 ServerKeyUriAlreadyExists : l’URI de la clé de serveur existe déjà sur le serveur.
409 ServerKeyDoesNotExists : la clé de serveur n’existe pas.
409 UpdateSloInProgress : l’utilisateur a essayé de lancer une opération incompatible pendant qu’une mise à jour SLO était en cours.
409 AzureKeyVaultKeyNameNotFound : l’opération n’a pas pu être effectuée, car le nom de clé Azure Key Vault n’existe pas.
409 AzureKeyVaultKeyInUse : la clé est actuellement utilisée par le serveur.
409 InstanceFailoverGroupAlreadyExists : le groupe de basculement existe déjà sur un serveur donné.
409 InstanceFailoverGroupBusy : le groupe de basculement d’instance est occupé avec une autre opération.
409 InstanceFailoverGroupDnsRecordInUse : un enregistrement DNS en double existe pour le point de terminaison demandé.
409 InvalidFailoverGroupName - Nom du groupe de basculement d’instance non valide a été fourni.
409 InvalidOperationForDatabaseNotInReplicationRelationship : une opération de réplication a été effectuée sur une base de données qui n’est pas dans une relation de réplication.
409 InvalidDatabaseStateForOperation : l’opération n’est pas autorisée sur la base de données dans son état de réplication actuel.
409 DuplicateGeoDrRelation : les bases de données sont déjà dans une relation de réplication. Il s’agit d’une demande en double.
409 RemoteDatabaseExists : le nom de la base de données de destination existe déjà sur le serveur de destination.
429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.
429 SubscriptionTooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.
503 TooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.
503 AzureKeyVaultConnectionFailed : l’opération n’a pas pu être effectuée sur le serveur, car les tentatives de connexion à Azure Key Vault ont échoué
503 AzureKeyVaultGenericConnectionError : l’opération n’a pas pu être effectuée, car une erreur a été rencontrée lors de la tentative de récupération des informations Key Vault.
504 RequestTimeout : la demande de service a dépassé le délai d’expiration autorisé.

Exemples

Get failover group

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/Japan East/instanceFailoverGroups/failover-group-test?api-version=2023-08-01

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/InstanceFailoverGroupGet.json
// this example is just showing the usage of "InstanceFailoverGroups_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this InstanceFailoverGroupResource created on azure
// for more information of creating InstanceFailoverGroupResource, please refer to the document of InstanceFailoverGroupResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "Default";
AzureLocation locationName = new AzureLocation("Japan East");
string failoverGroupName = "failover-group-test";
ResourceIdentifier instanceFailoverGroupResourceId = InstanceFailoverGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, locationName, failoverGroupName);
InstanceFailoverGroupResource instanceFailoverGroup = client.GetInstanceFailoverGroupResource(instanceFailoverGroupResourceId);

// invoke the operation
InstanceFailoverGroupResource result = await instanceFailoverGroup.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
InstanceFailoverGroupData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Exemple de réponse

Code d’état:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/JapanEast/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 West",
        "replicationRole": "Secondary"
      }
    ],
    "managedInstancePairs": [
      {
        "primaryManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-primary-mngdInstance",
        "partnerManagedInstanceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/failover-group-secondary-mngdInstance"
      }
    ],
    "secondaryType": "Geo"
  }
}

Définitions

Nom	Description
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
InstanceFailoverGroup	Un groupe de basculement d’instance.
InstanceFailoverGroupReadOnlyEndpoint	Point de terminaison en lecture seule de l’instance de groupe de basculement.
InstanceFailoverGroupReadWriteEndpoint	Point de terminaison en lecture-écriture de l’instance de groupe de basculement.
InstanceFailoverGroupReplicationRole	Rôle de réplication local de l’instance de groupe de basculement.
ManagedInstancePairInfo	Paires d’instances managées dans le groupe de basculement.
PartnerRegionInfo	Informations de région partenaire pour le groupe de basculement.
ReadOnlyEndpointFailoverPolicy	Stratégie de basculement du point de terminaison en lecture seule pour le groupe de basculement.
ReadWriteEndpointFailoverPolicy	Stratégie de basculement du point de terminaison en lecture-écriture pour le groupe de basculement. Si failoverPolicy est automatique, basculementWithDataLossGracePeriodMinutes est requis.
SecondaryInstanceType	Type de l’instance géo-secondaire. Définissez « Veille » si l’instance est utilisée en tant qu’option de récupération d’urgence uniquement.

ErrorAdditionalInfo

Object

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Object

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Object

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

InstanceFailoverGroup

Object

Un groupe de basculement d’instance.

Nom	Type	Description
id	string	ID de ressource.
name	string	Nom de la ressource.
properties.managedInstancePairs	ManagedInstancePairInfo[]	Liste des paires d’instances managées dans le groupe de basculement.
properties.partnerRegions	PartnerRegionInfo[]	Informations de région partenaire pour le groupe de basculement.
properties.readOnlyEndpoint	InstanceFailoverGroupReadOnlyEndpoint	Point de terminaison en lecture seule de l’instance de groupe de basculement.
properties.readWriteEndpoint	InstanceFailoverGroupReadWriteEndpoint	Point de terminaison en lecture-écriture de l’instance de groupe de basculement.
properties.replicationRole	InstanceFailoverGroupReplicationRole	Rôle de réplication local de l’instance de groupe de basculement.
properties.replicationState	string	État de réplication de l’instance de groupe de basculement.
properties.secondaryType	SecondaryInstanceType	Type de l’instance géo-secondaire. Définissez « Veille » si l’instance est utilisée en tant qu’option de récupération d’urgence uniquement.
type	string	Type de ressource.

InstanceFailoverGroupReadOnlyEndpoint

Object

Point de terminaison en lecture seule de l’instance de groupe de basculement.

Nom	Type	Description
failoverPolicy	ReadOnlyEndpointFailoverPolicy	Stratégie de basculement du point de terminaison en lecture seule pour le groupe de basculement.

InstanceFailoverGroupReadWriteEndpoint

Object

Point de terminaison en lecture-écriture de l’instance de groupe de basculement.

Nom	Type	Description
failoverPolicy	ReadWriteEndpointFailoverPolicy	Stratégie de basculement du point de terminaison en lecture-écriture pour le groupe de basculement. Si failoverPolicy est automatique, basculementWithDataLossGracePeriodMinutes est requis.
failoverWithDataLossGracePeriodMinutes	integer (int32)	La période de grâce avant le basculement avec perte de données est tentée pour le point de terminaison en lecture-écriture. Si failoverPolicy est automatique, basculementWithDataLossGracePeriodMinutes est requis.

InstanceFailoverGroupReplicationRole

Énumération

Rôle de réplication local de l’instance de groupe de basculement.

Valeur	Description
Primary
Secondary

ManagedInstancePairInfo

Object

Paires d’instances managées dans le groupe de basculement.

Nom	Type	Description
partnerManagedInstanceId	string	ID de Partner Managed Instance en paire.
primaryManagedInstanceId	string	ID de l’instance managée principale en paire.

PartnerRegionInfo

Object

Informations de région partenaire pour le groupe de basculement.

Nom	Type	Description
location	string	Emplacement géographique des instances gérées par le partenaire.
replicationRole	InstanceFailoverGroupReplicationRole	Rôle de réplication des instances gérées par le partenaire.

ReadOnlyEndpointFailoverPolicy

Énumération

Stratégie de basculement du point de terminaison en lecture seule pour le groupe de basculement.

Valeur	Description
Disabled
Enabled

ReadWriteEndpointFailoverPolicy

Énumération

Stratégie de basculement du point de terminaison en lecture-écriture pour le groupe de basculement. Si failoverPolicy est automatique, basculementWithDataLossGracePeriodMinutes est requis.

Valeur	Description
Manual
Automatic

SecondaryInstanceType

Énumération

Type de l’instance géo-secondaire. Définissez « Veille » si l’instance est utilisée en tant qu’option de récupération d’urgence uniquement.

Valeur	Description
Geo
Standby

Partager via

Instance Failover Groups - Get

Paramètres URI

Réponses

Exemples

Get failover group

Exemple de requête

Exemple de réponse

Définitions

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

InstanceFailoverGroup

InstanceFailoverGroupReadOnlyEndpoint

InstanceFailoverGroupReadWriteEndpoint

InstanceFailoverGroupReplicationRole

ManagedInstancePairInfo

PartnerRegionInfo

ReadOnlyEndpointFailoverPolicy

ReadWriteEndpointFailoverPolicy

SecondaryInstanceType