Sync Members - Create Or Update

Служба:: SQL Database

Версия API:: 2023-08-01

Создает или обновляет элемент синхронизации.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
databaseName	path	True	string	Имя базы данных, в которой размещена группа синхронизации.
resourceGroupName	path	True	string	Имя группы ресурсов, содержащей ресурс. Это значение можно получить из API Azure Resource Manager или портала.
serverName	path	True	string	Имя сервера.
subscriptionId	path	True	string	Идентификатор подписки, идентифицирующий подписку Azure.
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 (uuid)	Идентификатор базы данных SQL Server элемента синхронизации.
properties.syncAgentId	string	Идентификатор ресурса ARM агента синхронизации в элементе синхронизации.
properties.syncDirection	SyncDirection	Направление синхронизации элемента синхронизации.
properties.syncMemberAzureDatabaseResourceId	string	Идентификатор ресурса ARM логической базы данных-члена синхронизации для членов синхронизации в Azure.
properties.usePrivateLinkConnection	boolean	Следует ли использовать подключение с приватным каналом.
properties.userName	string	Имя пользователя базы данных-члена в элементе синхронизации.

Ответы

Имя	Тип	Описание
200 OK	SyncMember	Успешно обновлен элемент синхронизации.
201 Created	SyncMember	Успешно создан элемент синхронизации.
202 Accepted		Выполняется создание или обновление элемента синхронизации. Заголовки Location: string
Other Status Codes	ErrorResponse	Ответы на ошибки: *** 400 InvalidSyncGroupCreateOrUpdateRequest — текст запроса на создание или обновление группы синхронизации пуст. 400 InvalidSyncMemberCreateOrUpdateRequest — текст запроса на создание или обновление элемента синхронизации пуст. 400 InvalidSyncAgentCreateOrUpdateRequest . Текст запроса агента создания или обновления синхронизации пуст. 400 InvalidDatabaseResourceId — недопустимый идентификатор ресурса базы данных. 400 InvalidSyncGroupName — недопустимое имя группы синхронизации. Это поле может содержать буквы, цифры, дефисы и символы подчеркивания. 400 InvalidSyncMemberName — недопустимое имя члена синхронизации. Это поле может содержать буквы, цифры, дефисы и символы подчеркивания. 400 MissingSyncMemberName — отсутствует имя члена синхронизации 400 InvalidSyncGroupInterval — интервал синхронизации должен быть больше или равен 5 секундам. 400 НесоответствиеSubscriptionWithUrl — указанная подписка не соответствует подписке в 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 CannotCreateSyncMemberDueToQuotaExceed — не удается создать элемент синхронизации из-за превышения квоты. 400 SyncOperation_DuplicateSyncMemberDrop — элемент синхронизации уже удален. 400 SyncOperation_WrongSyncDatabase. Указанная база данных синхронизации не соответствует существующей. 400 SyncOperation_DwInSyncGroup . Не удается использовать выпуск datawarehouse в синхронизации данных. 400 SyncOperation_MasterDbInSyncGroup. Не удается использовать логический главный в синхронизации данных. 400 SyncOperation_UnsupportedDataTypeColumnInSchema. Невозможно добавить столбец в схему, так как тип данных столбца не поддерживается. 400 SyncOperation_InvalidCredential . Учетные данные базы данных недопустимы. 400 InvalidSyncMetadataDatabase— недопустимая база данных метаданных синхронизации. 404 ResourceNotFound — запрошенный ресурс не найден. 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден 404 DatabaseDoesNotExist — пользователь указал имя базы данных, которое не существует на этом экземпляре сервера. 404 SyncOperation_HubServerNotFound — логический сервер концентратора не существует. 404 SyncOperation_InvalidHubDatabase — база данных концентратора недопустима. 404 OperationIdNotFound — операция с идентификатором не существует. 409 SyncOperation_DuplicateSyncMemberName . Не удается создать элемент синхронизации, так как член синхронизации с тем же именем уже существует. 409 CannotCancelOperation — операция управления находится в состоянии, которое не может быть отменено. 409 OperationCancelled — операция отменена пользователем. 409 Operation Прервана — операция с ресурсом не удалось завершить, так как она была прервана другой операцией в том же ресурсе. 429 SubscriptionTooManyCreateUpdateRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами. 429 SubscriptionTooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами. 500 OperationTimedOut — время ожидания операции истекло и автоматически откатился. Повторите операцию. 503 TooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами.

Примеры

Create a new sync member

Update a sync member

Create a new sync member

Образец запроса

HTTP

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=2023-08-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"
  }
}

Пример ответа

Код состояния:: 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

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=2023-08-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"
  }
}

Пример ответа

Код состояния:: 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

Определения

Имя	Описание
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
SyncDirection	Направление синхронизации элемента синхронизации.
SyncMember	Член синхронизации базы данных SQL Azure.
SyncMemberDbType	Тип базы данных члена синхронизации.
SyncMemberState	Состояние синхронизации члена синхронизации.

ErrorAdditionalInfo

Объект

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

Объект

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Объект

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

SyncDirection

Перечисление

Направление синхронизации элемента синхронизации.

Значение	Описание
Bidirectional
OneWayMemberToHub
OneWayHubToMember

SyncMember

Объект

Член синхронизации базы данных SQL Azure.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.databaseName	string	Имя базы данных-члена в элементе синхронизации.
properties.databaseType	SyncMemberDbType	Тип базы данных члена синхронизации.
properties.password	string	Пароль базы данных-члена в элементе синхронизации.
properties.privateEndpointName	string	Имя частной конечной точки члена синхронизации, если включено подключение приватного канала для членов синхронизации в Azure.
properties.serverName	string	Имя сервера базы данных-члена в элементе синхронизации
properties.sqlServerDatabaseId	string (uuid)	Идентификатор базы данных SQL Server элемента синхронизации.
properties.syncAgentId	string	Идентификатор ресурса ARM агента синхронизации в элементе синхронизации.
properties.syncDirection	SyncDirection	Направление синхронизации элемента синхронизации.
properties.syncMemberAzureDatabaseResourceId	string	Идентификатор ресурса ARM логической базы данных-члена синхронизации для членов синхронизации в Azure.
properties.syncState	SyncMemberState	Состояние синхронизации члена синхронизации.
properties.usePrivateLinkConnection	boolean	Следует ли использовать подключение с приватным каналом.
properties.userName	string	Имя пользователя базы данных-члена в элементе синхронизации.
type	string	Тип ресурса.

SyncMemberDbType

Перечисление

Тип базы данных члена синхронизации.

Значение	Описание
AzureSqlDatabase
SqlServerDatabase

SyncMemberState

Перечисление

Состояние синхронизации члена синхронизации.

Значение	Описание
SyncInProgress
SyncSucceeded
SyncFailed
DisabledTombstoneCleanup
DisabledBackupRestore
SyncSucceededWithWarnings
SyncCancelling
SyncCancelled
UnProvisioned
Provisioning
Provisioned
ProvisionFailed
DeProvisioning
DeProvisioned
DeProvisionFailed
Reprovisioning
ReprovisionFailed
UnReprovisioned

Поделиться через

Sync Members - Create Or Update

Параметры URI

Текст запроса

Ответы

Примеры

Create a new sync member

Образец запроса

Пример ответа

Update a sync member

Образец запроса

Пример ответа

Определения

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

SyncDirection

SyncMember

SyncMemberDbType

SyncMemberState