你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Sync Groups - Create Or Update

参考

Service:: SQL Database

API Version:: 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 参数

名称	在	必需	类型	说明
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 版本。

请求正文

名称	类型	说明
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 的名称和容量。

响应

名称	类型	说明
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 - 无法在数据同步中使用逻辑主数据库。 400 SyncOperation_InvalidCredential - 数据库的凭据无效。 400 InvalidSyncMetadataDatabase - 同步元数据数据库无效。 400 SyncOperation_InvalidSyncInterval - 无法创建或更新同步组，因为同步间隔无效。 404 ResourceNotFound - 找不到请求的资源。 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器 404 DatabaseDoesNotExist - 用户指定了此服务器实例上不存在的数据库名称。 404 SyncOperation_HubServerNotFound - 中心逻辑服务器不存在。 404 SyncOperation_InvalidHubDatabase - 中心数据库无效。 404 OperationIdNotFound - ID 为的操作不存在。 409 SyncOperation_DuplicateSyncGroupName - 无法创建同步组，因为已存在同名的同步组。 409 OperationCancelled - 用户已取消该操作。 409 操作中断 - 无法完成对资源的操作，因为它被同一资源上的另一个操作中断。 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

Sample Response

Status code:: 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"
}

Status code:: 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"
}

Status code:: 202

Update a sync group

Sample Request

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

Sample Response

Status code:: 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"
}

Status code:: 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"
}

Status code:: 202

定义

名称	说明
Sku	ARM 资源 SKU。
SyncConflictResolutionPolicy	同步组的冲突解决策略。
SyncGroup	Azure SQL数据库同步组。
SyncGroupSchema	同步组架构的属性。
SyncGroupSchemaTable	同步组架构中表的属性。
SyncGroupSchemaTableColumn	同步组表中列的属性。
SyncGroupState	同步组的同步状态。

Sku

ARM 资源 SKU。

名称	类型	说明
capacity	integer	特定 SKU 的容量。
family	string	如果服务具有不同代系的硬件（对于同一 SKU），则可以在此处进行捕获。
name	string	SKU 的名称，通常为字母 + 数字代码，例如 P3。
size	string	特定 SKU 的大小
tier	string	特定 SKU 的层或版本，例如“基本”、“高级”。

SyncConflictResolutionPolicy

同步组的冲突解决策略。

名称	类型	说明
HubWin	string
MemberWin	string

SyncGroup

Azure SQL数据库同步组。

名称	类型	说明
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

同步组架构的属性。

名称	类型	说明
masterSyncMemberName	string	架构所在的主同步成员的名称。
tables	SyncGroupSchemaTable[]	同步组架构中的表列表。

SyncGroupSchemaTable

同步组架构中表的属性。

名称	类型	说明
columns	SyncGroupSchemaTableColumn[]	同步组架构中的列列表。
quotedName	string	带引号的同步组架构表的名称。

SyncGroupSchemaTableColumn

同步组表中列的属性。

名称	类型	说明
dataSize	string	列的数据大小。
dataType	string	列的数据类型。
quotedName	string	同步组表列的带引号的名称。

SyncGroupState

同步组的同步状态。

名称	类型	说明
Error	string
Good	string
NotReady	string
Progressing	string
Warning	string

Sync Groups - Create Or Update

URI 参数

请求正文

响应

示例

Create a sync group

Sample Request

Sample Response

Update a sync group

Sample Request

Sample Response

定义

Sku

SyncConflictResolutionPolicy

SyncGroup

SyncGroupSchema

SyncGroupSchemaTable

SyncGroupSchemaTableColumn

SyncGroupState

其他资源