tipo de recurso synchronizationJob

  • Artículo

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Realiza la sincronización ejecutándose periódicamente en segundo plano, sondeando los cambios en un directorio e insertándolos en otro directorio. El trabajo de sincronización siempre es específico de una instancia determinada de una aplicación en el inquilino. Como parte de la configuración del trabajo de sincronización, debe conceder autorización para leer y escribir objetos en el directorio de destino y personalizar el esquema de sincronización del trabajo.

Métodos

Método Tipo de valor devuelto Descripción
List colección synchronizationJob Enumerar los trabajos existentes para una instancia de aplicación determinada (entidad de servicio).
Obtener synchronizationJob synchronizationJob Lee las propiedades y las relaciones de un objeto synchronizationJob.
Crear synchronizationJob Cree un nuevo trabajo para una aplicación determinada.
Start Ninguno Inicie la sincronización. Si el trabajo está en estado en pausa, continúa desde el punto en que el trabajo se ha pausado. Si el trabajo está en cuarentena, se borra el estado de cuarentena.
Restart Ninguno Forzar que el trabajo se inicie de nuevo y volver a procesar todos los objetos del directorio.
Pause Ninguno Detenga temporalmente la sincronización. Todo el progreso, incluido el estado del trabajo, se conserva y el trabajo continuará desde donde lo dejó cuando se realice una llamada a Start .
Delete Ninguno Detenga la sincronización y elimine permanentemente todo el estado asociado al trabajo.
Obtener synchronizationSchema synchronizationSchema Recupere el esquema de sincronización efectivo del trabajo.
Actualizar synchronizationSchema Ninguno Actualice el esquema de sincronización del trabajo.
Validación de credenciales Ninguno Pruebe las credenciales proporcionadas en el directorio de destino.
provisionOnDemand colección synchronizationJobApplicationParameters Representa los objetos que se aprovisionarán y las reglas de sincronización ejecutadas. El recurso se usa principalmente para el aprovisionamiento a petición.

Propiedades

Propiedad Tipo Descripción
id Cadena Identificador único del trabajo de sincronización. Solo lectura.
schedule synchronizationSchedule Programación usada para ejecutar el trabajo. Solo lectura.
status synchronizationStatus Estado del trabajo, que incluye la última vez que se ejecutó el trabajo, el estado actual del trabajo y los errores.
synchronizationJobSettings keyValuePair Configuración asociada al trabajo. Algunas opciones de configuración se heredan de la plantilla.
templateId Cadena Identificador de la plantilla de sincronización en la que se basa este trabajo.

Relaciones

Relación Tipo Descripción
bulkUpload bulkUpload La operación de carga masiva para el trabajo.
Esquema synchronizationSchema Esquema de sincronización configurado para el trabajo.

Representación JSON

La siguiente es una representación JSON del recurso

{
  "id": "String (identifier)",
  "schedule": {
    "@odata.type": "microsoft.graph.synchronizationSchedule"
  },
  "status": {
    "@odata.type": "microsoft.graph.synchronizationStatus"
  },
  "synchronizationJobSettings": {
    "@odata.type": "microsoft.graph.keyValuePair"
  },
  "templateId": "String"
}