Sync Agents - Create Or Update

Erstellt oder aktualisiert einen Synchronisierungs-Agent.

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

URI-Parameter

Name In Required Type Description
resourceGroupName
path True
  • string

Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.

serverName
path True
  • string

Der Name des Servers, auf dem der Synchronisierungs-Agent gehostet wird.

subscriptionId
path True
  • string

Abonnement-ID für ein Azure-Abonnement.

syncAgentName
path True
  • string

Der Name des Synchronisierungs-Agents.

api-version
query True
  • string

API-Version, die für die Anforderung verwendet werden soll.

Anforderungstext

Name Type Description
properties.syncDatabaseId
  • string

ARM-Ressourcen-ID der Synchronisierungsdatenbank im Synchronisierungs-Agent.

Antworten

Name Type Description
200 OK

Der Synchronisierungs-Agent wurde erfolgreich aktualisiert.

201 Created

Der Synchronisierungs-Agent wurde erfolgreich erstellt.

202 Accepted

Das Erstellen oder Aktualisieren des Synchronisierungs-Agents wird ausgeführt.

Other Status Codes

Fehlerantworten: ***

  • 400 InvalidSyncGroupCreateOrUpdateRequest – Der Text der Create- oder Update-Synchronisierungsgruppenanforderung ist leer.

  • 400 InvalidSyncMemberCreateOrUpdateRequest – Der Textkörper für das Erstellen oder Aktualisieren der Synchronisierungsmitgliedsanforderung ist leer.

  • 400 InvalidSyncAgentCreateOrUpdateRequest – Der Anforderungstext des Create- oder Update-Synchronisierungs-Agents ist leer.

  • 400 InvalidDatabaseResourceId – Ungültiger Datenbankressourcenbezeichner.

  • 400 MismatchingSubscriptionWithUrl – Das bereitgestellte Abonnement stimmte nicht mit dem Abonnement in der URL überein.

  • 400 InvalidSyncAgentResourceId – Ungültiger Synchronisierungs-Agent-Ressourcenbezeichner.

  • 400 MismatchingResourceGroupNameWithUrl – Der angegebene Ressourcengruppenname stimmt nicht mit dem Namen in der URL überein.

  • 400 MismatchingServerNameWithUrl – Der angegebene Servername stimmt nicht mit dem Namen in der URL überein.

  • 400 InvalidParameterValue – Ein ungültiger Wert wurde einem Parameter zugewiesen.

  • 400 MissingServerName – Der Servername fehlt

  • 400 MissingDatabaseName – Der Datenbankname fehlt

  • 400 MissingSyncGroupName – Der Name der Synchronisierungsgruppe fehlt

  • 400 MissingConflictResolutionPolicy – Die Konfliktauflösungsrichtlinie fehlt

  • 400 MissingSyncAgentName – Der Name des Synchronisierungs-Agents fehlt

  • 400 SyncOperation_GenericFailure – Fehler beim Ausführen des Datensynchronisierungsvorgangs.

  • 400 SyncOperation_WrongSyncDatabase – Die angegebene Synchronisierungsdatenbank stimmt nicht mit dem vorhandenen überein.

  • 400 SyncOperation_DwInSyncGroup – Datawarehouse Edition kann nicht in der Datensynchronisierung verwendet werden.

  • 400 SyncOperation_MasterDbInSyncGroup – Logisches Master-Master-Objekt kann nicht in der Datensynchronisierung verwendet werden.

  • 400 CannotDeleteInUseSyncAgent – Der Synchronisierungs-Agent kann nicht gelöscht werden, da er vom Synchronisierungsmitglied verwendet wird.

  • 400 InvalidSyncAgent – Synchronisierungs-Agent ist ungültig.

  • 400 InvalidSyncMetadatabase – Synchronisierungsmetadatendatenbank ist ungültig.

  • 404 ResourceNotFound – Die angeforderte Ressource wurde nicht gefunden.

  • 404 SubscriptionDoesNotHaveServer – Der angeforderte Server wurde nicht gefunden.

  • 404 DatabaseDoesNotExist – Der Benutzer hat einen Datenbanknamen angegeben, der in dieser Serverinstanz nicht vorhanden ist.

  • 404 OperationIdNotFound – Der Vorgang mit der ID ist nicht vorhanden.

  • 409 SyncOperation_AgentAlreadyExists – Der Synchronisierungs-Agent mit demselben Namen ist bereits vorhanden.

  • 409 SyncOperation_AgentIdAlreadyExists – Der Synchronisierungs-Agent mit derselben ID ist bereits vorhanden.

  • 409 OperationCancelled – Der Vorgang wurde vom Benutzer abgebrochen.

  • 409 OperationInterrupted – Der Vorgang auf der Ressource konnte nicht abgeschlossen werden, weil es durch einen anderen Vorgang in derselben Ressource unterbrochen wurde.

  • 429 SubscriptionTooManyCreateUpdateRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.

  • 429 SubscriptionTooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.

  • 500 OperationTimedOut – Der Timeout-Vorgang und wird automatisch zurückgesetzt. Wiederholen Sie den Vorgang.

  • 503 TooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.

Beispiele

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

Definitionen

SyncAgent

Ein Azure SQL Datenbanksynchronisierungs-Agent.

SyncAgentState

Status des Synchronisierungs-Agents.

SyncAgent

Ein Azure SQL Datenbanksynchronisierungs-Agent.

Name Type Description
id
  • string

Ressourcen-ID

name
  • string

Name der Ressource.

properties.expiryTime
  • string

Ablaufzeit der Synchronisierungs-Agent-Version.

properties.isUpToDate
  • boolean

Wenn die Synchronisierungs-Agent-Version auf dem neuesten Stand ist.

properties.lastAliveTime
  • string

Letzte Lebendigkeit des Synchronisierungs-Agents.

properties.name
  • string

Name des Synchronisierungs-Agents.

properties.state

Status des Synchronisierungs-Agents.

properties.syncDatabaseId
  • string

ARM-Ressourcen-ID der Synchronisierungsdatenbank im Synchronisierungs-Agent.

properties.version
  • string

Version des Synchronisierungs-Agents.

type
  • string

Der Ressourcentyp.

SyncAgentState

Status des Synchronisierungs-Agents.

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