Abrufen von synchronizationJob
Namespace: microsoft.graph
Rufen Sie den vorhandenen Synchronisierungsauftrag und seine Eigenschaften ab.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | Synchronization.Read.All | Synchronization.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | Application.ReadWrite.OwnedBy | Synchronization.Read.All, Synchronization.ReadWrite.All |
Zum Konfigurieren der Anwendungsbereitstellung oder personalgesteuerten Bereitstellung muss dem aufrufenden Benutzer außerdem mindestens die VerzeichnisrolleAnwendungsadministrator oder Cloudanwendungsadministrator zugewiesen werden.
Zum Konfigurieren der Microsoft Entra Cloud-Synchronisierung muss dem aufrufenden Benutzer außerdem mindestens die Verzeichnisrolle Hybrididentitätsadministrator zugewiesen werden.
HTTP-Anforderung
GET /servicePrincipals/{id}/synchronization/jobs/{jobId}/
Anforderungsheader
Name | Typ | Beschreibung |
---|---|---|
Authorization | string | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Bei erfolgreicher Ausführung wird eine 200 OK
Antwort mit einem synchronizationJob im Antworttext zurückgegeben.
Beispiel
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/v1.0/servicePrincipals/{id}/synchronization/jobs/{jobId}/
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "{jobId}",
"templateId": "BoxOutDelta",
"schedule": {
"expiration": null,
"interval": "P10675199DT2H48M5.4775807S",
"state": "Disabled"
},
"status": {
"countSuccessiveCompleteFailures": 0,
"escrowsPruned": false,
"synchronizedEntryCountByType": [],
"code": "Paused",
"lastExecution": null,
"lastSuccessfulExecution": null,
"progress": [],
"lastSuccessfulExecutionWithExports": null,
"steadyStateFirstAchievedTime": "0001-01-01T00:00:00Z",
"steadyStateLastAchievedTime": "0001-01-01T00:00:00Z",
"quarantine": {
"currentBegan": "",
"nextAttempt": "",
"reason": "",
"seriesBegan": "",
"seriesCount": 2,
"error": {
"code": "SalesforceInvalidCredentials",
"message": "Your Salesforce.com credentials are invalid. Please obtain a current Salesforce.com administrative user name, password and security token, and enter those in the screen for configuring user provisioning",
"tenantActionable": true
}
},
"troubleshootingUrl": null
},
"synchronizationJobSettings": [
{
"name": "QuarantineTooManyDeletesThreshold",
"value": "500"
}
]
}