Sync Agents - Create Or Update

  • Odwołanie
Service:
SQL Database
API Version:
2022-02-01-preview

Tworzy lub aktualizuje agenta synchronizacji.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
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

Nazwa Typ Opis
properties.syncDatabaseId

string

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

Odpowiedzi

Nazwa Typ Opis
200 OK

SyncAgent

Pomyślnie zaktualizowano agenta synchronizacji.
201 Created

SyncAgent

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.

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

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

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=2022-02-01-preview

{
  "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=2022-02-01-preview

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

Definicje

Nazwa Opis
SyncAgent

Agent synchronizacji bazy danych Azure SQL.
SyncAgentState

Stan agenta synchronizacji.

SyncAgent

Agent synchronizacji bazy danych Azure SQL.

Nazwa Typ Opis
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

SyncAgentState

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.

Nazwa Typ Opis
NeverConnected

string

Offline

string

Online

string