Partilhar via

Sync Groups - Trigger Sync

Serviço:
SQL Database
Versão API:
2023-08-01

Aciona uma sincronização de grupo de sincronização.

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

Parâmetros URI

Nome Em Necessário Tipo Descrição
databaseName
 path True

string

O nome do banco de dados no qual o grupo de sincronização está hospedado.
resourceGroupName
 path True

string

O nome do grupo de recursos que contém o recurso. Você pode obter esse valor da API do Azure Resource Manager ou do portal.
serverName
 path True

string

O nome do servidor.
subscriptionId
 path True

string

A ID de assinatura que identifica uma assinatura do Azure.
syncGroupName
 path True

string

O nome do grupo de sincronização.
api-version
 query True

string

A versão da API a ser usada para a solicitação.

Respostas

Nome Tipo Descrição
200 OK

Acionada com êxito uma sincronização de grupo de sincronização.
Other Status Codes

ErrorResponse

Respostas de erro: ***

  • 400 InvalidSyncGroupCreateOrUpdateRequest - O corpo da solicitação de grupo de sincronização de criação ou atualização está vazio.

  • 400 InvalidSyncMemberCreateOrUpdateRequest - O corpo da solicitação de membro de sincronização de criação ou atualização está vazio.

  • 400 InvalidSyncAgentCreateOrUpdateRequest - O corpo da solicitação do agente de sincronização de criação ou atualização está vazio.

  • 400 InvalidDatabaseResourceId - Identificador de recurso de banco de dados inválido.

  • 400 InvalidSyncGroupName - O nome do grupo de sincronização é inválido. Este campo pode conter letras, números, traços e sublinhados.

  • 400 InvalidSyncMemberName - O nome do membro de sincronização é inválido. Este campo pode conter letras, números, traços e sublinhados.

  • 400 MissingSyncMemberName - O nome do membro de sincronização está ausente

  • 400 InvalidSyncGroupInterval - O intervalo de sincronização deve ser maior ou igual a 5 segundos.

  • 400 MismatchingSubscriptionWithUrl - A assinatura fornecida não correspondeu à assinatura na Url.

  • 400 InvalidSyncAgentResourceId - Identificador de recurso do agente de sincronização inválido.

  • 400 MismatchingResourceGroupNameWithUrl - O nome do grupo de recursos fornecido não correspondia ao nome na Url.

  • 400 MismatchingServerNameWithUrl - O nome do servidor fornecido não correspondeu ao nome na Url.

  • 400 InvalidParameterValue - Um valor inválido foi dado a um parâmetro.

  • 400 MissingServerName - O nome do servidor está faltando

  • 400 MissingDatabaseName - O nome do banco de dados está faltando

  • 400 MissingSyncGroupName - O nome do grupo de sincronização está ausente

  • 400 MissingConflictResolutionPolicy - A Política de Resolução de Conflitos está ausente

  • 400 MissingSyncAgentName - O nome do agente de sincronização está ausente

  • 400 SyncOperation_GenericFailure - Falha ao executar a operação de sincronização de dados.

  • 400 InvalidSyncGroup - O grupo de sincronização é inválido.

  • 400 FeatureDisabledOnSelectedEdition - O usuário tentou usar um recurso que está desabilitado na edição atual do banco de dados.

  • 400 CannotCreateSyncGroupDueToQuotaExceeded - Não é possível criar grupo de sincronização devido à quota excedida.

  • 400 SyncOperation_DuplicateSyncGroupDrop - O grupo de sincronização já está sendo descartado.

  • 400 SyncOperation_WrongSyncDatabase - O banco de dados de sincronização especificado não corresponde ao existente.

  • 400 SyncOperation_UpdateSyncGroupWhenDropping - Não é possível atualizar o grupo de sincronização porque ele está sendo descartado no momento.

  • 400 SyncOperation_DwInSyncGroup - Não é possível usar a edição do datawarehouse na sincronização de dados.

  • 400 SyncOperation_MasterDbInSyncGroup - Não é possível usar o mestre lógico na sincronização de dados.

  • 400 SyncOperation_UnsupportedDataTypeColumnInSchema - Não é possível adicionar coluna ao esquema porque o tipo de dados da coluna não é suportado.

  • 400 SyncOperation_InvalidCredential - A credencial do banco de dados é inválida.

  • 400 InvalidSyncMetadataDatabase - O banco de dados de metadados de sincronização é inválido.

  • 400 SyncOperation_InvalidSyncInterval - Não é possível criar ou atualizar o grupo de sincronização porque o intervalo de sincronização é inválido.

  • 404 ResourceNotFound - O recurso solicitado não foi encontrado.

  • 404 SubscriptionDoesNotHaveServer - O servidor solicitado não foi encontrado

  • 404 DatabaseDoesNotExist - O usuário especificou um nome de banco de dados que não existe nesta instância do servidor.

  • 404 SyncOperation_HubServerNotFound - O servidor lógico do hub não existe.

  • 404 SyncOperation_InvalidHubDatabase - O banco de dados do hub é inválido.

  • 404 OperationIdNotFound - A operação com Id não existe.

  • 409 SyncOperation_DuplicateSyncGroupName - Não é possível criar grupo de sincronização porque o grupo de sincronização com o mesmo nome já existe.

  • 409 CannotCancelOperation - A operação de gerenciamento está em um estado que não pode ser cancelado.

  • 409 OperationCancelled - A operação foi cancelada pelo usuário.

  • 409 OperationInterrupted - A operação no recurso não pôde ser concluída porque foi interrompida por outra operação no mesmo recurso.

  • 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

  • 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

  • 500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Por favor, tente novamente a operação.

  • 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

Exemplos

Trigger a sync group synchronization.

Pedido de exemplo

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

Resposta de exemplo

Código de estado:
200

Definições

Nome Descrição
ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.
ErrorDetail

O detalhe do erro.
ErrorResponse

Resposta de erro

ErrorAdditionalInfo

Objetivo

O erro de gerenciamento de recursos informações adicionais.

Nome Tipo Descrição
info

object

As informações adicionais.
type

string

O tipo de informação adicional.

ErrorDetail

Objetivo

O detalhe do erro.

Nome Tipo Descrição
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.
code

string

O código de erro.
details

ErrorDetail[]

Os detalhes do erro.
message

string

A mensagem de erro.
target

string

O destino do erro.

ErrorResponse

Objetivo

Resposta de erro

Nome Tipo Descrição
error

ErrorDetail

O objeto de erro.