Sync Agents - Create Or Update

Crea o actualiza un agente de sincronización.

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

Parámetros de identificador URI

Name In Required Type Description
resourceGroupName
path True
  • string

Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure.

serverName
path True
  • string

Nombre del servidor en el que se hospeda el agente de sincronización.

subscriptionId
path True
  • string

El id. de suscripción que identifica una suscripción de Azure.

syncAgentName
path True
  • string

Nombre del agente de sincronización.

api-version
query True
  • string

La versión de API que se usará para la solicitud.

Cuerpo de la solicitud

Name Type Description
properties.syncDatabaseId
  • string

Identificador de recurso de ARM de la base de datos de sincronización en el agente de sincronización.

Respuestas

Name Type Description
200 OK

Se actualizó correctamente el agente de sincronización.

201 Created

Ha creado correctamente el agente de sincronización.

202 Accepted

La creación o actualización del agente de sincronización está en curso.

Other Status Codes

Respuestas de error: ***

  • 400 InvalidSyncGroupCreateOrUpdateRequest: el cuerpo de la solicitud del grupo de sincronización de creación o actualización está vacío.

  • 400 InvalidSyncMemberCreateOrUpdateRequest: el cuerpo de la solicitud de miembro de sincronización de creación o actualización está vacío.

  • 400 InvalidSyncAgentCreateOrUpdateRequest: el cuerpo de la solicitud del agente de sincronización de creación o actualización está vacío.

  • 400 InvalidDatabaseResourceId: identificador de recurso de base de datos no válido.

  • 400 No coincidentesSubscriptionWithUrl: la suscripción proporcionada no coincide con la suscripción en la dirección URL.

  • 400 InvalidSyncAgentResourceId: identificador de recursos del agente de sincronización no válido.

  • 400 No coincidentesResourceGroupNameWithUrl: el nombre del grupo de recursos proporcionado no coincide con el nombre de la dirección URL.

  • 400 No coincidentesServerNameWithUrl: el nombre del servidor proporcionado no coincide con el nombre de la dirección URL.

  • 400 InvalidParameterValue: se ha dado un valor no válido a un parámetro.

  • 400 MissingServerName: falta el nombre del servidor

  • 400 MissingDatabaseName: falta el nombre de la base de datos.

  • 400 MissingSyncGroupName: falta el nombre del grupo de sincronización.

  • 400 MissingConflictResolutionPolicy: falta la directiva de resolución de conflictos

  • 400 MissingSyncAgentName: falta el nombre del agente de sincronización.

  • 400 SyncOperation_GenericFailure: no se pudo realizar la operación de sincronización de datos.

  • 400 SyncOperation_WrongSyncDatabase: la base de datos de sincronización especificada no coincide con la existente.

  • 400 SyncOperation_DwInSyncGroup: no se puede usar la edición datawarehouse en la sincronización de datos.

  • 400 SyncOperation_MasterDbInSyncGroup: no se puede usar el patrón lógico en la sincronización de datos.

  • 400 CannotDeleteInUseSyncAgent: no se puede eliminar el agente de sincronización porque lo usa el miembro de sincronización.

  • 400 InvalidSyncAgent: el agente de sincronización no es válido.

  • 400 InvalidSyncMetadataDatabase: la base de datos de metadatos de sincronización no es válida.

  • 404 ResourceNotFound: no se encontró el recurso solicitado.

  • 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado.

  • 404 DatabaseDoesNotExist: el usuario ha especificado un nombre de base de datos que no existe en esta instancia del servidor.

  • 404 OperationIdNotFound: la operación con id. no existe.

  • 409 SyncOperation_AgentAlreadyExists: el agente de sincronización con el mismo nombre ya existe.

  • 409 SyncOperation_AgentIdAlreadyExists: el agente de sincronización con el mismo identificador ya existe.

  • 409 OperationCancelled: el usuario canceló la operación.

  • 409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió por otra operación en el mismo recurso.

  • 429 SuscripciónTooManyCreateUpdateRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles.

  • 429 SubscriptionTooManyRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles.

  • 500 OperationTimedOut: se agota el tiempo de espera de la operación y se revierte automáticamente. Vuelva a intentar la operación y,

  • 503 TooManyRequests: solicitudes más allá del número máximo de solicitudes que se pueden procesar mediante recursos disponibles.

Ejemplos

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

Definiciones

SyncAgent

Un agente de sincronización de base de datos de Azure SQL.

SyncAgentState

Estado del agente de sincronización.

SyncAgent

Un agente de sincronización de base de datos de Azure SQL.

Name Type Description
id
  • string

Identificador del recurso.

name
  • string

Nombre del recurso.

properties.expiryTime
  • string

Hora de expiración de la versión del agente de sincronización.

properties.isUpToDate
  • boolean

Si la versión del agente de sincronización está actualizada.

properties.lastAliveTime
  • string

Hora de última vida del agente de sincronización.

properties.name
  • string

Nombre del agente de sincronización.

properties.state

Estado del agente de sincronización.

properties.syncDatabaseId
  • string

Identificador de recurso de ARM de la base de datos de sincronización en el agente de sincronización.

properties.version
  • string

Versión del agente de sincronización.

type
  • string

Tipo de recurso.

SyncAgentState

Estado del agente de sincronización.

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