Sync Members - Create Or Update

Hizmet:: SQL Database

API Sürümü:: 2023-08-01

Eşitleme üyesi oluşturur veya güncelleştirir.

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 Parametreleri

Name	İçinde	Gerekli	Tür	Description
databaseName	path	True	string	Eşitleme grubunun barındırıldığı veritabanının adı.
resourceGroupName	path	True	string	Kaynağı içeren kaynak grubunun adı. Bu değeri Azure Resource Manager API'sinden veya portaldan alabilirsiniz.
serverName	path	True	string	Sunucunun adı.
subscriptionId	path	True	string	Azure aboneliğini tanımlayan abonelik kimliği.
syncGroupName	path	True	string	Eşitleme üyesinin barındırıldığı eşitleme grubunun adı.
syncMemberName	path	True	string	Eşitleme üyesinin adı.
api-version	query	True	string	İstek için kullanılacak API sürümü.

İstek Gövdesi

Name	Tür	Description
properties.databaseName	string	Eşitleme üyesindeki üye veritabanının veritabanı adı.
properties.databaseType	SyncMemberDbType	Eşitleme üyesinin veritabanı türü.
properties.password	string	Eşitleme üyesindeki üye veritabanının parolası.
properties.serverName	string	Eşitleme üyesindeki üye veritabanının sunucu adı
properties.sqlServerDatabaseId	string (uuid)	Eşitleme üyesinin SQL Server veritabanı kimliği.
properties.syncAgentId	string	Eşitleme üyesindeki eşitleme aracısının ARM kaynak kimliği.
properties.syncDirection	SyncDirection	Eşitleme üyesinin eşitleme yönü.
properties.syncMemberAzureDatabaseResourceId	string	Azure'daki eşitleme üyeleri için eşitleme üyesi mantıksal veritabanının ARM kaynak kimliği.
properties.usePrivateLinkConnection	boolean	Özel bağlantı bağlantısının kullanılıp kullanılmaymayacağı.
properties.userName	string	Eşitleme üyesindeki üye veritabanının kullanıcı adı.

Yanıtlar

