Sync Groups - Create Or Update

참조

서비스:: SQL Database

API 버전:: 2021-11-01

동기화 그룹을 만들거나 업데이트합니다.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/syncGroups/{syncGroupName}?api-version=2021-11-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
databaseName	path	True	string	동기화 그룹이 호스트되는 데이터베이스의 이름입니다.
resourceGroupName	path	True	string	리소스를 포함하는 리소스 그룹의 이름입니다. Azure 리소스 관리자 API 또는 포털에서 이 값을 가져올 수 있습니다.
serverName	path	True	string	서버의 이름입니다.
subscriptionId	path	True	string	Azure 구독을 식별하는 구독 ID입니다.
syncGroupName	path	True	string	동기화 그룹의 이름입니다.
api-version	query	True	string	요청에 사용할 API 버전입니다.

요청 본문

Name	형식	Description
properties.conflictLoggingRetentionInDays	integer	충돌 로깅 보존 기간.
properties.conflictResolutionPolicy	SyncConflictResolutionPolicy	동기화 그룹의 충돌 해결 정책입니다.
properties.enableConflictLogging	boolean	충돌 로깅을 사용하는 경우
properties.hubDatabasePassword	string	동기화 그룹 허브 데이터베이스 자격 증명의 암호입니다.
properties.hubDatabaseUserName	string	동기화 그룹 허브 데이터베이스 자격 증명의 사용자 이름입니다.
properties.interval	integer	동기화 그룹의 동기화 간격입니다.
properties.schema	SyncGroupSchema	동기화 그룹의 동기화 스키마입니다.
properties.syncDatabaseId	string	동기화 그룹에 있는 동기화 데이터베이스의 ARM 리소스 ID입니다.
properties.usePrivateLinkConnection	boolean	프라이빗 링크 연결을 사용할 수 있는 경우
sku	Sku	SKU의 이름 및 용량입니다.

응답

Name	형식	Description
200 OK	SyncGroup	동기화 그룹을 업데이트했습니다.
201 Created	SyncGroup	동기화 그룹을 만들었습니다.
202 Accepted		동기화 그룹 만들기 또는 업데이트가 진행 중입니다.
Other Status Codes		오류 응답: *** 400 InvalidSyncGroupCreateOrUpdateRequest - 동기화 그룹 만들기 또는 업데이트 요청 본문이 비어 있습니다. 400 InvalidSyncMemberCreateOrUpdateRequest - 동기화 멤버 만들기 또는 업데이트 요청 본문이 비어 있습니다. 400 InvalidSyncAgentCreateOrUpdateRequest - 동기화 에이전트 만들기 또는 업데이트 요청 본문이 비어 있습니다. 400 InvalidDatabaseResourceId - 잘못된 데이터베이스 리소스 식별자입니다. 400 MismatchingSubscriptionWithUrl - 제공된 구독이 URL의 구독과 일치하지 않습니다. 400 InvalidSyncAgentResourceId - 잘못된 동기화 에이전트 리소스 식별자입니다. 400 MismatchingResourceGroupNameWithUrl - 제공된 리소스 그룹 이름이 URL의 이름과 일치하지 않습니다. 400 MismatchingServerNameWithUrl - 제공된 서버 이름이 URL의 이름과 일치하지 않습니다. 400 InvalidParameterValue - 매개 변수에 잘못된 값이 지정되었습니다. 400 MissingServerName - 서버 이름이 없습니다. 400 MissingDatabaseName - 데이터베이스 이름이 없습니다. 400 MissingSyncGroupName - 동기화 그룹 이름이 없습니다. 400 MissingConflictResolutionPolicy - 충돌 해결 정책이 없습니다. 400 MissingSyncAgentName - 동기화 에이전트 이름이 없습니다. 400 SyncOperation_GenericFailure - 데이터 동기화 작업을 수행하지 못했습니다. 400 InvalidSyncGroup - 동기화 그룹이 잘못되었습니다. 400 FeatureDisabledOnSelectedEdition - 사용자가 현재 데이터베이스 버전에서 사용하지 않도록 설정된 기능을 사용하려고 했습니다. 400 CannotCreateSyncGroupDueToQuotaExceeded - 할당량이 초과되어 동기화 그룹을 만들 수 없습니다. 400 SyncOperation_DuplicateSyncGroupDrop - 동기화 그룹이 이미 삭제되고 있습니다. 400 SyncOperation_WrongSyncDatabase - 지정된 동기화 데이터베이스가 기존 데이터베이스와 일치하지 않습니다. 400 SyncOperation_UpdateSyncGroupWhenDropping - 현재 삭제 중이므로 동기화 그룹을 업데이트할 수 없습니다. 400 SyncOperation_DwInSyncGroup - 데이터 동기화에서 Datawarehouse 버전을 사용할 수 없습니다. 400 SyncOperation_MasterDbInSyncGroup - 데이터 동기화에서 논리 master 사용할 수 없습니다. 400 SyncOperation_InvalidCredential - 데이터베이스 자격 증명이 잘못되었습니다. 400 InvalidSyncMetadataDatabase - 동기화 메타데이터 데이터베이스가 잘못되었습니다. 400 SyncOperation_InvalidSyncInterval - 동기화 간격이 잘못되어 동기화 그룹을 만들거나 업데이트할 수 없습니다. 404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다. 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다. 404 DatabaseDoesNotExist - 사용자가 이 서버 instance 존재하지 않는 데이터베이스 이름을 지정했습니다. 404 SyncOperation_HubServerNotFound - 허브 논리 서버가 없습니다. 404 SyncOperation_InvalidHubDatabase - 허브 데이터베이스가 잘못되었습니다. 404 OperationIdNotFound - ID가 있는 작업이 없습니다. 409 SyncOperation_DuplicateSyncGroupName - 이름이 같은 동기화 그룹이 이미 있으므로 동기화 그룹을 만들 수 없습니다. 409 OperationCancelled - 사용자가 작업을 취소했습니다. 409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다. 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요. 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

