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
databaseName
path True

string

Nama database.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.

serverName
path True

string

Nama server.

subscriptionId
path True

string (uuid)

ID langganan target. Nilainya harus sebuah UUID.

syncGroupName
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

SyncConflictResolutionPolicy

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

SyncGroupSchema

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

Sku

Nama dan kapasitas SKU.

Respons

Nama Jenis Deskripsi
200 OK

SyncGroup

Operasi pembaruan 'SyncGroup' sumber daya berhasil

201 Created

SyncGroup

Operasi pembuatan 'SyncGroup' sumber daya berhasil

Header

  • Location: string
  • Retry-After: integer
202 Accepted

Operasi sumber daya diterima.

Header

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

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
createdByType

Jenis identitas yang membuat sumber daya.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

ErrorDetail

Detail kesalahan.

ErrorResponse

Tanggapan kesalahan

Sku

SKU Sumber Daya ARM.

SyncConflictResolutionPolicy

Kebijakan resolusi konflik 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.

systemData

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

ErrorAdditionalInfo[]

Info tambahan kesalahan.

code

string

Kode kesalahan.

details

ErrorDetail[]

Rincian kesalahan.

message

string

Pesan kesalahan.

target

string

Sasaran kesalahan.

ErrorResponse

Tanggapan kesalahan

Nama Jenis Deskripsi
error

ErrorDetail

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

SyncConflictResolutionPolicy

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

SyncGroupSchema

Sinkronkan skema grup sinkronisasi.

properties.syncDatabaseId

string

Id sumber daya ARM dari database sinkronisasi dalam grup sinkronisasi.

properties.syncState

SyncGroupState

Status sinkronisasi grup sinkronisasi.

properties.usePrivateLinkConnection

boolean

Jika menggunakan koneksi tautan privat diaktifkan.

sku

Sku

Nama dan kapasitas SKU.

systemData

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

SyncGroupSchemaTable[]

Daftar tabel dalam skema grup sinkronisasi.

SyncGroupSchemaTable

Properti tabel dalam skema grup sinkronisasi.

Nama Jenis Deskripsi
columns

SyncGroupSchemaTableColumn[]

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

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

createdByType

Jenis identitas yang terakhir memodifikasi sumber daya.