Sync Members - 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}/syncMembers/{syncMemberName}?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	동기화 멤버가 호스트되는 동기화 그룹의 이름입니다.
syncMemberName	path	True	string	동기화 멤버의 이름입니다.
api-version	query	True	string	요청에 사용할 API 버전입니다.

요청 본문

Name	형식	Description
properties.databaseName	string	동기화 멤버에 있는 멤버 데이터베이스의 데이터베이스 이름입니다.
properties.databaseType	SyncMemberDbType	동기화 멤버의 데이터베이스 형식입니다.
properties.password	string	동기화 멤버에 있는 멤버 데이터베이스의 암호입니다.
properties.serverName	string	동기화 멤버에 있는 멤버 데이터베이스의 서버 이름
properties.sqlServerDatabaseId	string	동기화 멤버의 데이터베이스 ID를 SQL Server.
properties.syncAgentId	string	동기화 멤버에 있는 동기화 에이전트의 ARM 리소스 ID입니다.
properties.syncDirection	SyncDirection	동기화 멤버의 동기화 방향입니다.
properties.syncMemberAzureDatabaseResourceId	string	Azure의 동기화 멤버에 대한 동기화 멤버 논리 데이터베이스의 ARM 리소스 ID입니다.
properties.usePrivateLinkConnection	boolean	프라이빗 링크 연결을 사용할지 여부입니다.
properties.userName	string	동기화 멤버에 있는 멤버 데이터베이스의 사용자 이름입니다.

응답

Name	형식	Description
200 OK	SyncMember	동기화 멤버를 업데이트했습니다.
201 Created	SyncMember	동기화 멤버를 만들었습니다.
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 InvalidSyncMember - 동기화 멤버가 잘못되었습니다. 400 InvalidSyncAgent - 동기화 에이전트가 잘못되었습니다. 400 CannotCreateSyncMemberDueToQuotaExceeded - 할당량이 초과되어 동기화 멤버를 만들 수 없습니다. 400 SyncOperation_DuplicateSyncMemberDrop - 동기화 멤버가 이미 삭제되고 있습니다. 400 SyncOperation_WrongSyncDatabase - 지정된 동기화 데이터베이스가 기존 데이터베이스와 일치하지 않습니다. 400 SyncOperation_DwInSyncGroup - 데이터 동기화에서 Datawarehouse 버전을 사용할 수 없습니다. 400 SyncOperation_MasterDbInSyncGroup - 데이터 동기화에서 논리 master 사용할 수 없습니다. 400 SyncOperation_InvalidCredential - 데이터베이스 자격 증명이 잘못되었습니다. 400 InvalidSyncMetadataDatabase - 동기화 메타데이터 데이터베이스가 잘못되었습니다. 404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다. 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다. 404 DatabaseDoesNotExist - 사용자가 이 서버 instance 존재하지 않는 데이터베이스 이름을 지정했습니다. 404 SyncOperation_HubServerNotFound - 허브 논리 서버가 없습니다. 404 SyncOperation_InvalidHubDatabase - 허브 데이터베이스가 잘못되었습니다. 404 OperationIdNotFound - ID가 있는 작업이 없습니다. 409 SyncOperation_DuplicateSyncMemberName - 이름이 같은 동기화 멤버가 이미 있으므로 동기화 멤버를 만들 수 없습니다. 409 OperationCancelled - 사용자가 작업을 취소했습니다. 409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다. 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요. 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

예제

Create a new sync member

Update a sync member

Create a new sync member

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/syncMembers/syncmembercrud-4879?api-version=2021-11-01

{
  "properties": {
    "databaseType": "AzureSqlDatabase",
    "serverName": "syncgroupcrud-3379.database.windows.net",
    "databaseName": "syncgroupcrud-7421",
    "userName": "myUser",
    "syncDirection": "Bidirectional",
    "usePrivateLinkConnection": true,
    "syncMemberAzureDatabaseResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328"
  }
}


import com.azure.resourcemanager.sql.fluent.models.SyncMemberInner;
import com.azure.resourcemanager.sql.models.SyncDirection;
import com.azure.resourcemanager.sql.models.SyncMemberDbType;

