Sync Groups - Create Or Update

Hizmet:: SQL Database

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

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

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/syncGroups/{syncGroupName}?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 grubunun adı.
api-version	query	True	string	İstek için kullanılacak API sürümü.

İstek Gövdesi

Name	Tür	Description
properties.conflictLoggingRetentionInDays	integer (int32)	Çakışma günlüğü saklama süresi.
properties.conflictResolutionPolicy	SyncConflictResolutionPolicy	Eşitleme grubunun çakışma çözümleme ilkesi.
properties.enableConflictLogging	boolean	Çakışma günlüğü etkinleştirildiyse.
properties.hubDatabasePassword	string	Eşitleme grubu hub'ı veritabanı kimlik bilgileri için parola.
properties.hubDatabaseUserName	string	Eşitleme grubu hub'ı veritabanı kimlik bilgileri için kullanıcı adı.
properties.interval	integer (int32)	Eşitleme grubunun eşitleme aralığı.
properties.schema	SyncGroupSchema	Eşitleme grubunun eşitleme şeması.
properties.syncDatabaseId	string	Eşitleme grubundaki eşitleme veritabanının ARM kaynak kimliği.
properties.usePrivateLinkConnection	boolean	Özel bağlantı kullan seçeneğinin etkin olması.
sku	Sku	SKU'nun adı ve kapasitesi.

Yanıtlar

Name	Tür	Description
200 OK	SyncGroup	Eşitleme grubu başarıyla güncelleştirildi.
201 Created	SyncGroup	Eşitleme grubu başarıyla oluşturuldu.
202 Accepted		Eşitleme grubu 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 FeatureDisabledOnSelectedEdition - Kullanıcı geçerli veritabanı sürümünde devre dışı bırakılmış bir özelliği kullanmaya çalıştı. 400 CannotCreateSyncGroupDueToQuotaExceeded - Kota aşıldığından eşitleme grubu oluşturulamıyor. 400 SyncOperation_DuplicateSyncGroupDrop - Eşitleme grubu zaten bırakılıyor. 400 SyncOperation_WrongSyncDatabase - Belirtilen eşitleme veritabanı mevcut veritabanıyla eşleşmiyor. 400 SyncOperation_UpdateSyncGroupWhenDropping - Eşitleme grubu şu anda bırakıldığı için güncelleştirilemiyor. 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. 400 SyncOperation_InvalidSyncInterval - Eşitleme aralığı geçersiz olduğundan eşitleme grubu oluşturulamıyor veya güncelleştirilemiyor. 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_DuplicateSyncGroupName - Aynı ada sahip eşitleme grubu zaten mevcut olduğundan eşitleme grubu 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 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=2023-08-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
  }
}

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/SyncGroupCreate.json
// this example is just showing the usage of "SyncGroups_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 SqlDatabaseResource created on azure
// for more information of creating SqlDatabaseResource, please refer to the document of SqlDatabaseResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "syncgroupcrud-65440";
string serverName = "syncgroupcrud-8475";
string databaseName = "syncgroupcrud-4328";
ResourceIdentifier sqlDatabaseResourceId = SqlDatabaseResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, databaseName);
SqlDatabaseResource sqlDatabase = client.GetSqlDatabaseResource(sqlDatabaseResourceId);

// get the collection of this SyncGroupResource
SyncGroupCollection collection = sqlDatabase.GetSyncGroups();

// invoke the operation
string syncGroupName = "syncgroupcrud-3187";
SyncGroupData data = new SyncGroupData
{
    Interval = -1,
    ConflictResolutionPolicy = SyncConflictResolutionPolicy.HubWin,
    SyncDatabaseId = new ResourceIdentifier("/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328"),
    HubDatabaseUserName = "hubUser",
    UsePrivateLinkConnection = true,
};
ArmOperation<SyncGroupResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, syncGroupName, data);
SyncGroupResource 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
SyncGroupData 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": {
    "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"
}

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

Durum kodu:: 202

Update a sync group

Ö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?api-version=2023-08-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
  }
}

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/SyncGroupUpdate.json
// this example is just showing the usage of "SyncGroups_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 SqlDatabaseResource created on azure
// for more information of creating SqlDatabaseResource, please refer to the document of SqlDatabaseResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "syncgroupcrud-65440";
string serverName = "syncgroupcrud-8475";
string databaseName = "syncgroupcrud-4328";
ResourceIdentifier sqlDatabaseResourceId = SqlDatabaseResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, databaseName);
SqlDatabaseResource sqlDatabase = client.GetSqlDatabaseResource(sqlDatabaseResourceId);

// get the collection of this SyncGroupResource
SyncGroupCollection collection = sqlDatabase.GetSyncGroups();

