Distributed Availability Groups - Create Or Update
Crée un groupe de disponibilité distribué entre Sql On-Premises et Sql Managed Instance.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/distributedAvailabilityGroups/{distributedAvailabilityGroupName}?api-version=2025-01-01
Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
distributed
|
path | True |
string |
Nom du groupe de disponibilité distribué. |
|
managed
|
path | True |
string |
Nom de l’instance managée. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nom du groupe de ressources. Le nom ne respecte pas la casse. |
|
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. |
Corps de la demande
| Nom | Type | Description |
|---|---|---|
| properties.databases |
Bases de données dans le groupe de disponibilité distribué |
|
| properties.failoverMode |
Le mode basculement liant peut être manuel s’il est destiné à être utilisé pour le basculement bidirectionnel avec un SQL Server supporté, ou aucun pour le basculement unidirectionnel vers Azure. |
|
| properties.instanceAvailabilityGroupName |
string |
Nom du groupe de disponibilité côté instance managée |
| properties.instanceLinkRole |
Rôle de lien côté instance managée |
|
| properties.partnerAvailabilityGroupName |
string |
Nom du groupe de disponibilité côté serveur SQL |
| properties.partnerEndpoint |
string |
Point de terminaison côté serveur SQL - NOM IP ou DNS résolvable |
| properties.replicationMode |
Mode de réplication du lien |
|
| properties.seedingMode |
Mode d’amorçage de base de données : peut être automatique (par défaut) ou Manuel pour les scénarios pris en charge. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
Opération de mise à jour de la ressource 'DistributedAvailabilityGroup' réussie |
|
| 201 Created |
Ressource 'DistributedAvailabilityGroup' créer l’opération a réussi En-têtes
|
|
| 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
| Create a distributed availability group with all properties. |
| Create a distributed availability group with minimal properties. |
Create a distributed availability group with all properties.
Exemple de requête
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups/dag?api-version=2025-01-01
{
"properties": {
"databases": [
{
"databaseName": "testdb"
}
],
"failoverMode": "None",
"instanceAvailabilityGroupName": "testcl",
"instanceLinkRole": "Primary",
"partnerAvailabilityGroupName": "BoxLocalAg1",
"partnerEndpoint": "TCP://SERVER:7022",
"seedingMode": "Automatic"
}
}
Exemple de réponse
{
"name": "dag",
"type": "Microsoft.Sql/managedInstances/distributedAvailabilityGroups",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups/dag",
"properties": {
"databases": [
{
"databaseName": "testdb"
}
],
"distributedAvailabilityGroupName": "dag",
"failoverMode": "None",
"instanceAvailabilityGroupName": "testcl",
"instanceLinkRole": "Primary",
"partnerAvailabilityGroupName": "BoxLocalAg1",
"partnerEndpoint": "TCP://SERVER:7022",
"seedingMode": "Automatic"
}
}
{
"name": "dag",
"type": "Microsoft.Sql/managedInstances/distributedAvailabilityGroups",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups/dag",
"properties": {
"databases": [
{
"databaseName": "testdb"
}
],
"distributedAvailabilityGroupName": "dag",
"failoverMode": "None",
"instanceAvailabilityGroupName": "testcl",
"instanceLinkRole": "Primary",
"partnerAvailabilityGroupName": "BoxLocalAg1",
"partnerEndpoint": "TCP://SERVER:7022",
"seedingMode": "Automatic"
}
}
Create a distributed availability group with minimal properties.
Exemple de requête
PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups/dag?api-version=2025-01-01
{
"properties": {
"databases": [
{
"databaseName": "testdb"
}
],
"instanceAvailabilityGroupName": "testcl",
"partnerAvailabilityGroupName": "BoxLocalAg1",
"partnerEndpoint": "TCP://SERVER:7022"
}
}
Exemple de réponse
{
"name": "dag",
"type": "Microsoft.Sql/managedInstances/distributedAvailabilityGroups",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups/dag",
"properties": {
"databases": [
{
"databaseName": "testdb"
}
],
"distributedAvailabilityGroupName": "dag",
"failoverMode": "None",
"instanceAvailabilityGroupName": "testcl",
"instanceLinkRole": "Secondary",
"partnerAvailabilityGroupName": "BoxLocalAg1",
"partnerEndpoint": "TCP://SERVER:7022",
"seedingMode": "Automatic"
}
}
{
"name": "dag",
"type": "Microsoft.Sql/managedInstances/distributedAvailabilityGroups",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl/distributedAvailabilityGroups/dag",
"properties": {
"databases": [
{
"databaseName": "testdb"
}
],
"distributedAvailabilityGroupName": "dag",
"failoverMode": "None",
"instanceAvailabilityGroupName": "testcl",
"instanceLinkRole": "Secondary",
"partnerAvailabilityGroupName": "BoxLocalAg1",
"partnerEndpoint": "TCP://SERVER:7022",
"seedingMode": "Automatic"
}
}
Définitions
| Nom | Description |
|---|---|
|
Certificate |
Informations sur le certificat |
|
created |
Type d’identité qui a créé la ressource. |
|
Distributed |
Groupe de disponibilité distribué entre la boîte et l’instance Sql Managed Instance. |
|
Distributed |
Informations spécifiques à la base de données |
|
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
|
Error |
Détail de l’erreur. |
|
Error |
Réponse d’erreur |
|
Failover |
Le mode basculement liant peut être manuel s’il est destiné à être utilisé pour le basculement bidirectionnel avec un SQL Server supporté, ou aucun pour le basculement unidirectionnel vers Azure. |
|
Link |
Rôle de lien côté serveur SQL |
|
Replica |
Lier l’état connecté |
|
Replica |
État d’intégrité du lien |
|
Replication |
Mode de réplication du lien |
|
Seeding |
Mode d’amorçage de base de données : peut être automatique (par défaut) ou Manuel pour les scénarios pris en charge. |
|
system |
Métadonnées relatives à la création et à la dernière modification de la ressource. |
CertificateInfo
Informations sur le certificat
| Nom | Type | Description |
|---|---|---|
| certificateName |
string |
Nom du certificat |
| expiryDate |
string (date-time) |
Date d’expiration du certificat |
createdByType
Type d’identité qui a créé la ressource.
| Valeur | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DistributedAvailabilityGroup
Groupe de disponibilité distribué entre la boîte et l’instance Sql Managed Instance.
| Nom | Type | Description |
|---|---|---|
| id |
string (arm-id) |
ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} » |
| name |
string |
Nom de la ressource |
| properties.databases |
Bases de données dans le groupe de disponibilité distribué |
|
| properties.distributedAvailabilityGroupId |
string (uuid) |
ID du groupe de disponibilité distribué |
| properties.distributedAvailabilityGroupName |
string |
Nom du groupe de disponibilité distribué |
| properties.failoverMode |
Le mode basculement liant peut être manuel s’il est destiné à être utilisé pour le basculement bidirectionnel avec un SQL Server supporté, ou aucun pour le basculement unidirectionnel vers Azure. |
|
| properties.instanceAvailabilityGroupName |
string |
Nom du groupe de disponibilité côté instance managée |
| properties.instanceLinkRole |
Rôle de lien côté instance managée |
|
| properties.partnerAvailabilityGroupName |
string |
Nom du groupe de disponibilité côté serveur SQL |
| properties.partnerEndpoint |
string |
Point de terminaison côté serveur SQL - NOM IP ou DNS résolvable |
| properties.partnerLinkRole |
Rôle de lien côté serveur SQL |
|
| properties.replicationMode |
Mode de réplication du lien |
|
| properties.seedingMode |
Mode d’amorçage de base de données : peut être automatique (par défaut) ou Manuel pour les scénarios pris en charge. |
|
| systemData |
Azure Resource Manager : métadonnées contenant des informations createdBy et modifiedBy. |
|
| type |
string |
Type de la ressource. Par exemple : « Microsoft. Calcul/virtualMachines » ou « Microsoft. StorageAccounts" |
DistributedAvailabilityGroupDatabase
Informations spécifiques à la base de données
| Nom | Type | Description |
|---|---|---|
| connectedState |
Lier l’état connecté |
|
| databaseName |
string |
Nom de la base de données dans le lien |
| instanceRedoReplicationLagSeconds |
integer (int32) |
Délai de reprise lorsque le côté lien Managed Instance est principal |
| instanceReplicaId |
string (uuid) |
ID de réplica d’instance managée |
| instanceSendReplicationLagSeconds |
integer (int32) |
Latence de réplication lorsque le côté lien Managed Instance est principal |
| lastBackupLsn |
string |
Dernière sauvegarde LSN |
| lastBackupTime |
string (date-time) |
Heure de la dernière sauvegarde LSN |
| lastCommitLsn |
string |
Dernière validation LSN |
| lastCommitTime |
string (date-time) |
Heure de la dernière validation LSN |
| lastHardenedLsn |
string |
Dernier LSN renforcé |
| lastHardenedTime |
string (date-time) |
Dernière heure LSN renforcée |
| lastReceivedLsn |
string |
Dernier LSN reçu |
| lastReceivedTime |
string (date-time) |
Dernière heure LSN reçue |
| lastSentLsn |
string |
Dernier LSN envoyé |
| lastSentTime |
string (date-time) |
Dernière heure LSN envoyée |
| mostRecentLinkError |
string |
Description de l’erreur de connexion de lien la plus récente |
| partnerAuthCertValidity |
Validité du certificat SQL Server |
|
| partnerReplicaId |
string (uuid) |
ID de réplica SQL Server |
| replicaState |
string |
État actuel du lien |
| seedingProgress |
string |
Progression de l’amorçage |
| synchronizationHealth |
État d’intégrité du lien |
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. |
FailoverModeType
Le mode basculement liant peut être manuel s’il est destiné à être utilisé pour le basculement bidirectionnel avec un SQL Server supporté, ou aucun pour le basculement unidirectionnel vers Azure.
| Valeur | Description |
|---|---|
| None |
Aucun |
| Manual |
Manuel |
LinkRole
Rôle de lien côté serveur SQL
| Valeur | Description |
|---|---|
| Primary |
Primaire |
| Secondary |
Secondaire |
ReplicaConnectedState
Lier l’état connecté
| Valeur | Description |
|---|---|
| DISCONNECTED |
DÉCONNECTÉ |
| CONNECTED |
CONNECTED |
ReplicaSynchronizationHealth
État d’intégrité du lien
| Valeur | Description |
|---|---|
| NOT_HEALTHY |
NOT_HEALTHY |
| PARTIALLY_HEALTHY |
PARTIALLY_HEALTHY |
| HEALTHY |
SAIN |
ReplicationModeType
Mode de réplication du lien
| Valeur | Description |
|---|---|
| Async |
Asynchrone |
| Sync |
Synchronisation |
SeedingModeType
Mode d’amorçage de base de données : peut être automatique (par défaut) ou Manuel pour les scénarios pris en charge.
| Valeur | Description |
|---|---|
| Automatic |
Automatique |
| Manual |
Manuel |
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. |