Sync Groups - Create Or Update

  • Referensi
Service:
SQL Database
API Version:
2021-02-01-preview

Membuat atau memperbarui grup sinkronisasi.

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

Parameter URI

Name In Required Type Description
databaseName
 path True
  • string

Nama database tempat grup sinkronisasi dihosting.
resourceGroupName
 path True
  • string

Nama grup sumber daya yang berisi sumber daya. Anda dapat memperoleh nilai ini dari Azure Resource Manager API atau portal.
serverName
 path True
  • string

Nama server.
subscriptionId
 path True
  • string

ID langganan yang mengidentifikasi langganan Azure.
syncGroupName
 path True
  • string

Nama grup sinkronisasi.
api-version
 query True
  • string

Versi API yang digunakan untuk permintaan.

Isi Permintaan

Name Type Description
properties.conflictLoggingRetentionInDays
  • integer

Periode retensi pengelogan konflik.
properties.conflictResolutionPolicy

Kebijakan resolusi konflik dari grup sinkronisasi.
properties.enableConflictLogging
  • boolean

Jika pencatatan konflik diaktifkan.
properties.hubDatabasePassword
  • string

Kata sandi untuk kredensial database hub grup sinkronisasi.
properties.hubDatabaseUserName
  • string

Nama pengguna untuk kredensial database hub grup sinkronisasi.
properties.interval
  • integer

Interval sinkronisasi grup sinkronisasi.
properties.schema

Sinkronkan skema grup sinkronisasi.
properties.syncDatabaseId
  • string

Id sumber daya ARM dari database sinkronisasi dalam grup sinkronisasi.
properties.usePrivateLinkConnection
  • boolean

Jika menggunakan koneksi tautan privat diaktifkan.
sku

Nama dan kapasitas SKU.

Respons

Name Type Description
200 OK

Berhasil memperbarui grup sinkronisasi.
201 Created

Berhasil membuat grup sinkronisasi.
202 Accepted

Membuat atau memperbarui grup sinkronisasi sedang berlangsung.
Other Status Codes

Respons Kesalahan: ***

  • 400 InvalidSyncGroupCreateOrUpdateRequest - Isi permintaan grup sinkronisasi buat atau perbarui kosong.

  • 400 InvalidSyncMemberCreateOrUpdateRequest - Isi permintaan anggota sinkronisasi buat atau perbarui kosong.

  • 400 InvalidSyncAgentCreateOrUpdateRequest - Isi permintaan agen sinkronisasi buat atau perbarui kosong.

  • 400 InvalidDatabaseResourceId - Pengidentifikasi sumber daya database tidak valid.

  • 400 MismatchingSubscriptionWithUrl - Langganan yang disediakan tidak cocok dengan langganan di Url.

  • 400 InvalidSyncAgentResourceId - Pengidentifikasi sumber daya agen sinkronisasi tidak valid.

  • 400 MismatchingResourceGroupNameWithUrl - Nama grup sumber daya yang disediakan tidak cocok dengan nama di Url.

  • 400 MismatchingServerNameWithUrl - Nama server yang disediakan tidak cocok dengan nama di Url.

  • 400 InvalidParameterValue - Nilai yang tidak valid diberikan ke parameter.

  • 400 SyncOperation_GenericFailure - Gagal melakukan operasi sinkronisasi data.

  • 400 InvalidSyncGroup - Grup sinkronisasi tidak valid.

  • 400 FeatureDisabledOnSelectedEdition - Pengguna mencoba menggunakan fitur yang dinonaktifkan pada edisi database saat ini.

  • 400 CannotCreateSyncGroupDueToQuotaExceeded - Tidak dapat membuat grup sinkronisasi karena kuota terlampaui.

  • 400 SyncOperation_DuplicateSyncGroupDrop - Grup sinkronisasi sudah dihilangkan.

  • 400 SyncOperation_WrongSyncDatabase - Database sinkronisasi yang ditentukan tidak cocok dengan yang sudah ada.

  • 400 SyncOperation_UpdateSyncGroupWhenDropping - Tidak dapat memperbarui grup sinkronisasi karena saat ini sedang dihilangkan.

  • 400 SyncOperation_DwInSyncGroup - Tidak dapat menggunakan edisi gudang data dalam sinkronisasi data.

  • 400 SyncOperation_MasterDbInSyncGroup - Tidak dapat menggunakan master logis dalam sinkronisasi data.

  • 400 SyncOperation_InvalidCredential - Kredensial database tidak valid.

  • 400 InvalidSyncMetadataDatabase - Database metadata sinkronisasi tidak valid.

  • 400 SyncOperation_InvalidSyncInterval - Tidak dapat membuat atau memperbarui grup sinkronisasi karena interval sinkronisasi tidak valid.

  • 404 ResourceNotFound - Sumber daya yang diminta tidak ditemukan.

  • 404 SubscriptionDoesNotHaveServer - Server yang diminta tidak ditemukan

  • 404 DatabaseDoesNotExist - Pengguna telah menentukan nama database yang tidak ada pada instans server ini.

  • 404 SyncOperation_HubServerNotFound - Server logis hub tidak ada.

  • 404 SyncOperation_InvalidHubDatabase - Database hub tidak valid.

  • 409 SyncOperation_DuplicateSyncGroupName - Tidak dapat membuat grup sinkronisasi karena grup sinkronisasi dengan nama yang sama sudah ada.