// invoke the operation
string syncGroupName = "syncgroupcrud-3187";
SyncGroupData data = new SyncGroupData
{
    Interval = -1,
    ConflictResolutionPolicy = SyncConflictResolutionPolicy.HubWin,
    SyncDatabaseId = new ResourceIdentifier("/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328"),
    HubDatabaseUserName = "hubUser",
    UsePrivateLinkConnection = true,
};
ArmOperation<SyncGroupResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, syncGroupName, data);
SyncGroupResource 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
SyncGroupData 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": {
    "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"
}

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

Durum kodu:: 202

Tanımlar

Name	Description
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
Sku	ARM Kaynağı SKU'su.
SyncConflictResolutionPolicy	Eşitleme grubunun çakışma çözümleme ilkesi.
SyncGroup	Azure SQL Veritabanı eşitleme grubu.
SyncGroupSchema	Eşitleme grubu şemasının özellikleri.
SyncGroupSchemaTable	Eşitleme grubu şemasındaki tablonun özellikleri.
SyncGroupSchemaTableColumn	Eşitleme grubu tablosundaki sütunun özellikleri.
SyncGroupState	Eşitleme grubunun 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.

Sku

Object

ARM Kaynağı SKU'su.

Name	Tür	Description
capacity	integer (int32)	Belirli bir SKU'nun kapasitesi.
family	string	Hizmetin aynı SKU için farklı donanım nesilleri varsa, bu burada yakalanabilir.
name	string	SKU adı, genellikle bir harf + Sayı kodu, örneğin P3.
size	string	Belirli SKU'nun boyutu
tier	string	Temel, Premium gibi belirli bir SKU'nun katmanı veya sürümü.

SyncConflictResolutionPolicy

Listeleme

Eşitleme grubunun çakışma çözümleme ilkesi.

Değer	Description
HubWin
MemberWin

SyncGroup

Object

Azure SQL Veritabanı eşitleme grubu.

Name	Tür	Description
id	string	Kaynak Kimliği.
name	string	Kaynak adı.
properties.conflictLoggingRetentionInDays	integer (int32)	Çakışma günlüğü saklama süresi.
properties.conflictResolutionPolicy	SyncConflictResolutionPolicy	Eşitleme grubunun çakışma çözümleme ilkesi.
properties.enableConflictLogging	boolean	Çakışma günlüğü etkinleştirildiyse.
properties.hubDatabasePassword	string	Eşitleme grubu hub'ı veritabanı kimlik bilgileri için parola.
properties.hubDatabaseUserName	string	Eşitleme grubu hub'ı veritabanı kimlik bilgileri için kullanıcı adı.
properties.interval	integer (int32)	Eşitleme grubunun eşitleme aralığı.
properties.lastSyncTime	string (date-time)	Eşitleme grubunun son eşitleme zamanı.
properties.privateEndpointName	string	Özel bağlantı kullan bağlantısı etkinse eşitleme grubunun özel uç nokta adı.
properties.schema	SyncGroupSchema	Eşitleme grubunun eşitleme şeması.
properties.syncDatabaseId	string	Eşitleme grubundaki eşitleme veritabanının ARM kaynak kimliği.
properties.syncState	SyncGroupState	Eşitleme grubunun eşitleme durumu.
properties.usePrivateLinkConnection	boolean	Özel bağlantı kullan seçeneğinin etkin olması.
sku	Sku	SKU'nun adı ve kapasitesi.
type	string	Kaynak türü.

SyncGroupSchema

Object

Eşitleme grubu şemasının özellikleri.

Name	Tür	Description
masterSyncMemberName	string	Şemanın geldiği ana eşitleme üyesinin adı.
tables	SyncGroupSchemaTable[]	Eşitleme grubu şemasındaki tabloların listesi.

SyncGroupSchemaTable

Object

Eşitleme grubu şemasındaki tablonun özellikleri.

Name	Tür	Description
columns	SyncGroupSchemaTableColumn[]	Eşitleme grubu şemasındaki sütunların listesi.
quotedName	string	Eşitleme grubu şema tablosunun alıntılanan adı.

SyncGroupSchemaTableColumn

Object

Eşitleme grubu tablosundaki sütunun özellikleri.

Name	Tür	Description
dataSize	string	Sütunun veri boyutu.
dataType	string	Sütunun veri türü.
quotedName	string	Eşitleme grubu tablo sütununun alıntılanan adı.

SyncGroupState

Listeleme

Eşitleme grubunun eşitleme durumu.

Değer	Description
NotReady
Error
Warning
Progressing
Good

Aracılığıyla paylaş

Sync Groups - Create Or Update

URI Parametreleri

İstek Gövdesi

Yanıtlar

Örnekler

Create a sync group

Örnek isteği

Örnek yanıt

Update a sync group

Örnek isteği

Örnek yanıt

Tanımlar

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Sku

SyncConflictResolutionPolicy

SyncGroup

SyncGroupSchema

SyncGroupSchemaTable

SyncGroupSchemaTableColumn

SyncGroupState