/**
 * Samples for SyncMembers CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/SyncMemberCreate.json
     */
    /**
     * Sample code: Create a new sync member.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createANewSyncMember(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSyncMembers().createOrUpdate("syncgroupcrud-65440",
            "syncgroupcrud-8475", "syncgroupcrud-4328", "syncgroupcrud-3187", "syncmembercrud-4879",
            new SyncMemberInner().withDatabaseType(SyncMemberDbType.AZURE_SQL_DATABASE)
                .withSyncMemberAzureDatabaseResourceId(
                    "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328")
                .withUsePrivateLinkConnection(true).withServerName("syncgroupcrud-3379.database.windows.net")
                .withDatabaseName("syncgroupcrud-7421").withUsername("myUser")
                .withSyncDirection(SyncDirection.BIDIRECTIONAL),
            com.azure.core.util.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": {
    "databaseType": "AzureSqlDatabase",
    "serverName": "syncgroupcrud-3379.database.windows.net",
    "databaseName": "syncgroupcrud-7421",
    "userName": "myUser",
    "syncDirection": "Bidirectional",
    "syncState": "UnProvisioned",
    "usePrivateLinkConnection": true,
    "privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncmembercrud-4879",
    "syncMemberAzureDatabaseResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187/syncMembers/syncmembercrud-4879",
  "name": "syncmembercrud-4879",
  "type": "Microsoft.Sql/servers/databases/syncGroups/syncMembers"
}

상태 코드:: 201

{
  "properties": {
    "databaseType": "AzureSqlDatabase",
    "serverName": "syncgroupcrud-3379.database.windows.net",
    "databaseName": "syncgroupcrud-7421",
    "userName": "myUser",
    "syncDirection": "Bidirectional",
    "syncState": "UnProvisioned",
    "usePrivateLinkConnection": true,
    "privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncmembercrud-4879",
    "syncMemberAzureDatabaseResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187/syncMembers/syncmembercrud-4879",
  "name": "syncmembercrud-4879",
  "type": "Microsoft.Sql/servers/databases/syncGroups/syncMembers"
}

상태 코드:: 202

Update a sync member

샘플 요청

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/syncMembers/syncmembercrud-4879?api-version=2021-11-01

{
  "properties": {
    "databaseType": "AzureSqlDatabase",
    "serverName": "syncgroupcrud-3379.database.windows.net",
    "databaseName": "syncgroupcrud-7421",
    "userName": "myUser",
    "syncDirection": "Bidirectional",
    "usePrivateLinkConnection": true,
    "syncMemberAzureDatabaseResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328"
  }
}


import com.azure.resourcemanager.sql.fluent.models.SyncMemberInner;
import com.azure.resourcemanager.sql.models.SyncDirection;
import com.azure.resourcemanager.sql.models.SyncMemberDbType;

/**
 * Samples for SyncMembers CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/SyncMemberUpdate.json
     */
    /**
     * Sample code: Update a sync member.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateASyncMember(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSyncMembers().createOrUpdate("syncgroupcrud-65440",
            "syncgroupcrud-8475", "syncgroupcrud-4328", "syncgroupcrud-3187", "syncmembercrud-4879",
            new SyncMemberInner().withDatabaseType(SyncMemberDbType.AZURE_SQL_DATABASE)
                .withSyncMemberAzureDatabaseResourceId(
                    "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328")
                .withUsePrivateLinkConnection(true).withServerName("syncgroupcrud-3379.database.windows.net")
                .withDatabaseName("syncgroupcrud-7421").withUsername("myUser")
                .withSyncDirection(SyncDirection.BIDIRECTIONAL),
            com.azure.core.util.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": {
    "databaseType": "AzureSqlDatabase",
    "serverName": "syncgroupcrud-3379.database.windows.net",
    "databaseName": "syncgroupcrud-7421",
    "userName": "myUser",
    "syncDirection": "Bidirectional",
    "syncState": "UnProvisioned",
    "usePrivateLinkConnection": true,
    "privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncmembercrud-4879",
    "syncMemberAzureDatabaseResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187/syncMembers/syncmembercrud-4879",
  "name": "syncmembercrud-4879",
  "type": "Microsoft.Sql/servers/databases/syncGroups/syncMembers"
}

상태 코드:: 201

{
  "properties": {
    "databaseType": "AzureSqlDatabase",
    "serverName": "syncgroupcrud-3379.database.windows.net",
    "databaseName": "syncgroupcrud-7421",
    "userName": "myUser",
    "syncDirection": "Bidirectional",
    "syncState": "UnProvisioned",
    "usePrivateLinkConnection": true,
    "privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncmembercrud-4879",
    "syncMemberAzureDatabaseResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187/syncMembers/syncmembercrud-4879",
  "name": "syncmembercrud-4879",
  "type": "Microsoft.Sql/servers/databases/syncGroups/syncMembers"
}

상태 코드:: 202

정의

Name	Description
SyncDirection	동기화 멤버의 동기화 방향입니다.
SyncMember	Azure SQL 데이터베이스 동기화 멤버입니다.
SyncMemberDbType	동기화 멤버의 데이터베이스 형식입니다.
SyncMemberState	동기화 멤버의 동기화 상태입니다.

SyncDirection

동기화 멤버의 동기화 방향입니다.

Name	형식	Description
Bidirectional	string
OneWayHubToMember	string
OneWayMemberToHub	string

SyncMember

Azure SQL 데이터베이스 동기화 멤버입니다.

Name	형식	Description
id	string	리소스 ID입니다.
name	string	리소스 이름입니다.
properties.databaseName	string	동기화 멤버에 있는 멤버 데이터베이스의 데이터베이스 이름입니다.
properties.databaseType	SyncMemberDbType	동기화 멤버의 데이터베이스 형식입니다.
properties.password	string	동기화 멤버에 있는 멤버 데이터베이스의 암호입니다.
properties.privateEndpointName	string	Azure의 동기화 멤버에 대해 프라이빗 링크 연결을 사용하는 경우 동기화 멤버의 프라이빗 엔드포인트 이름입니다.
properties.serverName	string	동기화 멤버에 있는 멤버 데이터베이스의 서버 이름
properties.sqlServerDatabaseId	string	동기화 멤버의 데이터베이스 ID를 SQL Server.
properties.syncAgentId	string	동기화 멤버에 있는 동기화 에이전트의 ARM 리소스 ID입니다.
properties.syncDirection	SyncDirection	동기화 멤버의 동기화 방향입니다.
properties.syncMemberAzureDatabaseResourceId	string	Azure의 동기화 멤버에 대한 동기화 멤버 논리 데이터베이스의 ARM 리소스 ID입니다.
properties.syncState	SyncMemberState	동기화 멤버의 동기화 상태입니다.
properties.usePrivateLinkConnection	boolean	프라이빗 링크 연결을 사용할지 여부입니다.
properties.userName	string	동기화 멤버에 있는 멤버 데이터베이스의 사용자 이름입니다.
type	string	리소스 종류.

SyncMemberDbType

동기화 멤버의 데이터베이스 형식입니다.

Name	형식	Description
AzureSqlDatabase	string
SqlServerDatabase	string

SyncMemberState

동기화 멤버의 동기화 상태입니다.

Name	형식	Description
DeProvisionFailed	string
DeProvisioned	string
DeProvisioning	string
DisabledBackupRestore	string
DisabledTombstoneCleanup	string
ProvisionFailed	string
Provisioned	string
Provisioning	string
ReprovisionFailed	string
Reprovisioning	string
SyncCancelled	string
SyncCancelling	string
SyncFailed	string
SyncInProgress	string
SyncSucceeded	string
SyncSucceededWithWarnings	string
UnProvisioned	string
UnReprovisioned	string

다음을 통해 공유

Sync Members - Create Or Update

URI 매개 변수

요청 본문

응답

예제

Create a new sync member

샘플 요청

샘플 응답

Update a sync member

샘플 요청

샘플 응답

정의

SyncDirection

SyncMember

SyncMemberDbType

SyncMemberState

추가 리소스