Contoh

Create a sync group
Update a sync group

Create a sync group

Sample Request

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-02-01-preview

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

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

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-02-01-preview

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

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

Definisi

Sku

SKU Sumber Daya ARM.
SyncConflictResolutionPolicy

Kebijakan resolusi konflik dari grup sinkronisasi.
SyncGroup

Grup sinkronisasi Azure SQL Database.
SyncGroupSchema

Properti skema grup sinkronisasi.
SyncGroupSchemaTable

Properti tabel dalam skema grup sinkronisasi.
SyncGroupSchemaTableColumn

Properti kolom dalam tabel grup sinkronisasi.
SyncGroupState

Status sinkronisasi grup sinkronisasi.

Sku

SKU Sumber Daya ARM.

Name Type Description
capacity
  • integer

Kapasitas SKU tertentu.
family
  • string

Jika layanan memiliki generasi perangkat keras yang berbeda, untuk SKU yang sama, maka itu dapat ditangkap di sini.
name
  • string

Nama SKU, biasanya, kode huruf + Angka, misalnya P3.
size
  • string

Ukuran SKU tertentu
tier
  • string

Tingkat atau edisi SKU tertentu, misalnya Dasar, Premium.

SyncConflictResolutionPolicy

Kebijakan resolusi konflik dari grup sinkronisasi.

Name Type Description
HubWin
  • string
MemberWin
  • string

SyncGroup

Grup sinkronisasi Azure SQL Database.

Name Type Description
id
  • string

ID Sumber Daya.
name
  • string

Nama sumber daya.
properties.conflictLoggingRetentionInDays
  • integer

Periode retensi pengelogan konflik.
properties.conflictResolutionPolicy

Kebijakan resolusi konflik dari grup sinkronisasi.
properties.enableConflictLogging
  • boolean

Jika pencatatan konflik diaktifkan.
properties.hubDatabasePassword
  • string

Kata sandi untuk kredensial database hub grup sinkronisasi.
properties.hubDatabaseUserName
  • string

Nama pengguna untuk kredensial database hub grup sinkronisasi.
properties.interval
  • integer

Interval sinkronisasi grup sinkronisasi.
properties.lastSyncTime
  • string

Waktu sinkronisasi terakhir grup sinkronisasi.
properties.privateEndpointName
  • string

Nama titik akhir privat grup sinkronisasi jika menggunakan koneksi tautan privat diaktifkan.
properties.schema

Sinkronkan skema grup sinkronisasi.
properties.syncDatabaseId
  • string

Id sumber daya ARM dari database sinkronisasi dalam grup sinkronisasi.
properties.syncState

Status sinkronisasi grup sinkronisasi.
properties.usePrivateLinkConnection
  • boolean

Jika menggunakan koneksi tautan privat diaktifkan.
sku

Nama dan kapasitas SKU.
type
  • string

Jenis sumber daya

SyncGroupSchema

Properti skema grup sinkronisasi.

Name Type Description
masterSyncMemberName
  • string

Nama anggota sinkronisasi master tempat skema berasal.
tables

Daftar tabel dalam skema grup sinkronisasi.

SyncGroupSchemaTable

Properti tabel dalam skema grup sinkronisasi.

Name Type Description
columns

Daftar kolom dalam skema grup sinkronisasi.
quotedName
  • string

Nama tabel skema grup sinkronisasi yang dikutip.

SyncGroupSchemaTableColumn

Properti kolom dalam tabel grup sinkronisasi.

Name Type Description
dataSize
  • string

Ukuran data kolom.
dataType
  • string

Jenis data kolom.
quotedName
  • string

Nama kolom tabel grup sinkronisasi yang dikutip.

SyncGroupState

Status sinkronisasi grup sinkronisasi.

Name Type Description
Error
  • string
Good
  • string
NotReady
  • string
Progressing
  • string
Warning
  • string