Failover Groups - Create Or Update
Crée ou met à jour un groupe de basculement.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/failoverGroups/{failoverGroupName}?api-version=2021-11-01
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
failover
|
path | True |
string |
Nom du groupe de basculement. |
resource
|
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. |
server
|
path | True |
string |
Nom du serveur contenant le groupe de basculement. |
subscription
|
path | True |
string |
L’ID d’abonnement d’un abonnement Azure. |
api-version
|
query | True |
string |
Version de l’API à utiliser pour la requête. |
Corps de la demande
Nom | Obligatoire | Type | Description |
---|---|---|---|
properties.partnerServers | True |
Liste des informations sur le serveur partenaire pour le groupe de basculement. |
|
properties.readWriteEndpoint | True |
Point de terminaison en lecture-écriture du groupe de basculement instance. |
|
properties.databases |
string[] |
Liste des bases de données dans le groupe de basculement. |
|
properties.readOnlyEndpoint |
Point de terminaison en lecture seule du groupe de basculement instance. |
||
tags |
object |
Balises de ressource. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Mise à jour réussie du groupe de basculement. |
|
201 Created |
Le groupe de basculement a été créé. |
|
202 Accepted |
Accepté |
|
Other Status Codes |
Réponses d’erreur : ***
|
Exemples
Create failover group
Exemple de requête
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3?api-version=2021-11-01
{
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled"
},
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server"
}
],
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
]
}
}
Exemple de réponse
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3",
"name": "failover-group-test-3",
"type": "Microsoft.Sql/servers/failoverGroups",
"location": "Japan East",
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled"
},
"replicationRole": "Primary",
"replicationState": "CATCH_UP",
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server",
"location": "Japan West",
"replicationRole": "Secondary"
}
],
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
]
}
}
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/failoverGroups/failover-group-test-3",
"name": "failover-group-test-3",
"type": "Microsoft.Sql/servers/failoverGroups",
"location": "Japan East",
"properties": {
"readWriteEndpoint": {
"failoverPolicy": "Automatic",
"failoverWithDataLossGracePeriodMinutes": 480
},
"readOnlyEndpoint": {
"failoverPolicy": "Disabled"
},
"replicationRole": "Primary",
"replicationState": "CATCH_UP",
"partnerServers": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-secondary-server",
"location": "Japan West",
"replicationRole": "Secondary"
}
],
"databases": [
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-1",
"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/failover-group-primary-server/databases/testdb-2"
]
}
}
Définitions
Nom | Description |
---|---|
Failover |
Un groupe de basculement. |
Failover |
Point de terminaison en lecture seule du groupe de basculement instance. |
Failover |
Point de terminaison en lecture-écriture du groupe de basculement instance. |
Failover |
Rôle de réplication locale du groupe de basculement instance. |
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 a la valeur Automatic, failoverWithDataLossGracePeriodMinutes est requis. |
FailoverGroup
Un groupe de basculement.
Nom | Type | Description |
---|---|---|
id |
string |
ID de la ressource |
location |
string |
Emplacement de la ressource. |
name |
string |
Nom de la ressource. |
properties.databases |
string[] |
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 du groupe de basculement instance. |
|
properties.readWriteEndpoint |
Point de terminaison en lecture-écriture du groupe de basculement instance. |
|
properties.replicationRole |
Rôle de réplication locale du groupe de basculement instance. |
|
properties.replicationState |
string |
État de réplication du groupe de basculement instance. |
tags |
object |
Balises de ressource. |
type |
string |
Type de ressource. |
FailoverGroupReadOnlyEndpoint
Point de terminaison en lecture seule du groupe de basculement instance.
Nom | Type | Description |
---|---|---|
failoverPolicy |
Stratégie de basculement du point de terminaison en lecture seule pour le groupe de basculement. |
FailoverGroupReadWriteEndpoint
Point de terminaison en lecture-écriture du groupe de basculement instance.
Nom | Type | Description |
---|---|---|
failoverPolicy |
Stratégie de basculement du point de terminaison en lecture-écriture pour le groupe de basculement. Si failoverPolicy a la valeur Automatic, failoverWithDataLossGracePeriodMinutes est requis. |
|
failoverWithDataLossGracePeriodMinutes |
integer |
Période de grâce avant la tentative de basculement avec perte de données pour le point de terminaison en lecture-écriture. Si failoverPolicy a la valeur Automatic, failoverWithDataLossGracePeriodMinutes est requis. |
FailoverGroupReplicationRole
Rôle de réplication locale du groupe de basculement instance.
Nom | Type | Description |
---|---|---|
Primary |
string |
|
Secondary |
string |
PartnerInfo
Informations sur le serveur partenaire pour le groupe de basculement.
Nom | Type | Description |
---|---|---|
id |
string |
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.
Nom | Type | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
ReadWriteEndpointFailoverPolicy
Stratégie de basculement du point de terminaison en lecture-écriture pour le groupe de basculement. Si failoverPolicy a la valeur Automatic, failoverWithDataLossGracePeriodMinutes est requis.
Nom | Type | Description |
---|---|---|
Automatic |
string |
|
Manual |
string |