Partilhar via

Sync Agents - Get

  • Referência
Serviço:
SQL Database
Versão da API:
2021-11-01

Obtém um agente de sincronização.

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

Parâmetros do URI

Name Em Necessário Tipo Description
resourceGroupName
 path True

string

O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.
serverName
 path True

string

O nome do servidor no qual o agente de sincronização está alojado.
subscriptionId
 path True

string

O ID da subscrição que identifica uma subscrição do Azure.
syncAgentName
 path True

string

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

string

A versão da API a utilizar para o pedido.

Respostas

Name Tipo Description
200 OK

SyncAgent

O agente de sincronização especificado foi obtido com êxito.
Other Status Codes

Respostas de Erro: ***

  • 400 InvalidSyncGroupCreateOrUpdateRequest – o corpo do pedido do grupo de sincronização de criação ou atualização está vazio.

  • 400 InvalidSyncMemberCreateOrUpdateRequest – o corpo do pedido do membro da sincronização de criação ou atualização está vazio.

  • 400 InvalidSyncAgentCreateOrUpdateRequest – o corpo do pedido do agente de sincronização de criação ou atualização está vazio.

  • 400 InvalidDatabaseResourceId – identificador de recurso de base de dados inválido.

  • 400 MismatchingSubscriptionWithUrl – a subscrição fornecida não correspondeu à subscrição no URL.

  • 400 InvalidSyncAgentResourceId – identificador de recurso do agente de sincronização inválido.

  • 400 MismatchingResourceGroupNameWithUrl – o nome do grupo de recursos fornecido não corresponde ao nome no URL.

  • 400 MismatchingServerNameWithUrl – o nome do servidor fornecido não corresponde ao nome no URL.

  • 400 InvalidParameterValue – foi atribuído um valor inválido a um parâmetro.

  • 400 MissingServerName – O nome do servidor está em falta

  • 400 MissingDatabaseName – O nome da base de dados está em falta

  • 400 MissingSyncGroupName – O nome do Grupo de Sincronização está em falta

  • 400 MissingConflictResolutionPolicy – A Política de Resolução de Conflitos está em falta

  • 400 MissingSyncAgentName – O nome do Agente de Sincronização está em falta

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

  • 400 SyncOperation_WrongSyncDatabase – a base de dados de sincronização especificada não corresponde à existente.

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

  • 400 SyncOperation_MasterDbInSyncGroup – não é possível utilizar o mestre lógico na sincronização de dados.

  • 400 CannotDeleteInUseSyncAgent – não é possível eliminar o agente de sincronização porque é utilizado pelo membro de sincronização.

  • 400 InvalidSyncAgent – O agente de sincronização é inválido.

  • 400 InvalidSyncMetadataDatabase - A base de dados de metadados de sincronização é inválida.

  • 404 ResourceNotFound – o recurso pedido não foi encontrado.

  • 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado

  • 404 DatabaseDoesNotExist – o utilizador especificou um nome de base de dados que não existe nesta instância do servidor.

  • 409 SyncOperation_AgentAlreadyExists - O agente de sincronização com o mesmo nome já existe.

  • 409 SyncOperation_AgentIdAlreadyExists - O agente de sincronização com o mesmo ID já existe.

Exemplos

Get a sync agent

Pedido de amostra

GET 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

Resposta da amostra

Código de estado:
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"
}

Definições

Name Description
SyncAgent

Um agente de sincronização da Base de Dados SQL do Azure.
SyncAgentState

Estado do agente de sincronização.

SyncAgent

Object

Um agente de sincronização da Base de Dados SQL do Azure.

Name Tipo Description
id

string

ID do Recurso.
name

string

Nome do recurso.
properties.expiryTime

string

Tempo de expiração da versão do agente de sincronização.
properties.isUpToDate

boolean

Se a versão do agente de sincronização estiver atualizada.
properties.lastAliveTime

string

Hora da última vida do agente de sincronização.
properties.name

string

Nome do agente de sincronização.
properties.state

SyncAgentState

Estado do agente de sincronização.
properties.syncDatabaseId

string

ID do recurso arm da base de dados de sincronização no agente de sincronização.
properties.version

string

Versão do agente de sincronização.
type

string

Tipo de recurso.

SyncAgentState

Enumeration

Estado do agente de sincronização.

Valor Description
NeverConnected
Offline
Online