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

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 参数

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

请求正文

名称	类型	说明
properties.databaseName	string	同步成员中成员数据库的数据库名称。
properties.databaseType	SyncMemberDbType	同步成员的数据库类型。
properties.password	string	同步成员中成员数据库的密码。
properties.serverName	string	同步成员中成员数据库的服务器名称
properties.sqlServerDatabaseId	string	SQL Server同步成员的数据库 ID。
properties.syncAgentId	string	同步成员中同步代理的 ARM 资源 ID。
properties.syncDirection	SyncDirection	同步成员的同步方向。
properties.syncMemberAzureDatabaseResourceId	string	Azure 中同步成员的同步成员逻辑数据库的 ARM 资源 ID。
properties.usePrivateLinkConnection	boolean	是否使用专用链接连接。
properties.userName	string	同步成员中成员数据库的用户名。

响应

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

定义

名称	说明
SyncDirection	同步成员的同步方向。
SyncMember	Azure SQL数据库同步成员。
SyncMemberDbType	同步成员的数据库类型。
SyncMemberState	同步成员的同步状态。

SyncDirection

同步成员的同步方向。

名称	类型	说明
Bidirectional	string
OneWayHubToMember	string
OneWayMemberToHub	string

SyncMember

Azure SQL数据库同步成员。

名称	类型	说明
id	string	资源 ID。
name	string	资源名称。
properties.databaseName	string	同步成员中成员数据库的数据库名称。
properties.databaseType	SyncMemberDbType	同步成员的数据库类型。
properties.password	string	同步成员中成员数据库的密码。
properties.privateEndpointName	string	如果为 Azure 中的同步成员启用了使用专用链接连接，则同步成员的专用终结点名称。
properties.serverName	string	同步成员中成员数据库的服务器名称
properties.sqlServerDatabaseId	string	SQL Server同步成员的数据库 ID。
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

同步成员的数据库类型。

名称	类型	说明
AzureSqlDatabase	string
SqlServerDatabase	string

SyncMemberState

同步成员的同步状态。

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

其他资源