Sync Agents - Create Or Update

  • Referencia
Service:
SQL Database
API Version:
2021-11-01

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 Kötelező Típus 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álni kívánt API-verzió.

Kérelem törzse

Name Típus 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 Típus Description
200 OK

SyncAgent

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

SyncAgent

A szinkronizálási ügynök létrehozása sikerült.
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ának vagy frissítésének kérelemtörzse üres.

  • 400 InvalidSyncMemberCreateOrUpdateRequest – A szinkronizálási tag kérésének létrehozása vagy frissítése törzse üres.

  • 400 InvalidSyncAgentCreateOrUpdateRequest – A szinkronizálási ügynök létrehozásának vagy frissítésének kérelemtörzse üres.

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

  • 400 MismatchingSubscriptionWithUrl – A megadott előfizetés nem egyezett meg 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 meg az URL-címben megadott névvel.

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

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

  • 400 MissingServerName – A kiszolgáló neve 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ó az adatszinkronizálásban.

  • 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 ugyanazon az erőforráson egy másik művelet megszakította.

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

  • 429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken 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érelmeken 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

Status code:
200 
{
  "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"
}
Status code:
201 
{
  "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"
}
Status code:
202

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

Status code:
200 
{
  "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"
}
Status code:
201 
{
  "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"
}
Status code:
202

Definíciók

Name Description
SyncAgent

Egy Azure SQL adatbázis-szinkronizálási ügynök.
SyncAgentState

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

SyncAgent

Egy Azure SQL adatbázis-szinkronizálási ügynök.

Name Típus 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

SyncAgentState

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 Típus Description
NeverConnected

string

Offline

string

Online

string