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
distributedAvailabilityGroupName
path True

string

Nom du groupe de disponibilité distribué.

managedInstanceName
path True

string

Nom de l’instance managée.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nom du groupe de ressources. Le nom ne respecte pas la casse.

subscriptionId
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

DistributedAvailabilityGroupDatabase[]

Bases de données dans le groupe de disponibilité distribué

properties.failoverMode

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.

properties.instanceAvailabilityGroupName

string

Nom du groupe de disponibilité côté instance managée

properties.instanceLinkRole

LinkRole

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

ReplicationModeType

Mode de réplication du lien

properties.seedingMode

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.

Réponses

Nom Type Description
200 OK

DistributedAvailabilityGroup

Opération de mise à jour de la ressource 'DistributedAvailabilityGroup' réussie

201 Created

DistributedAvailabilityGroup

Ressource 'DistributedAvailabilityGroup' créer l’opération a réussi

En-têtes

  • Location: string
  • Retry-After: integer
202 Accepted

Exploitation des ressources acceptée.

En-têtes

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

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
CertificateInfo

Informations sur le certificat

createdByType

Type d’identité qui a créé la ressource.

DistributedAvailabilityGroup

Groupe de disponibilité distribué entre la boîte et l’instance Sql Managed Instance.

DistributedAvailabilityGroupDatabase

Informations spécifiques à la base de données

ErrorAdditionalInfo

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

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse 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.

LinkRole

Rôle de lien côté serveur SQL

ReplicaConnectedState

Lier l’état connecté

ReplicaSynchronizationHealth

État d’intégrité du lien

ReplicationModeType

Mode de réplication du lien

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.

systemData

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

DistributedAvailabilityGroupDatabase[]

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

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.

properties.instanceAvailabilityGroupName

string

Nom du groupe de disponibilité côté instance managée

properties.instanceLinkRole

LinkRole

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

LinkRole

Rôle de lien côté serveur SQL

properties.replicationMode

ReplicationModeType

Mode de réplication du lien

properties.seedingMode

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.

systemData

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

ReplicaConnectedState

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

CertificateInfo

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

ReplicaSynchronizationHealth

É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

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

Réponse d’erreur

Nom Type Description
error

ErrorDetail

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

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

createdByType

Type d’identité qui a modifié la ressource pour la dernière fois.