Sync Groups - Create Or Update

Referensi

Service:: SQL Database

API Version:: 2021-11-01

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-11-01

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
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

Nama	Jenis	Deskripsi
properties.conflictLoggingRetentionInDays	integer	Periode retensi pengelogan konflik.
properties.conflictResolutionPolicy	SyncConflictResolutionPolicy	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	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	Berhasil memperbarui grup sinkronisasi.
201 Created	SyncGroup	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 MissingServerName - Nama Server hilang 400 MissingDatabaseName - Nama Database hilang 400 MissingSyncGroupName - Nama Grup Sinkronisasi hilang 400 MissingConflictResolutionPolicy - Kebijakan Resolusi Konflik hilang 400 MissingSyncAgentName - Nama Agen Sinkronisasi hilang 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. 404 OperationIdNotFound - Operasi dengan Id tidak ada. 409 SyncOperation_DuplicateSyncGroupName - Tidak dapat membuat grup sinkronisasi karena grup sinkronisasi dengan nama yang sama sudah ada. 409 OperationCancelled - Operasi telah dibatalkan oleh pengguna. 409 OperationInterrupted - Operasi pada sumber daya tidak dapat diselesaikan karena terganggu oleh operasi lain pada sumber daya yang sama. 429 SubscriptionTooManyCreateUpdateRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 429 SubscriptionTooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 500 OperationTimedOut - Waktu operasi habis dan secara otomatis digulung balik. Silakan coba lagi operasi ini. 503 TooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

Contoh

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=2021-11-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
  }
}


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.SyncGroupInner;
import com.azure.resourcemanager.sql.models.SyncConflictResolutionPolicy;

/** Samples for SyncGroups CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/SyncGroupCreate.json
     */
    /**
     * Sample code: Create a sync group.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createASyncGroup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSyncGroups().createOrUpdate("syncgroupcrud-65440",
            "syncgroupcrud-8475", "syncgroupcrud-4328", "syncgroupcrud-3187",
            new SyncGroupInner().withInterval(-1).withConflictResolutionPolicy(SyncConflictResolutionPolicy.HUB_WIN)
                .withSyncDatabaseId(
                    "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328")
                .withHubDatabaseUsername("hubUser").withUsePrivateLinkConnection(true),
            Context.NONE);
    }
}

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

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

HTTP
Java

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


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.SyncGroupInner;
import com.azure.resourcemanager.sql.models.SyncConflictResolutionPolicy;

/** Samples for SyncGroups CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/SyncGroupUpdate.json
     */
    /**
     * Sample code: Update a sync group.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateASyncGroup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSyncGroups().createOrUpdate("syncgroupcrud-65440",
            "syncgroupcrud-8475", "syncgroupcrud-4328", "syncgroupcrud-3187",
            new SyncGroupInner().withInterval(-1).withConflictResolutionPolicy(SyncConflictResolutionPolicy.HUB_WIN)
                .withSyncDatabaseId(
                    "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-3521/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328")
                .withHubDatabaseUsername("hubUser").withUsePrivateLinkConnection(true),
            Context.NONE);
    }
}

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

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

Nama	Deskripsi
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.

Nama	Jenis	Deskripsi
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.

Nama	Jenis	Deskripsi
HubWin	string
MemberWin	string

SyncGroup

Grup sinkronisasi Azure SQL Database.

Nama	Jenis	Deskripsi
id	string	ID Sumber Daya.
name	string	Nama sumber daya.
properties.conflictLoggingRetentionInDays	integer	Periode retensi pengelogan konflik.
properties.conflictResolutionPolicy	SyncConflictResolutionPolicy	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	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.
type	string	Jenis sumber daya

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.

Nama	Jenis	Deskripsi
Error	string
Good	string
NotReady	string
Progressing	string
Warning	string

Bagikan melalui

Sync Groups - Create Or Update

Parameter URI

Isi Permintaan

Respons

Contoh

Create a sync group

Sample Request

Sample Response

Update a sync group

Sample Request

Sample Response

Definisi

Sku

SyncConflictResolutionPolicy

SyncGroup

SyncGroupSchema

SyncGroupSchemaTable

SyncGroupSchemaTableColumn

SyncGroupState

Sumber Daya Tambahan: