Sync Agents - Create Or Update

Tworzy lub aktualizuje agenta synchronizacji.

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

Parametry identyfikatora URI

Name In Required Type Description
resourceGroupName
path True
  • string

Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API Resource Manager platformy Azure lub portalu.

serverName
path True
  • string

Nazwa serwera, na którym jest hostowany agent synchronizacji.

subscriptionId
path True
  • string

Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.

syncAgentName
path True
  • string

Nazwa agenta synchronizacji.

api-version
query True
  • string

Wersja interfejsu API do użycia dla żądania.

Treść żądania

Name Type Description
properties.syncDatabaseId
  • string

Identyfikator zasobu usługi ARM bazy danych synchronizacji w agencie synchronizacji.

Odpowiedzi

Name Type Description
200 OK

Pomyślnie zaktualizowano agenta synchronizacji.

201 Created

Pomyślnie utworzono agenta synchronizacji.

202 Accepted

Trwa tworzenie lub aktualizowanie agenta synchronizacji.

Other Status Codes

Odpowiedzi na błędy: ***

  • 400 InvalidSyncGroupCreateOrUpdateRequest — treść żądania grupy synchronizacji tworzenia lub aktualizowania jest pusta.

  • 400 InvalidSyncMemberCreateOrUpdateRequest — treść żądania elementu członkowskiego synchronizacji tworzenia lub aktualizacji jest pusta.

  • 400 InvalidSyncAgentCreateOrUpdateRequest — treść żądania agenta synchronizacji tworzenia lub aktualizacji jest pusta.

  • 400 InvalidDatabaseResourceId — nieprawidłowy identyfikator zasobu bazy danych.

  • 400 NiezgodnośćSubscriptionWithUrl — podana subskrypcja nie jest zgodna z subskrypcją w adresie URL.

  • 400 InvalidSyncAgentResourceId — nieprawidłowy identyfikator zasobu agenta synchronizacji.

  • 400 MismatchingResourceGroupNameWithUrl — podana nazwa grupy zasobów nie jest zgodna z nazwą w adresie URL.

  • 400 NiezgodnośćServerNameWithUrl — podana nazwa serwera nie jest zgodna z nazwą w adresie URL.

  • 400 InvalidParameterValue — nieprawidłowa wartość została nadana parametrowi.

  • 400 MissingServerName — brak nazwy serwera

  • 400 MissingDatabaseName — brak nazwy bazy danych

  • 400 MissingSyncGroupName — brak nazwy grupy synchronizacji

  • 400 MissingConflictResolutionPolicy — brakuje zasad rozwiązywania konfliktów

  • 400 MissingSyncAgentName — brak nazwy agenta synchronizacji

  • 400 SyncOperation_GenericFailure — nie można wykonać operacji synchronizacji danych.

  • 400 SyncOperation_WrongSyncDatabase — określona baza danych synchronizacji nie jest zgodna z istniejącą.

  • 400 SyncOperation_DwInSyncGroup — nie można używać wersji magazynu danych w synchronizacji danych.

  • 400 SyncOperation_MasterDbInSyncGroup — nie można użyć logicznego wzorca w synchronizacji danych.

  • 400 CannotDeleteInUseSyncAgent — nie można usunąć agenta synchronizacji, ponieważ jest on używany przez element członkowski synchronizacji.

  • 400 InvalidSyncAgent — agent synchronizacji jest nieprawidłowy.

  • 400 InvalidSyncMetadataDatabase — baza danych metadanych synchronizacji jest nieprawidłowa.

  • 404 ResourceNotFound — żądany zasób nie został znaleziony.

  • 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera

  • 404 DatabaseDoesNotExist — użytkownik określił nazwę bazy danych, która nie istnieje w tym wystąpieniu serwera.

  • 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje.

  • 409 SyncOperation_AgentAlreadyExists — agent synchronizacji o tej samej nazwie już istnieje.

  • 409 SyncOperation_AgentIdAlreadyExists — agent synchronizacji o tym samym identyfikatorze już istnieje.

  • 409 OperationCancelled — operacja została anulowana przez użytkownika.

  • 409 OperationInterrupted — nie można ukończyć operacji na zasobie, ponieważ została przerwana przez inną operację na tym samym zasobie.

  • 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 500 OperationTimedOut — upłynął limit czasu operacji i został automatycznie wycofany. Ponów próbę wykonania operacji.

  • 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

Przykłady

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

Definicje

SyncAgent

Agent synchronizacji bazy danych Azure SQL.

SyncAgentState

Stan agenta synchronizacji.

SyncAgent

Agent synchronizacji bazy danych Azure SQL.

Name Type Description
id
  • string

Identyfikator zasobu.

name
  • string

Nazwa zasobu.

properties.expiryTime
  • string

Czas wygaśnięcia wersji agenta synchronizacji.

properties.isUpToDate
  • boolean

Jeśli wersja agenta synchronizacji jest aktualna.

properties.lastAliveTime
  • string

Czas ostatniego życia agenta synchronizacji.

properties.name
  • string

Nazwa agenta synchronizacji.

properties.state

Stan agenta synchronizacji.

properties.syncDatabaseId
  • string

Identyfikator zasobu usługi ARM bazy danych synchronizacji w agencie synchronizacji.

properties.version
  • string

Wersja agenta synchronizacji.

type
  • string

Typ zasobu.

SyncAgentState

Stan agenta synchronizacji.

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