synchronizationJob Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Führt eine Synchronisierung durch, indem es regelmäßig im Hintergrund ausgeführt wird, Änderungen in einem Verzeichnis abruft und in ein anderes Verzeichnis überträgt. Der Synchronisierungsauftrag ist immer spezifisch für eine bestimmte Instance einer Anwendung in Ihrem Mandanten. Im Rahmen der Einrichtung des Synchronisationsauftrags müssen Sie die Berechtigung zum Lesen und Schreiben von Objekten in Ihrem Zielverzeichnis erteilen und das Synchronisationsschema des Auftrags anpassen.

Methoden

Methode Rückgabetyp Beschreibung
List synchronizationJob collection Auflisten vorhandener Aufträge für eine bestimmte Anwendungs-instance (Dienstprinzipal).
Get synchronizationJob Lesen von Eigenschaften und Beziehungen eines synchronizationJob-Objekts.
Create synchronizationJob Erstellen Sie einen neuen Auftrag für eine bestimmte Anwendung.
Start Keine Starten Sie die Synchronisierung. Wenn sich der Auftrag in einem angehaltenen Zustand befindet, wird er an dem Punkt fortgesetzt, an dem er angehalten wurde. Wenn sich der Auftrag in Quarantäne befindet, wird die Quarantäne-status gelöscht.
Pause Keine Beenden Sie vorübergehend die Synchronisierung. Der gesamte Fortschritt, einschließlich des Auftragsstatus, wird beibehalten, und der Auftrag wird bei einem Startaufruf an der Stelle fortgesetzt, an der er beendet wurde.
Restart Keine Erzwingen Sie den Start des Auftrags und die erneute Verarbeitung aller Objekte im Verzeichnis.
Löschen Keine Beenden Sie die Synchronisierung, und löschen Sie endgültig alle dem Auftrag zugeordneten Status.
Bereitstellung auf Anforderung synchronizationJobApplicationParameters-Auflistung Stellt die Objekte dar, die bereitgestellt werden sollen, und die ausgeführten Synchronisierungsregeln. Die Ressource wird hauptsächlich für die On-Demand-Bereitstellung verwendet.
Überprüfen von Anmeldeinformationen Keine Testen der bereitgestellten Anmeldeinformationen für das Zielverzeichnis.

Eigenschaften

Eigenschaft Typ Beschreibung
id Zeichenfolge Eindeutiger Bezeichner für den Synchronisationsjob. Schreibgeschützt.
Zeitplan synchronizationSchedule Zum Ausführen des Auftrags verwendeter Zeitplan. Schreibgeschützt.
status synchronizationStatus Status des Auftrags, einschließlich Zeitpunkt der letzten Ausführung des Auftrags, aktueller Auftragsstatus und Fehler.
synchronizationJobSettings keyValuePair Einstellungen, die dem Auftrag zugeordnet sind. Einige Einstellungen werden von der Vorlage geerbt.
templateId Zeichenfolge Bezeichner der Synchronisationsvorlage , auf der dieser Job basiert.

Beziehungen

Beziehung Typ Beschreibung
bulkUpload bulkUpload Der Massenuploadvorgang für den Auftrag.
objectConnections objectConnection-Auflistung Vom Auftrag enthaltene Verknüpfungsdatensätze für Connectordatenspeicher. Rufen Sie während der Public Preview eine einzelne Verbindung mit einer bekannten objectId ab oder löschen Sie sie, um die zwischengespeicherte Verknüpfung zu löschen. Die Auflistung der Sammlung wird nicht unterstützt und gibt zurück 400 Bad Request.
Schema synchronizationSchema Das für den Auftrag konfigurierte Synchronisierungsschema.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

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