Condividi tramite


Sync Groups - Trigger Sync

Attiva una sincronizzazione dei gruppi di sincronizzazione.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/syncGroups/{syncGroupName}/triggerSync?api-version=2023-08-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
databaseName
path True

string

Nome del database in cui è ospitato il gruppo di sincronizzazione.

resourceGroupName
path True

string

Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale.

serverName
path True

string

Nome del server.

subscriptionId
path True

string

ID sottoscrizione che identifica una sottoscrizione di Azure.

syncGroupName
path True

string

Nome del gruppo di sincronizzazione.

api-version
query True

string

Versione dell'API da usare per la richiesta.

Risposte

Nome Tipo Descrizione
200 OK

È stata attivata correttamente una sincronizzazione del gruppo di sincronizzazione.

Other Status Codes

ErrorResponse

Risposte di errore:

  • 400 InvalidSyncGroupCreateOrUpdateRequest: il corpo della richiesta del gruppo di sincronizzazione di creazione o aggiornamento è vuoto.

  • 400 InvalidSyncMemberCreateOrUpdateRequest- Il corpo della richiesta del membro di sincronizzazione di creazione o aggiornamento è vuoto.

  • 400 InvalidSyncAgentCreateOrUpdateRequest: il corpo della richiesta dell'agente di sincronizzazione di creazione o aggiornamento è vuoto.

  • 400 InvalidDatabaseResourceId - Identificatore di risorsa di database non valido.

  • 400 InvalidSyncGroupName - Il nome del gruppo di sincronizzazione non è valido. Questo campo può contenere lettere, numeri, trattini e caratteri di sottolineatura.

  • 400 InvalidSyncMemberName- Il nome del membro di sincronizzazione non è valido. Questo campo può contenere lettere, numeri, trattini e caratteri di sottolineatura.

  • 400 MissingSyncMemberName - Manca il nome del membro di sincronizzazione

  • 400 InvalidSyncGroupInterval: l'intervallo di sincronizzazione deve essere maggiore o uguale a 5 secondi.

  • 400 Mancata corrispondenzaSubscriptionWithUrl: la sottoscrizione specificata non corrisponde alla sottoscrizione nell'URL.

  • 400 InvalidSyncAgentResourceId - Identificatore di risorsa dell'agente di sincronizzazione non valido.

  • 400 Mancata corrispondenzaResourceGroupNameWithUrl- Il nome del gruppo di risorse specificato non corrisponde al nome nell'URL.

  • 400 MismatchingServerNameWithUrl: il nome del server specificato non corrisponde al nome nell'URL.

  • 400 InvalidParameterValue- È stato assegnato un valore non valido a un parametro.

  • 400 MissingServerName - Manca il nome del server

  • 400 MissingDatabaseName - Nome database mancante

  • 400 MissingSyncGroupName - Manca il nome del gruppo di sincronizzazione

  • 400 MissingConflictResolutionPolicy - Manca il criterio di risoluzione dei conflitti

  • 400 MissingSyncAgentName - Manca il nome dell'agente di sincronizzazione

  • 400 SyncOperation_GenericFailure - Impossibile eseguire l'operazione di sincronizzazione dei dati.

  • 400 InvalidSyncGroup - Il gruppo di sincronizzazione non è valido.

  • 400 FeatureDisabledOnSelectedEdition : l'utente ha tentato di usare una funzionalità disabilitata nell'edizione del database corrente.

  • 400 CannotCreateSyncGroupDueToQuotaExceeded - Impossibile creare un gruppo di sincronizzazione a causa del superamento della quota.

  • 400 SyncOperation_DuplicateSyncGroupDrop : il gruppo di sincronizzazione è già stato eliminato.

  • 400 SyncOperation_WrongSyncDatabase: il database di sincronizzazione specificato non corrisponde a quello esistente.

  • 400 SyncOperation_UpdateSyncGroupWhenDropping - Impossibile aggiornare il gruppo di sincronizzazione perché è in corso l'eliminazione.

  • 400 SyncOperation_DwInSyncGroup - Non è possibile usare l'edizione datawarehouse nella sincronizzazione dati.

  • 400 SyncOperation_MasterDbInSyncGroup : non è possibile usare il master logico nella sincronizzazione dati.

  • 400 SyncOperation_UnsupportedDataTypeColumnInSchema - Impossibile aggiungere colonna allo schema perché il tipo di dati della colonna non è supportato.

  • 400 SyncOperation_InvalidCredential: le credenziali del database non sono valide.

  • 400 InvalidSyncMetadataDatabase - Il database dei metadati di sincronizzazione non è valido.

  • 400 SyncOperation_InvalidSyncInterval - Impossibile creare o aggiornare il gruppo di sincronizzazione perché l'intervallo di sincronizzazione non è valido.

  • 404 ResourceNotFound: la risorsa richiesta non è stata trovata.

  • 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato

  • 404 DatabaseDoesNotExist: l'utente ha specificato un nome di database che non esiste in questa istanza del server.

  • 404 SyncOperation_HubServerNotFound - Il server logico hub non esiste.

  • 404 SyncOperation_InvalidHubDatabase - Database hub non valido.

  • 404 OperationIdNotFound - L'operazione con ID non esiste.

  • 409 SyncOperation_DuplicateSyncGroupName - Impossibile creare un gruppo di sincronizzazione perché il gruppo di sincronizzazione con lo stesso nome esiste già.

  • 409 CannotCancelOperation: l'operazione di gestione si trova in uno stato che non può essere annullato.

  • 409 OperationCancelled - L'operazione è stata annullata dall'utente.

  • 409 OperationInterrupted - Impossibile completare l'operazione sulla risorsa perché è stata interrotta da un'altra operazione sulla stessa risorsa.

  • 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 500 OperationTimedOut: timeout dell'operazione e rollback automatico. Ripetere l'operazione.

  • 503 TooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

Esempio

Trigger a sync group synchronization.

Esempio di richiesta

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187/triggerSync?api-version=2023-08-01

Risposta di esempio

Definizioni

Nome Descrizione
ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.