Name	Tür	Description
200 OK	SyncMember	Eşitleme üyesi başarıyla güncelleştirildi.
201 Created	SyncMember	Eşitleme üyesi başarıyla oluşturuldu.
202 Accepted		Eşitleme üyesi oluşturma veya güncelleştirme işlemi devam ediyor. Üst Bilgiler Location: string
Other Status Codes	ErrorResponse	Hata Yanıtları: *** 400 InvalidSyncGroupCreateOrUpdateRequest - Eşitleme grubu oluşturma veya güncelleştirme istek gövdesi boş. 400 InvalidSyncMemberCreateOrUpdateRequest - Eşitleme üyesi oluşturma veya güncelleştirme isteği gövdesi boş. 400 InvalidSyncAgentCreateOrUpdateRequest - Eşitleme aracısı oluşturma veya güncelleştirme isteği gövdesi boş. 400 InvalidDatabaseResourceId - Geçersiz veritabanı kaynak tanımlayıcısı. 400 InvalidSyncGroupName - Eşitleme Grubu adı geçersiz. Bu alan harf, sayı, tire ve alt çizgi içerebilir. 400 InvalidSyncMemberName - Eşitleme Üyesi adı geçersiz. Bu alan harf, sayı, tire ve alt çizgi içerebilir. 400 MissingSyncMemberName - Eşitleme Üyesi adı eksik 400 InvalidSyncGroupInterval - Eşitleme Aralığı 5 saniyeden büyük veya buna eşit olmalıdır. 400 MismatchingSubscriptionWithUrl - Sağlanan abonelik Url'deki abonelikle eşleşmedi. 400 InvalidSyncAgentResourceId - Geçersiz eşitleme aracısı kaynak tanımlayıcısı. 400 MismatchingResourceGroupNameWithUrl - Sağlanan kaynak grubu adı Url'deki adla eşleşmedi. 400 MismatchingServerNameWithUrl - Sağlanan sunucu adı Url'deki adla eşleşmedi. 400 InvalidParameterValue - Parametreye geçersiz bir değer verildi. 400 MissingServerName - Sunucu adı eksik 400 MissingDatabaseName - Veritabanı adı eksik 400 MissingSyncGroupName - Eşitleme Grubu adı eksik 400 MissingConflictResolutionPolicy - Çakışma Çözümleme İlkesi eksik 400 MissingSyncAgentName - Eşitleme Aracısı adı eksik 400 SyncOperation_GenericFailure - Veri eşitleme işlemi gerçekleştirilemedi. 400 InvalidSyncGroup - Eşitleme grubu geçersiz. 400 InvalidSyncMember - Eşitleme üyesi geçersiz. 400 InvalidSyncAgent - Eşitleme aracısı geçersiz. 400 CannotCreateSyncMemberDueToQuotaExceeded - Kota aşıldığından eşitleme üyesi oluşturulamıyor. 400 SyncOperation_DuplicateSyncMemberDrop - Eşitleme üyesi zaten bırakılıyor. 400 SyncOperation_WrongSyncDatabase - Belirtilen eşitleme veritabanı mevcut veritabanıyla eşleşmiyor. 400 SyncOperation_DwInSyncGroup - Veri eşitlemede veri deposu sürümü kullanılamaz. 400 SyncOperation_MasterDbInSyncGroup - Veri eşitlemede mantıksal ana şablon kullanılamaz. 400 SyncOperation_UnsupportedDataTypeColumnInSchema - Sütunun veri türü desteklenmediğinden şemaya sütun eklenemiyor. 400 SyncOperation_InvalidCredential - Veritabanının kimlik bilgileri geçersiz. 400 InvalidSyncMetadataDatabase - Eşitleme meta veri veritabanı geçersiz. 404 ResourceNotFound - İstenen kaynak bulunamadı. 404 SubscriptionDoesNotHaveServer - İstenen sunucu bulunamadı 404 DatabaseDoesNotExist - Kullanıcı bu sunucu örneğinde var olmayan bir veritabanı adı belirtti. 404 SyncOperation_HubServerNotFound - Hub mantıksal sunucusu yok. 404 SyncOperation_InvalidHubDatabase - Hub veritabanı geçersiz. 404 OperationIdNotFound - Kimliği olan işlem yok. 409 SyncOperation_DuplicateSyncMemberName - Aynı ada sahip eşitleme üyesi zaten mevcut olduğundan eşitleme üyesi oluşturulamıyor. 409 CannotCancelOperation - Yönetim işlemi iptal edilemeyen bir durumda. 409 OperationCancelled - İşlem kullanıcı tarafından iptal edildi. 409 İşlem Kesildi - Kaynak üzerindeki işlem, aynı kaynak üzerindeki başka bir işlem tarafından kesildiği için tamamlanamadı. 429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler. 429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler. 500 OperationTimedOut - İşlem zaman aşımına uğradı ve otomatik olarak geri alındı. Lütfen işlemi yeniden deneyin. 503 TooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler.

Örnekler

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

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/SyncMemberCreate.json
// this example is just showing the usage of "SyncMembers_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SyncGroupResource created on azure
// for more information of creating SyncGroupResource, please refer to the document of SyncGroupResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "syncgroupcrud-65440";
string serverName = "syncgroupcrud-8475";
string databaseName = "syncgroupcrud-4328";
string syncGroupName = "syncgroupcrud-3187";
ResourceIdentifier syncGroupResourceId = SyncGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, databaseName, syncGroupName);
SyncGroupResource syncGroup = client.GetSyncGroupResource(syncGroupResourceId);

// get the collection of this SyncMemberResource
SyncMemberCollection collection = syncGroup.GetSyncMembers();

// invoke the operation
string syncMemberName = "syncmembercrud-4879";
SyncMemberData data = new SyncMemberData
{
    DatabaseType = SyncMemberDbType.AzureSqlDatabase,
    SyncMemberAzureDatabaseResourceId = new ResourceIdentifier("/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328"),
    UsePrivateLinkConnection = true,
    ServerName = "syncgroupcrud-3379.database.windows.net",
    DatabaseName = "syncgroupcrud-7421",
    UserName = "myUser",
    SyncDirection = SyncDirection.Bidirectional,
};
ArmOperation<SyncMemberResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, syncMemberName, data);
SyncMemberResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
SyncMemberData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

Örnek yanıt

Durum kodu:: 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"
}

Durum kodu:: 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"
}

Durum kodu:: 202

Update a sync member

Örnek isteği

