Distributed Availability Groups - Create Or Update
Skapar en distribuerad tillgänglighetsgrupp mellan SQL On-Premises och Sql Managed Instance.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/distributedAvailabilityGroups/{distributedAvailabilityGroupName}?api-version=2025-01-01
URI-parametrar
| Name | I | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
distributed
|
path | True |
string |
Namnet på den distribuerade tillgänglighetsgruppen. |
|
managed
|
path | True |
string |
Namnet på den hanterade instansen. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Namnet på resursgruppen. Namnet är skiftlägesokänsligt. |
|
subscription
|
path | True |
string (uuid) |
ID för målprenumerationen. Värdet måste vara ett UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Den API-version som ska användas för den här åtgärden. |
Begärandetext
| Name | Typ | Description |
|---|---|---|
| properties.databases |
Databaser i den distribuerade tillgänglighetsgruppen |
|
| properties.failoverMode |
Länkens failover-läge – kan vara Manual om det är avsett att användas för tvåvägs failover med en stödd SQL Server, eller None för enkelriktad failover till Azure. |
|
| properties.instanceAvailabilityGroupName |
string |
Namn på tillgänglighetsgrupp för hanterad instans |
| properties.instanceLinkRole |
Länkroll för hanterad instans |
|
| properties.partnerAvailabilityGroupName |
string |
Namn på sql-serversidans tillgänglighetsgrupp |
| properties.partnerEndpoint |
string |
SQL-serverslutpunkt – IP- eller DNS-matchningsbart namn |
| properties.replicationMode |
Replikeringsläge för länken |
|
| properties.seedingMode |
Databassidningsläge – kan vara Automatisk (standard) eller Manuell för scenarier som stöds. |
Svar
| Name | Typ | Description |
|---|---|---|
| 200 OK |
Resursens uppdateringsoperation 'DistributedAvailabilityGroup' lyckades |
|
| 201 Created |
Resursen 'DistributedAvailabilityGroup' skapade operationen lyckades Sidhuvuden
|
|
| 202 Accepted |
Resursåtgärden har godkänts. Sidhuvuden
|
|
| Other Status Codes |
Ett oväntat felsvar. |
Säkerhet
azure_auth
Azure Active Directory OAuth2 Flow.
Typ:
oauth2
Flow:
implicit
Auktoriseringswebbadress:
https://login.microsoftonline.com/common/oauth2/authorize
Omfattningar
| Name | Description |
|---|---|
| user_impersonation | personifiera ditt användarkonto |
Exempel
| Create a distributed availability group with all properties. |
| Create a distributed availability group with minimal properties. |
Create a distributed availability group with all properties.
Exempelbegäran
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"
}
}
Exempelsvar
{
"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.
Exempelbegäran
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"
}
}
Exempelsvar
{
"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"
}
}
Definitioner
| Name | Description |
|---|---|
|
Certificate |
Certifikatinformation |
|
created |
Den typ av identitet som skapade resursen. |
|
Distributed |
Distribuerad tillgänglighetsgrupp mellan Box och SQL Managed Instance. |
|
Distributed |
Databasspecifik information |
|
Error |
Resurshanteringsfelet ytterligare information. |
|
Error |
Detaljerna om felet. |
|
Error |
Felsvar |
|
Failover |
Länkens failover-läge – kan vara Manual om det är avsett att användas för tvåvägs failover med en stödd SQL Server, eller None för enkelriktad failover till Azure. |
|
Link |
Länkroll på SQL-serversidan |
|
Replica |
Länka anslutet tillstånd |
|
Replica |
Länka hälsotillstånd |
|
Replication |
Replikeringsläge för länken |
|
Seeding |
Databassidningsläge – kan vara Automatisk (standard) eller Manuell för scenarier som stöds. |
|
system |
Metadata som rör skapande och senaste ändring av resursen. |
CertificateInfo
Certifikatinformation
| Name | Typ | Description |
|---|---|---|
| certificateName |
string |
Certifikatnamnet |
| expiryDate |
string (date-time) |
Certifikatets förfallodatum |
createdByType
Den typ av identitet som skapade resursen.
| Värde | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DistributedAvailabilityGroup
Distribuerad tillgänglighetsgrupp mellan Box och SQL Managed Instance.
| Name | Typ | Description |
|---|---|---|
| id |
string (arm-id) |
Fullständigt kvalificerat resurs-ID för resursen. T.ex. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Namnet på resursen |
| properties.databases |
Databaser i den distribuerade tillgänglighetsgruppen |
|
| properties.distributedAvailabilityGroupId |
string (uuid) |
ID för den distribuerade tillgänglighetsgruppen |
| properties.distributedAvailabilityGroupName |
string |
Namnet på den distribuerade tillgänglighetsgruppen |
| properties.failoverMode |
Länkens failover-läge – kan vara Manual om det är avsett att användas för tvåvägs failover med en stödd SQL Server, eller None för enkelriktad failover till Azure. |
|
| properties.instanceAvailabilityGroupName |
string |
Namn på tillgänglighetsgrupp för hanterad instans |
| properties.instanceLinkRole |
Länkroll för hanterad instans |
|
| properties.partnerAvailabilityGroupName |
string |
Namn på sql-serversidans tillgänglighetsgrupp |
| properties.partnerEndpoint |
string |
SQL-serverslutpunkt – IP- eller DNS-matchningsbart namn |
| properties.partnerLinkRole |
Länkroll på SQL-serversidan |
|
| properties.replicationMode |
Replikeringsläge för länken |
|
| properties.seedingMode |
Databassidningsläge – kan vara Automatisk (standard) eller Manuell för scenarier som stöds. |
|
| systemData |
Azure Resource Manager-metadata som innehåller creationBy och modifiedBy-information. |
|
| type |
string |
Resurstypen. T.ex. "Microsoft. Compute/virtualMachines" eller "Microsoft. Storage/storageAccounts" |
DistributedAvailabilityGroupDatabase
Databasspecifik information
| Name | Typ | Description |
|---|---|---|
| connectedState |
Länka anslutet tillstånd |
|
| databaseName |
string |
Namnet på databasen i länk |
| instanceRedoReplicationLagSeconds |
integer (int32) |
Redo-lagg när Managed Instance-länksidan är primär |
| instanceReplicaId |
string (uuid) |
Replik-ID för hanterad instans |
| instanceSendReplicationLagSeconds |
integer (int32) |
Replikationsfördröjning när Managed Instance-länksidan är primär |
| lastBackupLsn |
string |
Senaste säkerhetskopiering av LSN |
| lastBackupTime |
string (date-time) |
LSN-tid för senaste säkerhetskopiering |
| lastCommitLsn |
string |
Senaste incheckning av LSN |
| lastCommitTime |
string (date-time) |
Senaste incheckningstid för LSN |
| lastHardenedLsn |
string |
Senaste härdade LSN |
| lastHardenedTime |
string (date-time) |
Senaste härdade LSN-tid |
| lastReceivedLsn |
string |
Senast mottagna LSN |
| lastReceivedTime |
string (date-time) |
Senast mottagen LSN-tid |
| lastSentLsn |
string |
Senast skickat LSN |
| lastSentTime |
string (date-time) |
Senast skickad LSN-tid |
| mostRecentLinkError |
string |
Den senaste beskrivningen av länkanslutningsfel |
| partnerAuthCertValidity |
SQL Server-certifikatets giltighet |
|
| partnerReplicaId |
string (uuid) |
SQL Server-replik-ID |
| replicaState |
string |
Aktuellt länktillstånd |
| seedingProgress |
string |
Seeding-förlopp |
| synchronizationHealth |
Länka hälsotillstånd |
ErrorAdditionalInfo
Resurshanteringsfelet ytterligare information.
| Name | Typ | Description |
|---|---|---|
| info |
object |
Den ytterligare informationen. |
| type |
string |
Typen av ytterligare information. |
ErrorDetail
Detaljerna om felet.
| Name | Typ | Description |
|---|---|---|
| additionalInfo |
Felet ytterligare information. |
|
| code |
string |
Felkoden. |
| details |
Felinformationen. |
|
| message |
string |
Felmeddelandet. |
| target |
string |
Felmålet. |
ErrorResponse
Felsvar
| Name | Typ | Description |
|---|---|---|
| error |
Felet objektet. |
FailoverModeType
Länkens failover-läge – kan vara Manual om det är avsett att användas för tvåvägs failover med en stödd SQL Server, eller None för enkelriktad failover till Azure.
| Värde | Description |
|---|---|
| None |
Ingen |
| Manual |
Manuell |
LinkRole
Länkroll på SQL-serversidan
| Värde | Description |
|---|---|
| Primary |
Primär |
| Secondary |
Secondary |
ReplicaConnectedState
Länka anslutet tillstånd
| Värde | Description |
|---|---|
| DISCONNECTED |
BORTKOPPLAD |
| CONNECTED |
ANSLUTEN |
ReplicaSynchronizationHealth
Länka hälsotillstånd
| Värde | Description |
|---|---|
| NOT_HEALTHY |
NOT_HEALTHY |
| PARTIALLY_HEALTHY |
PARTIALLY_HEALTHY |
| HEALTHY |
HÄLSOSAMT |
ReplicationModeType
Replikeringsläge för länken
| Värde | Description |
|---|---|
| Async |
Asynkron |
| Sync |
Synkronisering |
SeedingModeType
Databassidningsläge – kan vara Automatisk (standard) eller Manuell för scenarier som stöds.
| Värde | Description |
|---|---|
| Automatic |
Automatiskt |
| Manual |
Manuell |
systemData
Metadata som rör skapande och senaste ändring av resursen.
| Name | Typ | Description |
|---|---|---|
| createdAt |
string (date-time) |
Tidsstämpeln för resursskapande (UTC). |
| createdBy |
string |
Identiteten som skapade resursen. |
| createdByType |
Den typ av identitet som skapade resursen. |
|
| lastModifiedAt |
string (date-time) |
Tidsstämpeln för senaste ändring av resurs (UTC) |
| lastModifiedBy |
string |
Identiteten som senast ändrade resursen. |
| lastModifiedByType |
Den typ av identitet som senast ändrade resursen. |