Failover Groups - Try Planned Before Forced Failover
Bascule du serveur principal actuel vers ce serveur. Cette opération tente de planifier le basculement forcé, mais peut encore entraîner une perte de données.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/failoverGroups/{failoverGroupName}/tryPlannedBeforeForcedFailover?api-version=2025-01-01
Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
failover
|
path | True |
string |
Nom du groupe de basculement. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nom du groupe de ressources. Le nom ne respecte pas la casse. |
|
server
|
path | True |
string |
Le nom du serveur |
|
subscription
|
path | True |
string (uuid) |
ID de l’abonnement cible. La valeur doit être un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Version de l’API à utiliser pour cette opération. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
Opération Azure terminée avec succès. |
|
| 202 Accepted |
Exploitation des ressources acceptée. En-têtes
|
|
| Other Status Codes |
Réponse d’erreur inattendue. |
Sécurité
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Flux:
implicit
URL d’autorisation:
https://login.microsoftonline.com/common/oauth2/authorize
Étendues
| Nom | Description |
|---|---|
| user_impersonation | emprunter l’identité de votre compte d’utilisateur |
Exemples
Try planned before forced failover of a failover group
Exemple de requête
POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failovergroupsecondaryserver/failoverGroups/failovergrouptest3/tryPlannedBeforeForcedFailover?api-version=2025-01-01
Exemple de réponse
{
"name": "failovergrouptest3",
"type": "Microsoft.Sql/servers/failoverGroups",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failovergroupsecondaryserver/failoverGroups/failovergrouptest3",
"location": "Japan West",
"properties": {
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failovergroupsecondaryserver/databases/testdb1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failovergroupsecondaryserver/databases/testdb2"
],
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failovergroupprimaryserver",
"location": "Japan East",
"replicationRole": "Secondary"
}
],
"readOnlyEndpoint": {
"failoverPolicy": "Disabled",
"targetServer": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failovergroupprimaryserver"
},
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 120
},
"replicationRole": "Primary",
"replicationState": "CATCH_UP"
}
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/locations/japanwest/failoverGroupOperationResults/11111111-1111-1111-1111-111111111111
Définitions
| Nom | Description |
|---|---|
|
created |
Type d’identité qui a créé la ressource. |
|
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
|
Error |
Détail de l’erreur. |
|
Error |
Réponse d’erreur |
|
Failover |
Un groupe de basculement. |
|
Failover |
Type secondaire de bases de données sur le serveur partenaire. |
|
Failover |
Point de terminaison en lecture seule de l’instance de groupe de basculement. |
|
Failover |
Point de terminaison en lecture-écriture de l’instance de groupe de basculement. |
|
Failover |
Rôle de réplication local de l’instance de groupe de basculement. |
|
Partner |
Informations sur le serveur partenaire pour le groupe de basculement. |
|
Read |
Stratégie de basculement du point de terminaison en lecture seule pour le groupe de basculement. |
|
Read |
Stratégie de basculement du point de terminaison en lecture-écriture pour le groupe de basculement. Si failoverPolicy est automatique, basculementWithDataLossGracePeriodMinutes est requis. |
|
system |
Métadonnées relatives à la création et à la dernière modification de la ressource. |
createdByType
Type d’identité qui a créé la ressource.
| Valeur | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
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
Détail de l’erreur.
| Nom | Type | Description |
|---|---|---|
| additionalInfo |
Informations supplémentaires sur l’erreur. |
|
| code |
string |
Code d’erreur. |
| details |
Détails de l’erreur. |
|
| message |
string |
Message d’erreur. |
| target |
string |
Cible d’erreur. |
ErrorResponse
Réponse d’erreur
| Nom | Type | Description |
|---|---|---|
| error |
Objet d’erreur. |
FailoverGroup
Un groupe de basculement.
| Nom | Type | Description |
|---|---|---|
| id |
string (arm-id) |
ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} » |
| location |
string |
Emplacement des ressources. |
| name |
string |
Nom de la ressource |
| properties.databases |
string[] (arm-id) |
Liste des bases de données dans le groupe de basculement. |
| properties.partnerServers |
Liste des informations sur le serveur partenaire pour le groupe de basculement. |
|
| properties.readOnlyEndpoint |
Point de terminaison en lecture seule de l’instance de groupe de basculement. |
|
| properties.readWriteEndpoint |
Point de terminaison en lecture-écriture de l’instance de groupe de basculement. |
|
| properties.replicationRole |
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 |
Type secondaire de bases de données sur le serveur partenaire. |
|
| systemData |
Azure Resource Manager : métadonnées contenant des informations createdBy et modifiedBy. |
|
| tags |
object |
Balises de ressource. |
| type |
string |
Type de la ressource. Par exemple : « Microsoft. Calcul/virtualMachines » ou « Microsoft. StorageAccounts" |
FailoverGroupDatabasesSecondaryType
Type secondaire de bases de données sur le serveur partenaire.
| Valeur | Description |
|---|---|
| Geo |
Zone géographique |
| Standby |
Standby (Réserve) |
FailoverGroupReadOnlyEndpoint
Point de terminaison en lecture seule de l’instance de groupe de basculement.
| Nom | Type | Description |
|---|---|---|
| failoverPolicy |
Stratégie de basculement du point de terminaison en lecture seule pour le groupe de basculement. |
|
| targetServer |
string (arm-id) |
Serveur partenaire cible vers lequel le point de terminaison en lecture seule pointe. |
FailoverGroupReadWriteEndpoint
Point de terminaison en lecture-écriture de l’instance de groupe de basculement.
| Nom | Type | Description |
|---|---|---|
| failoverPolicy |
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. |
FailoverGroupReplicationRole
Rôle de réplication local de l’instance de groupe de basculement.
| Valeur | Description |
|---|---|
| Primary |
Primaire |
| Secondary |
Secondaire |
PartnerInfo
Informations sur le serveur partenaire pour le groupe de basculement.
| Nom | Type | Description |
|---|---|---|
| id |
string (arm-id) |
Identificateur de ressource du serveur partenaire. |
| location |
string |
Emplacement géographique du serveur partenaire. |
| replicationRole |
Rôle de réplication du serveur partenaire. |
ReadOnlyEndpointFailoverPolicy
Stratégie de basculement du point de terminaison en lecture seule pour le groupe de basculement.
| Valeur | Description |
|---|---|
| Disabled |
Désactivé |
| Enabled |
Activé |
ReadWriteEndpointFailoverPolicy
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 |
Manuel |
| Automatic |
Automatique |
systemData
Métadonnées relatives à la création et à la dernière modification de la ressource.
| Nom | Type | Description |
|---|---|---|
| createdAt |
string (date-time) |
Horodatage de la création de ressources (UTC). |
| createdBy |
string |
Identité qui a créé la ressource. |
| createdByType |
Type d’identité qui a créé la ressource. |
|
| lastModifiedAt |
string (date-time) |
Horodatage de la dernière modification de ressource (UTC) |
| lastModifiedBy |
string |
Identité qui a modifié la ressource pour la dernière fois. |
| lastModifiedByType |
Type d’identité qui a modifié la ressource pour la dernière fois. |