Distributed Availability Groups - Create Or Update

Sql On-Prem과 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 매개 변수

Name In(다음 안에) 필수 형식 Description
distributedAvailabilityGroupName
path True

string

분산 가용성 그룹 이름입니다.

managedInstanceName
path True

string

관리되는 인스턴스의 이름입니다.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.

subscriptionId
path True

string (uuid)

대상 구독의 ID입니다. 값은 UUID여야 합니다.

api-version
query True

string

minLength: 1

이 작업에 사용할 API 버전입니다.

요청 본문

Name 형식 Description
properties.databases

DistributedAvailabilityGroupDatabase[]

분산 가용성 그룹의 데이터베이스

properties.failoverMode

FailoverModeType

링크 페일오버 모드는 지원되는 SQL Server와의 양방향 페일오버를 위해 수동 모드로 사용할 수 있으며, Azure로의 일방향 페일오버를 위한 None(없음) 모드가 될 수 있습니다.

properties.instanceAvailabilityGroupName

string

관리되는 인스턴스 쪽 가용성 그룹 이름

properties.instanceLinkRole

LinkRole

관리되는 인스턴스 쪽 링크 역할

properties.partnerAvailabilityGroupName

string

SQL Server 쪽 가용성 그룹 이름

properties.partnerEndpoint

string

SQL Server 쪽 엔드포인트 - IP 또는 DNS 확인 가능한 이름

properties.replicationMode

ReplicationModeType

링크의 복제 모드

properties.seedingMode

SeedingModeType

데이터베이스 시드 모드 – 지원되는 시나리오의 경우 자동(기본값) 또는 수동일 수 있습니다.

응답

Name 형식 Description
200 OK

DistributedAvailabilityGroup

리소스 'DistributedAvailabilityGroup' 업데이트 작업이 성공했습니다

201 Created

DistributedAvailabilityGroup

리소스 'DistributedAvailabilityGroup' 작업 생성 성공

헤더

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

자원 작업이 허용되었습니다.

헤더

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

ErrorResponse

예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

Create a distributed availability group with all properties.
Create a distributed availability group with minimal properties.

Create a distributed availability group with all properties.

샘플 요청

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"
  }
}

샘플 응답

{
  "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.

샘플 요청

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"
  }
}

샘플 응답

{
  "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"
  }
}

정의

Name Description
CertificateInfo

인증서 정보

createdByType

리소스를 만든 ID의 형식입니다.

DistributedAvailabilityGroup

Box와 Sql Managed Instance 간의 분산 가용성 그룹입니다.

DistributedAvailabilityGroupDatabase

데이터베이스 관련 정보

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

FailoverModeType

링크 페일오버 모드는 지원되는 SQL Server와의 양방향 페일오버를 위해 수동 모드로 사용할 수 있으며, Azure로의 일방향 페일오버를 위한 None(없음) 모드가 될 수 있습니다.

LinkRole

SQL Server 쪽 링크 역할

ReplicaConnectedState

연결된 상태 연결

ReplicaSynchronizationHealth

링크 상태

ReplicationModeType

링크의 복제 모드

SeedingModeType

데이터베이스 시드 모드 – 지원되는 시나리오의 경우 자동(기본값) 또는 수동일 수 있습니다.

systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

CertificateInfo

인증서 정보

Name 형식 Description
certificateName

string

인증서 이름

expiryDate

string (date-time)

인증서 만료 날짜

createdByType

리소스를 만든 ID의 형식입니다.

값 Description
User
Application
ManagedIdentity
Key

DistributedAvailabilityGroup

Box와 Sql Managed Instance 간의 분산 가용성 그룹입니다.

Name 형식 Description
id

string (arm-id)

리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

리소스의 이름

properties.databases

DistributedAvailabilityGroupDatabase[]

분산 가용성 그룹의 데이터베이스

properties.distributedAvailabilityGroupId

string (uuid)

분산 가용성 그룹의 ID

properties.distributedAvailabilityGroupName

string

분산 가용성 그룹의 이름

properties.failoverMode

FailoverModeType

링크 페일오버 모드는 지원되는 SQL Server와의 양방향 페일오버를 위해 수동 모드로 사용할 수 있으며, Azure로의 일방향 페일오버를 위한 None(없음) 모드가 될 수 있습니다.

properties.instanceAvailabilityGroupName

string

