Sync Agents - Create Or Update

Membuat atau memperbarui agen sinkronisasi.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/syncAgents/{syncAgentName}?api-version=2021-11-01

Parameter URI

Name In Required Type Description
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 tempat agen sinkronisasi dihosting.

subscriptionId
path True
  • string

ID langganan yang mengidentifikasi langganan Azure.

syncAgentName
path True
  • string

Nama agen sinkronisasi.

api-version
query True
  • string

Versi API yang digunakan untuk permintaan.

Isi Permintaan

Name Type Description
properties.syncDatabaseId
  • string

Id sumber daya ARM dari database sinkronisasi di agen sinkronisasi.

Respons

Name Type Description
200 OK

Berhasil memperbarui agen sinkronisasi.

201 Created

Berhasil membuat agen sinkronisasi.

202 Accepted

Membuat atau memperbarui agen 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 SyncOperation_WrongSyncDatabase - Database sinkronisasi yang ditentukan tidak cocok dengan yang sudah ada.

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

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

  • 400 CannotDeleteInUseSyncAgent - Tidak dapat menghapus agen sinkronisasi karena digunakan oleh anggota sinkronisasi.

  • 400 InvalidSyncAgent - Agen sinkronisasi tidak valid.

  • 400 InvalidSyncMetadataDatabase - Database metadata 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 OperationIdNotFound - Operasi dengan Id tidak ada.

  • 409 SyncOperation_AgentAlreadyExists - Agen sinkronisasi dengan nama yang sama sudah ada.

  • 409 SyncOperation_AgentIdAlreadyExists - Agen sinkronisasi dengan id 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 new sync agent
Update a sync agent

Create a new sync agent

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncagentcrud-65440/providers/Microsoft.Sql/servers/syncagentcrud-8475/syncAgents/syncagentcrud-3187?api-version=2021-11-01

{
  "properties": {
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-Onebox/providers/Microsoft.Sql/servers/syncagentcrud-8475/databases/sync"
  }
}

Sample Response

{
  "properties": {
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-Onebox/providers/Microsoft.Sql/servers/syncagentcrud-8475/databases/sync",
    "state": "NeverConnected",
    "isUpToDate": true,
    "expiryTime": "9999-12-31T23:59:59.9999999Z",
    "version": "4.2.0.0"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-Onebox/providers/Microsoft.Sql/servers/syncagentcrud-8475/syncAgents/syncagentcrud-3187",
  "name": "syncagent",
  "type": "Microsoft.Sql/servers/syncAgents"
}
{
  "properties": {
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-Onebox/providers/Microsoft.Sql/servers/syncagentcrud-8475/databases/sync",
    "state": "NeverConnected",
    "isUpToDate": true,
    "expiryTime": "9999-12-31T23:59:59.9999999Z",
    "version": "4.2.0.0"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-Onebox/providers/Microsoft.Sql/servers/syncagentcrud-8475/syncAgents/syncagentcrud-3187",
  "name": "syncagent",
  "type": "Microsoft.Sql/servers/syncAgents"
}

Update a sync agent

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncagentcrud-65440/providers/Microsoft.Sql/servers/syncagentcrud-8475/syncAgents/syncagentcrud-3187?api-version=2021-11-01

{
  "properties": {
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-Onebox/providers/Microsoft.Sql/servers/syncagentcrud-8475/databases/sync"
  }
}

Sample Response

{
  "properties": {
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-Onebox/providers/Microsoft.Sql/servers/syncagentcrud-8475/databases/sync",
    "state": "NeverConnected",
    "isUpToDate": true,
    "expiryTime": "9999-12-31T23:59:59.9999999Z",
    "version": "4.2.0.0"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-Onebox/providers/Microsoft.Sql/servers/syncagentcrud-8475/syncAgents/syncagentcrud-3187",
  "name": "syncagent",
  "type": "Microsoft.Sql/servers/syncAgents"
}
{
  "properties": {
    "syncDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-Onebox/providers/Microsoft.Sql/servers/syncagentcrud-8475/databases/sync",
    "state": "NeverConnected",
    "isUpToDate": true,
    "expiryTime": "9999-12-31T23:59:59.9999999Z",
    "version": "4.2.0.0"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-Onebox/providers/Microsoft.Sql/servers/syncagentcrud-8475/syncAgents/syncagentcrud-3187",
  "name": "syncagent",
  "type": "Microsoft.Sql/servers/syncAgents"
}

Definisi

SyncAgent

Agen sinkronisasi Azure SQL Database.

SyncAgentState

Status agen sinkronisasi.

SyncAgent

Agen sinkronisasi Azure SQL Database.

Name Type Description
id
  • string

ID Sumber Daya.

name
  • string

Nama sumber daya.

properties.expiryTime
  • string

Waktu kedaluwarsa versi agen sinkronisasi.

properties.isUpToDate
  • boolean

Jika versi agen sinkronisasi sudah diperbarui.

properties.lastAliveTime
  • string

Waktu hidup terakhir agen sinkronisasi.

properties.name
  • string

Nama agen sinkronisasi.

properties.state

Status agen sinkronisasi.

properties.syncDatabaseId
  • string

Id sumber daya ARM dari database sinkronisasi di agen sinkronisasi.

properties.version
  • string

Versi agen sinkronisasi.

type
  • string

Jenis sumber daya

SyncAgentState

Status agen sinkronisasi.

Name Type Description
NeverConnected
  • string
Offline
  • string
Online
  • string