HTTP
dotnet

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"
  }
}

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/SyncMemberUpdate.json
// this example is just showing the usage of "SyncMembers_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SyncGroupResource created on azure
// for more information of creating SyncGroupResource, please refer to the document of SyncGroupResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "syncgroupcrud-65440";
string serverName = "syncgroupcrud-8475";
string databaseName = "syncgroupcrud-4328";
string syncGroupName = "syncgroupcrud-3187";
ResourceIdentifier syncGroupResourceId = SyncGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, databaseName, syncGroupName);
SyncGroupResource syncGroup = client.GetSyncGroupResource(syncGroupResourceId);

// get the collection of this SyncMemberResource
SyncMemberCollection collection = syncGroup.GetSyncMembers();

// invoke the operation
string syncMemberName = "syncmembercrud-4879";
SyncMemberData data = new SyncMemberData
{
    DatabaseType = SyncMemberDbType.AzureSqlDatabase,
    SyncMemberAzureDatabaseResourceId = new ResourceIdentifier("/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328"),
    UsePrivateLinkConnection = true,
    ServerName = "syncgroupcrud-3379.database.windows.net",
    DatabaseName = "syncgroupcrud-7421",
    UserName = "myUser",
    SyncDirection = SyncDirection.Bidirectional,
};
ArmOperation<SyncMemberResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, syncMemberName, data);
SyncMemberResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
SyncMemberData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

Örnek yanıt

Durum kodu:: 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"
}

Durum kodu:: 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"
}

Durum kodu:: 202

Tanımlar

Name	Description
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
SyncDirection	Eşitleme üyesinin eşitleme yönü.
SyncMember	Azure SQL Veritabanı eşitleme üyesi.
SyncMemberDbType	Eşitleme üyesinin veritabanı türü.
SyncMemberState	Eşitleme üyesinin eşitleme durumu.

ErrorAdditionalInfo

Object

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Object

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Object

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

SyncDirection

Listeleme

Eşitleme üyesinin eşitleme yönü.

Değer	Description
Bidirectional
OneWayMemberToHub
OneWayHubToMember

SyncMember

Object

Azure SQL Veritabanı eşitleme üyesi.

Name	Tür	Description
id	string	Kaynak Kimliği.
name	string	Kaynak adı.
properties.databaseName	string	Eşitleme üyesindeki üye veritabanının veritabanı adı.
properties.databaseType	SyncMemberDbType	Eşitleme üyesinin veritabanı türü.
properties.password	string	Eşitleme üyesindeki üye veritabanının parolası.
properties.privateEndpointName	string	Azure'daki eşitleme üyeleri için özel bağlantı bağlantısı kullan etkinleştirildiyse eşitleme üyesinin özel uç nokta adı.
properties.serverName	string	Eşitleme üyesindeki üye veritabanının sunucu adı
properties.sqlServerDatabaseId	string (uuid)	Eşitleme üyesinin SQL Server veritabanı kimliği.
properties.syncAgentId	string	Eşitleme üyesindeki eşitleme aracısının ARM kaynak kimliği.
properties.syncDirection	SyncDirection	Eşitleme üyesinin eşitleme yönü.
properties.syncMemberAzureDatabaseResourceId	string	Azure'daki eşitleme üyeleri için eşitleme üyesi mantıksal veritabanının ARM kaynak kimliği.
properties.syncState	SyncMemberState	Eşitleme üyesinin eşitleme durumu.
properties.usePrivateLinkConnection	boolean	Özel bağlantı bağlantısının kullanılıp kullanılmaymayacağı.
properties.userName	string	Eşitleme üyesindeki üye veritabanının kullanıcı adı.
type	string	Kaynak türü.

SyncMemberDbType

Listeleme

Eşitleme üyesinin veritabanı türü.

Değer	Description
AzureSqlDatabase
SqlServerDatabase

SyncMemberState

Listeleme

Eşitleme üyesinin eşitleme durumu.

Değer	Description
SyncInProgress
SyncSucceeded
SyncFailed
DisabledTombstoneCleanup
DisabledBackupRestore
SyncSucceededWithWarnings
SyncCancelling
SyncCancelled
UnProvisioned
Provisioning
Provisioned
ProvisionFailed
DeProvisioning
DeProvisioned
DeProvisionFailed
Reprovisioning
ReprovisionFailed
UnReprovisioned

Aracılığıyla paylaş

Sync Members - Create Or Update

URI Parametreleri

İstek Gövdesi

Yanıtlar

Örnekler

Create a new sync member

Örnek isteği

Örnek yanıt

Update a sync member

Örnek isteği

Örnek yanıt

Tanımlar

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

SyncDirection

SyncMember

SyncMemberDbType

SyncMemberState