관리되는 인스턴스 쪽 가용성 그룹 이름

properties.instanceLinkRole

LinkRole

관리되는 인스턴스 쪽 링크 역할

properties.partnerAvailabilityGroupName

string

SQL Server 쪽 가용성 그룹 이름

properties.partnerEndpoint

string

SQL Server 쪽 엔드포인트 - IP 또는 DNS 확인 가능한 이름

properties.partnerLinkRole

LinkRole

SQL Server 쪽 링크 역할

properties.replicationMode

ReplicationModeType

링크의 복제 모드

properties.seedingMode

SeedingModeType

데이터베이스 시드 모드 – 지원되는 시나리오의 경우 자동(기본값) 또는 수동일 수 있습니다.

systemData

systemData

Azure Resource Manager 메타데이터에 createdBy 및 modifiedBy 정보가 포함되어 있습니다.

type

string

리소스의 형식입니다. 예를 들어, "Microsoft. 컴퓨트/가상 머신" 또는 "Microsoft." 저장소/저장소 계정"

DistributedAvailabilityGroupDatabase

데이터베이스 관련 정보

Name 형식 Description
connectedState

ReplicaConnectedState

연결된 상태 연결

databaseName

string

링크에 있는 데이터베이스의 이름

instanceRedoReplicationLagSeconds

integer (int32)

Managed Instance 링크 쪽이 주된 상태일 때 지연 재작업

instanceReplicaId

string (uuid)

관리되는 인스턴스 복제본 ID

instanceSendReplicationLagSeconds

integer (int32)

Managed Instance 링크 측이 주 링크일 때 복제 지연

lastBackupLsn

string

마지막 백업 LSN

lastBackupTime

string (date-time)

마지막 백업 LSN 시간

lastCommitLsn

string

마지막 커밋 LSN

lastCommitTime

string (date-time)

마지막 커밋 LSN 시간

lastHardenedLsn

string

마지막으로 강화된 LSN

lastHardenedTime

string (date-time)

마지막으로 강화된 LSN 시간

lastReceivedLsn

string

마지막으로 받은 LSN

lastReceivedTime

string (date-time)

마지막으로 받은 LSN 시간

lastSentLsn

string

마지막으로 보낸 LSN

lastSentTime

string (date-time)

마지막으로 보낸 LSN 시간

mostRecentLinkError

string

가장 최근의 링크 연결 오류 설명

partnerAuthCertValidity

CertificateInfo

SQL Server 인증서 유효성

partnerReplicaId

string (uuid)

SQL Server 복제본 ID

replicaState

string

현재 링크 상태

seedingProgress

string

시드 진행률

synchronizationHealth

ReplicaSynchronizationHealth

링크 상태

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

오류 개체입니다.

FailoverModeType

링크 페일오버 모드는 지원되는 SQL Server와의 양방향 페일오버를 위해 수동 모드로 사용할 수 있으며, Azure로의 일방향 페일오버를 위한 None(없음) 모드가 될 수 있습니다.

값 Description
None

없음

Manual

설명서

LinkRole

SQL Server 쪽 링크 역할

값 Description
Primary

기본

Secondary

부차적인

ReplicaConnectedState

연결된 상태 연결

값 Description
DISCONNECTED

DISCONNECTED

CONNECTED

CONNECTED

ReplicaSynchronizationHealth

링크 상태

값 Description
NOT_HEALTHY

NOT_HEALTHY

PARTIALLY_HEALTHY

PARTIALLY_HEALTHY

HEALTHY

건강해

ReplicationModeType

링크의 복제 모드

값 Description
Async

비동기

Sync

동기화

SeedingModeType

데이터베이스 시드 모드 – 지원되는 시나리오의 경우 자동(기본값) 또는 수동일 수 있습니다.

값 Description
Automatic

자동

Manual

설명서

systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name 형식 Description
createdAt

string (date-time)

리소스 만들기의 타임스탬프(UTC)입니다.

createdBy

string

리소스를 만든 ID입니다.

createdByType

createdByType

리소스를 만든 ID의 형식입니다.

lastModifiedAt

string (date-time)

리소스 마지막 수정의 타임스탬프(UTC)

lastModifiedBy

string

리소스를 마지막으로 수정한 ID입니다.

lastModifiedByType

createdByType

리소스를 마지막으로 수정한 ID의 형식입니다.