예제

Create a sync group

Update a sync group

Create a sync group

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187?api-version=2021-11-01

{
  "properties": {
    "interval": -1,
    "conflictResolutionPolicy": "HubWin",
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
    "hubDatabaseUserName": "hubUser",
    "usePrivateLinkConnection": true
  }
}


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.SyncGroupInner;
import com.azure.resourcemanager.sql.models.SyncConflictResolutionPolicy;

/** Samples for SyncGroups CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/SyncGroupCreate.json
     */
    /**
     * Sample code: Create a sync group.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createASyncGroup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSyncGroups().createOrUpdate("syncgroupcrud-65440",
            "syncgroupcrud-8475", "syncgroupcrud-4328", "syncgroupcrud-3187",
            new SyncGroupInner().withInterval(-1).withConflictResolutionPolicy(SyncConflictResolutionPolicy.HUB_WIN)
                .withSyncDatabaseId(
                    "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328")
                .withHubDatabaseUsername("hubUser").withUsePrivateLinkConnection(true),
            Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

샘플 응답

상태 코드:: 200

{
  "properties": {
    "interval": -1,
    "lastSyncTime": "0001-01-01T08:00:00Z",
    "conflictResolutionPolicy": "HubWin",
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
    "hubDatabaseUserName": "hubUser",
    "syncState": "NotReady",
    "usePrivateLinkConnection": true,
    "privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncgroupcrud-8475"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187",
  "name": "syncgroupcrud-3187",
  "type": "Microsoft.Sql/servers/databases/syncGroups"
}

상태 코드:: 201

{
  "properties": {
    "interval": -1,
    "lastSyncTime": "0001-01-01T08:00:00Z",
    "conflictResolutionPolicy": "HubWin",
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
    "hubDatabaseUserName": "hubUser",
    "syncState": "NotReady",
    "usePrivateLinkConnection": true,
    "privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncgroupcrud-8475"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187",
  "name": "syncgroupcrud-3187",
  "type": "Microsoft.Sql/servers/databases/syncGroups"
}

상태 코드:: 202

Update a sync group

샘플 요청

HTTP
Java

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187?api-version=2021-11-01

{
  "properties": {
    "interval": -1,
    "conflictResolutionPolicy": "HubWin",
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
    "hubDatabaseUserName": "hubUser",
    "usePrivateLinkConnection": true
  }
}


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.SyncGroupInner;
import com.azure.resourcemanager.sql.models.SyncConflictResolutionPolicy;

/** Samples for SyncGroups CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/SyncGroupUpdate.json
     */
    /**
     * Sample code: Update a sync group.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateASyncGroup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSyncGroups().createOrUpdate("syncgroupcrud-65440",
            "syncgroupcrud-8475", "syncgroupcrud-4328", "syncgroupcrud-3187",
            new SyncGroupInner().withInterval(-1).withConflictResolutionPolicy(SyncConflictResolutionPolicy.HUB_WIN)
                .withSyncDatabaseId(
                    "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328")
                .withHubDatabaseUsername("hubUser").withUsePrivateLinkConnection(true),
            Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

샘플 응답

상태 코드:: 200

{
  "properties": {
    "interval": -1,
    "lastSyncTime": "0001-01-01T08:00:00Z",
    "conflictResolutionPolicy": "HubWin",
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
    "hubDatabaseUserName": "hubUser",
    "syncState": "NotReady",
    "usePrivateLinkConnection": true,
    "privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncgroupcrud-3187"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187",
  "name": "syncgroupcrud-3187",
  "type": "Microsoft.Sql/servers/databases/syncGroups"
}

상태 코드:: 201

{
  "properties": {
    "interval": -1,
    "lastSyncTime": "0001-01-01T08:00:00Z",
    "conflictResolutionPolicy": "HubWin",
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
    "hubDatabaseUserName": "hubUser",
    "syncState": "NotReady",
    "usePrivateLinkConnection": true,
    "privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncgroupcrud-3187"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187",
  "name": "syncgroupcrud-3187",
  "type": "Microsoft.Sql/servers/databases/syncGroups"
}

상태 코드:: 202

정의

Name	Description
Sku	ARM 리소스 SKU입니다.
SyncConflictResolutionPolicy	동기화 그룹의 충돌 해결 정책입니다.
SyncGroup	Azure SQL 데이터베이스 동기화 그룹입니다.
SyncGroupSchema	동기화 그룹 스키마의 속성입니다.
SyncGroupSchemaTable	동기화 그룹 스키마의 테이블 속성입니다.
SyncGroupSchemaTableColumn	동기화 그룹 테이블의 열 속성입니다.
SyncGroupState	동기화 그룹의 동기화 상태입니다.

Sku

ARM 리소스 SKU입니다.

Name	형식	Description
capacity	integer	특정 SKU의 용량입니다.
family	string	서비스에 동일한 SKU에 대해 서로 다른 세대의 하드웨어가 있는 경우 여기에서 캡처할 수 있습니다.
name	string	SKU의 이름(일반적으로 문자 + 숫자 코드(예: P3)입니다.
size	string	특정 SKU의 크기
tier	string	특정 SKU의 계층 또는 버전(예: 기본, 프리미엄)입니다.

SyncConflictResolutionPolicy

동기화 그룹의 충돌 해결 정책입니다.

Name	형식	Description
HubWin	string
MemberWin	string

SyncGroup

Azure SQL 데이터베이스 동기화 그룹입니다.

Name	형식	Description
id	string	리소스 ID입니다.
name	string	리소스 이름입니다.
properties.conflictLoggingRetentionInDays	integer	충돌 로깅 보존 기간.
properties.conflictResolutionPolicy	SyncConflictResolutionPolicy	동기화 그룹의 충돌 해결 정책입니다.
properties.enableConflictLogging	boolean	충돌 로깅을 사용하는 경우
properties.hubDatabasePassword	string	동기화 그룹 허브 데이터베이스 자격 증명의 암호입니다.
properties.hubDatabaseUserName	string	동기화 그룹 허브 데이터베이스 자격 증명의 사용자 이름입니다.
properties.interval	integer	동기화 그룹의 동기화 간격입니다.
properties.lastSyncTime	string	동기화 그룹의 마지막 동기화 시간입니다.
properties.privateEndpointName	string	프라이빗 링크 연결을 사용하는 경우 동기화 그룹의 프라이빗 엔드포인트 이름입니다.
properties.schema	SyncGroupSchema	동기화 그룹의 동기화 스키마입니다.
properties.syncDatabaseId	string	동기화 그룹에 있는 동기화 데이터베이스의 ARM 리소스 ID입니다.
properties.syncState	SyncGroupState	동기화 그룹의 동기화 상태입니다.
properties.usePrivateLinkConnection	boolean	프라이빗 링크 연결을 사용할 수 있는 경우
sku	Sku	SKU의 이름 및 용량입니다.
type	string	리소스 종류.

SyncGroupSchema

동기화 그룹 스키마의 속성입니다.

Name	형식	Description
masterSyncMemberName	string	스키마가 있는 master 동기화 멤버의 이름입니다.
tables	SyncGroupSchemaTable[]	동기화 그룹 스키마의 테이블 목록입니다.

SyncGroupSchemaTable

동기화 그룹 스키마의 테이블 속성입니다.

Name	형식	Description
columns	SyncGroupSchemaTableColumn[]	동기화 그룹 스키마의 열 목록입니다.
quotedName	string	동기화 그룹 스키마 테이블의 따옴표로 묶인 이름입니다.

SyncGroupSchemaTableColumn

동기화 그룹 테이블의 열 속성입니다.

Name	형식	Description
dataSize	string	열의 데이터 크기입니다.
dataType	string	열의 데이터 형식입니다.
quotedName	string	동기화 그룹 테이블 열의 따옴표로 묶인 이름입니다.

SyncGroupState

동기화 그룹의 동기화 상태입니다.

Name	형식	Description
Error	string
Good	string
NotReady	string
Progressing	string
Warning	string

다음을 통해 공유

Sync Groups - Create Or Update

URI 매개 변수

요청 본문

응답

예제

Create a sync group

샘플 요청

샘플 응답

Update a sync group

샘플 요청

샘플 응답

정의

Sku

SyncConflictResolutionPolicy

SyncGroup

SyncGroupSchema

SyncGroupSchemaTable

SyncGroupSchemaTableColumn

SyncGroupState

추가 리소스