Sync Agents - Create Or Update

Szinkronizálási ügynököt hoz létre vagy frissít.

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

URI-paraméterek

Name In Required Type Description
resourceGroupName
path True
  • string

Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.

serverName
path True
  • string

Annak a kiszolgálónak a neve, amelyen a szinkronizálási ügynök üzemel.

subscriptionId
path True
  • string

Az Azure-előfizetést azonosító előfizetés-azonosító.

syncAgentName
path True
  • string

A szinkronizálási ügynök neve.

api-version
query True
  • string

A kéréshez használandó API-verzió.

Kérelem törzse

Name Type Description
properties.syncDatabaseId
  • string

A szinkronizálási adatbázis ARM-erőforrás-azonosítója a szinkronizálási ügynökben.

Válaszok

Name Type Description
200 OK

A szinkronizálási ügynök frissítése sikerült.

201 Created

A szinkronizálási ügynök létrehozása sikeresen megtörtént.

202 Accepted

A szinkronizálási ügynök létrehozása vagy frissítése folyamatban van.

Other Status Codes

Hibaválaszok: ***

  • 400 InvalidSyncGroupCreateOrUpdateRequest – A szinkronizálási csoport létrehozására vagy frissítésére vonatkozó kérelemtörzs üres.

  • 400 InvalidSyncMemberCreateOrUpdateRequest – A szinkronizálási tagkérelem létrehozása vagy frissítése üres.

  • 400 InvalidSyncAgentCreateOrUpdateRequest – A szinkronizálási ügynök létrehozására vagy frissítésére vonatkozó kérelemtörzs üres.

  • 400 InvalidDatabaseResourceId – Érvénytelen adatbázis-erőforrás-azonosító.

  • 400 MismatchingSubscriptionWithUrl – A megadott előfizetés nem egyezett az URL-címben szereplő előfizetéssel.

  • 400 InvalidSyncAgentResourceId – Érvénytelen szinkronizálási ügynök erőforrás-azonosítója.

  • 400 MismatchingResourceGroupNameWithUrl – A megadott erőforráscsoport neve nem egyezett az URL-címben megadott névvel.

  • 400 MismatchingServerNameWithUrl – A megadott kiszolgálónév nem egyezett az URL-címben megadott névvel.

  • 400 InvalidParameterValue – Érvénytelen értéket adott meg egy paraméter.

  • 400 MissingServerName – A kiszolgálónév hiányzik

  • 400 MissingDatabaseName – Az adatbázis neve hiányzik

  • 400 MissingSyncGroupName – A szinkronizálási csoport neve hiányzik

  • 400 MissingConflictResolutionPolicy – Az ütközésfeloldási szabályzat hiányzik

  • 400 MissingSyncAgentName – A szinkronizálási ügynök neve hiányzik

  • 400 SyncOperation_GenericFailure – Nem sikerült végrehajtani az adatszinkronizálási műveletet.

  • 400 SyncOperation_WrongSyncDatabase – A megadott szinkronizálási adatbázis nem egyezik a meglévő adatbázissal.

  • 400 SyncOperation_DwInSyncGroup – A datawarehouse kiadás nem használható adatszinkronizáláshoz.

  • 400 SyncOperation_MasterDbInSyncGroup – Nem használható logikai főkiszolgáló az adatszinkronizálásban.

  • 400 CannotDeleteInUseSyncAgent – A szinkronizálási ügynök nem törölhető, mert a szinkronizálási tag használja.

  • 400 InvalidSyncAgent – A szinkronizálási ügynök érvénytelen.

  • 400 InvalidSyncMetadataDatabase – A metaadat-adatbázis szinkronizálása érvénytelen.

  • 404 ResourceNotFound – A kért erőforrás nem található.

  • 404 SubscriptionDoesNotHaveServer – A kért kiszolgáló nem található

  • 404 DatabaseDoesNotExist – A felhasználó olyan adatbázisnevet adott meg, amely nem létezik ezen a kiszolgálópéldányon.

  • 404 OperationIdNotFound – Az azonosítóval rendelkező művelet nem létezik.

  • 409 SyncOperation_AgentAlreadyExists – Az azonos nevű szinkronizálási ügynök már létezik.

  • 409 SyncOperation_AgentIdAlreadyExists – Már létezik ugyanazzal az azonosítóval rendelkező szinkronizálási ügynök.

  • 409 OperationCancelled – A felhasználó megszakította a műveletet.

  • 409 OperationInterrupted – Az erőforráson végzett művelet nem hajtható végre, mert egy másik művelet megszakította ugyanazon az erőforráson.

  • 429 SubscriptionTooManyCreateUpdateRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések.

  • 429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések.

  • 500 OperationTimedOut – A művelet túllépte az időkorlátot, és automatikusan visszagördült. Please retry the operation.

  • 503 TooManyRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések.

Példák

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

Definíciók

SyncAgent

Egy Azure SQL Database szinkronizálási ügynök.

SyncAgentState

A szinkronizálási ügynök állapota.

SyncAgent

Egy Azure SQL Database szinkronizálási ügynök.

Name Type Description
id
  • string

Erőforrás-azonosító.

name
  • string

Erőforrás neve.

properties.expiryTime
  • string

A szinkronizálási ügynök verziójának lejárati ideje.

properties.isUpToDate
  • boolean

Ha a szinkronizálási ügynök verziója naprakész.

properties.lastAliveTime
  • string

A szinkronizálási ügynök utolsó életben töltött ideje.

properties.name
  • string

A szinkronizálási ügynök neve.

properties.state

A szinkronizálási ügynök állapota.

properties.syncDatabaseId
  • string

A szinkronizálási adatbázis ARM-erőforrás-azonosítója a szinkronizálási ügynökben.

properties.version
  • string

A szinkronizálási ügynök verziója.

type
  • string

Erőforrástípus.

SyncAgentState

A szinkronizálási ügynök állapota.

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