Sync Groups - Create Or Update
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=2025-01-01
Parameter URI
| Nama | Dalam | Diperlukan | Jenis | Deskripsi |
|---|---|---|---|---|
|
database
|
path | True |
string |
Nama database. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil. |
|
server
|
path | True |
string |
Nama server. |
|
subscription
|
path | True |
string (uuid) |
ID langganan target. Nilainya harus sebuah UUID. |
|
sync
|
path | True |
string |
Nama grup sinkronisasi. |
|
api-version
|
query | True |
string minLength: 1 |
Versi API yang digunakan untuk operasi ini. |
Isi Permintaan
| Nama | Jenis | Deskripsi |
|---|---|---|
| properties.conflictLoggingRetentionInDays |
integer (int32) |
Periode retensi pengelogan konflik. |
| properties.conflictResolutionPolicy |
Kebijakan resolusi konflik grup sinkronisasi. |
|
| properties.enableConflictLogging |
boolean |
Jika pengelogan konflik diaktifkan. |
| properties.hubDatabasePassword |
string (password) |
Kata sandi untuk kredensial database hub grup sinkronisasi. |
| properties.hubDatabaseUserName |
string |
Nama pengguna untuk kredensial database hub grup sinkronisasi. |
| properties.interval |
integer (int32) |
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
| Nama | Jenis | Deskripsi |
|---|---|---|
| 200 OK |
Operasi pembaruan 'SyncGroup' sumber daya berhasil |
|
| 201 Created |
Operasi pembuatan 'SyncGroup' sumber daya berhasil Header
|
|
| 202 Accepted |
Operasi sumber daya diterima. Header
|
|
| Other Status Codes |
Respons kesalahan tak terduga. |
Keamanan
azure_auth
Alur OAuth2 Azure Active Directory.
Jenis:
oauth2
Alur:
implicit
URL Otorisasi:
https://login.microsoftonline.com/common/oauth2/authorize
Cakupan
| Nama | Deskripsi |
|---|---|
| user_impersonation | meniru akun pengguna Anda |
Contoh
| Create a sync group |
| Update a sync group |
Create a sync group
Permintaan sampel
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=2025-01-01
{
"properties": {
"conflictResolutionPolicy": "HubWin",
"hubDatabaseUserName": "hubUser",
"interval": -1,
"syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
"usePrivateLinkConnection": true
}
}
Respon sampel
{
"name": "syncgroupcrud-3187",
"type": "Microsoft.Sql/servers/databases/syncGroups",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187",
"properties": {
"conflictResolutionPolicy": "HubWin",
"hubDatabaseUserName": "hubUser",
"interval": -1,
"lastSyncTime": "0001-01-01T08:00:00Z",
"privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncgroupcrud-8475",
"syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
"syncState": "NotReady",
"usePrivateLinkConnection": true
}
}
{
"name": "syncgroupcrud-3187",
"type": "Microsoft.Sql/servers/databases/syncGroups",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187",
"properties": {
"conflictResolutionPolicy": "HubWin",
"hubDatabaseUserName": "hubUser",
"interval": -1,
"lastSyncTime": "0001-01-01T08:00:00Z",
"privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncgroupcrud-8475",
"syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
"syncState": "NotReady",
"usePrivateLinkConnection": true
}
}
Update a sync group
Permintaan sampel
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=2025-01-01
{
"properties": {
"conflictResolutionPolicy": "HubWin",
"hubDatabaseUserName": "hubUser",
"interval": -1,
"syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
"usePrivateLinkConnection": true
}
}
Respon sampel
{
"name": "syncgroupcrud-3187",
"type": "Microsoft.Sql/servers/databases/syncGroups",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187",
"properties": {
"conflictResolutionPolicy": "HubWin",
"hubDatabaseUserName": "hubUser",
"interval": -1,
"lastSyncTime": "0001-01-01T08:00:00Z",
"privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncgroupcrud-3187",
"syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
"syncState": "NotReady",
"usePrivateLinkConnection": true
}
}
{
"name": "syncgroupcrud-3187",
"type": "Microsoft.Sql/servers/databases/syncGroups",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187",
"properties": {
"conflictResolutionPolicy": "HubWin",
"hubDatabaseUserName": "hubUser",
"interval": -1,
"lastSyncTime": "0001-01-01T08:00:00Z",
"privateEndpointName": "PE_67FDBBD6-B2D8-4014-9CC6-C68ABBCFD481_syncgroupcrud-3187",
"syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328",
"syncState": "NotReady",
"usePrivateLinkConnection": true
}
}
Definisi
| Nama | Deskripsi |
|---|---|
|
created |
Jenis identitas yang membuat sumber daya. |
|
Error |
Info tambahan kesalahan manajemen sumber daya. |
|
Error |
Detail kesalahan. |
|
Error |
Tanggapan kesalahan |
| Sku |
SKU Sumber Daya ARM. |
|
Sync |
Kebijakan resolusi konflik grup sinkronisasi. |
|
Sync |
Grup sinkronisasi Azure SQL Database. |
|
Sync |
Properti skema grup sinkronisasi. |
|
Sync |
Properti tabel dalam skema grup sinkronisasi. |
|
Sync |
Properti kolom dalam tabel grup sinkronisasi. |
|
Sync |
Status sinkronisasi grup sinkronisasi. |
|
system |
Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya. |
createdByType
Jenis identitas yang membuat sumber daya.
| Nilai | Deskripsi |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Info tambahan kesalahan manajemen sumber daya.
| Nama | Jenis | Deskripsi |
|---|---|---|
| info |
object |
Info tambahan. |
| type |
string |
Jenis info tambahan. |
ErrorDetail
Detail kesalahan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| additionalInfo |
Info tambahan kesalahan. |
|
| code |
string |
Kode kesalahan. |
| details |
Rincian kesalahan. |
|
| message |
string |
Pesan kesalahan. |
| target |
string |
Sasaran kesalahan. |
ErrorResponse
Tanggapan kesalahan
| Nama | Jenis | Deskripsi |
|---|---|---|
| error |
Objek kesalahan. |
Sku
SKU Sumber Daya ARM.
| Nama | Jenis | Deskripsi |
|---|---|---|
| capacity |
integer (int32) |
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 grup sinkronisasi.
| Nilai | Deskripsi |
|---|---|
| HubWin |
HubWin |
| MemberWin |
MemberWin |
SyncGroup
Grup sinkronisasi Azure SQL Database.
| Nama | Jenis | Deskripsi |
|---|---|---|
| id |
string (arm-id) |
ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Nama sumber daya |
| properties.conflictLoggingRetentionInDays |
integer (int32) |
Periode retensi pengelogan konflik. |
| properties.conflictResolutionPolicy |
Kebijakan resolusi konflik grup sinkronisasi. |
|
| properties.enableConflictLogging |
boolean |
Jika pengelogan konflik diaktifkan. |
| properties.hubDatabasePassword |
string (password) |
Kata sandi untuk kredensial database hub grup sinkronisasi. |
| properties.hubDatabaseUserName |
string |
Nama pengguna untuk kredensial database hub grup sinkronisasi. |
| properties.interval |
integer (int32) |
Interval sinkronisasi grup sinkronisasi. |
| properties.lastSyncTime |
string (date-time) |
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. |
|
| systemData |
Metadata Azure Resource Manager yang berisi informasi createdBy dan modifiedBy. |
|
| type |
string |
Jenis sumber daya. Misalnya "Microsoft. Komputasi/virtualMachines" atau "Microsoft. Akun penyimpanan/penyimpanan" |
SyncGroupSchema
Properti skema grup sinkronisasi.
| Nama | Jenis | Deskripsi |
|---|---|---|
| masterSyncMemberName |
string |
Nama anggota sinkronisasi master tempat skema berasal. |
| tables |
Daftar tabel dalam skema grup sinkronisasi. |
SyncGroupSchemaTable
Properti tabel dalam skema grup sinkronisasi.
| Nama | Jenis | Deskripsi |
|---|---|---|
| columns |
Daftar kolom dalam skema grup sinkronisasi. |
|
| quotedName |
string |
Nama tabel skema grup sinkronisasi yang dikutip. |
SyncGroupSchemaTableColumn
Properti kolom dalam tabel grup sinkronisasi.
| Nama | Jenis | Deskripsi |
|---|---|---|
| dataSize |
string |
Ukuran data kolom. |
| dataType |
string |
Jenis data kolom. |
| quotedName |
string |
Nama kolom tabel grup sinkronisasi yang dikutip. |
SyncGroupState
Status sinkronisasi grup sinkronisasi.
| Nilai | Deskripsi |
|---|---|
| NotReady |
Tidak Siap |
| Error |
Kesalahan |
| Warning |
Peringatan |
| Progressing |
Berkembang |
| Good |
Bagus |
systemData
Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
| Nama | Jenis | Deskripsi |
|---|---|---|
| createdAt |
string (date-time) |
Tanda waktu pembuatan sumber daya (UTC). |
| createdBy |
string |
Identitas yang membuat sumber daya. |
| createdByType |
Jenis identitas yang membuat sumber daya. |
|
| lastModifiedAt |
string (date-time) |
Stempel waktu modifikasi terakhir sumber daya (UTC) |
| lastModifiedBy |
string |
Identitas yang terakhir mengubah sumber daya. |
| lastModifiedByType |
Jenis identitas yang terakhir memodifikasi sumber daya. |