Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
Lesen der Eigenschaften und Beziehungen eines longRunningOperation-Objekts . Mit dieser API können Sie die Details und den Status der folgenden langwierigen Microsoft Graph-API-Vorgänge abrufen.
Die möglichen Zustände des langwierigen Vorgangs sind notStarted, running, succeeded, failedunknownFutureValue , wobei succeeded und failed Endzustände sind.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Für Rollenverwaltungswarnungen
| Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
|---|---|---|
| Delegiert (Geschäfts-, Schul- oder Unikonto) | RoleManagementAlert.Read.Directory | RoleManagementAlert.ReadWrite.Directory |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
| Application | RoleManagementAlert.Read.Directory | RoleManagementAlert.ReadWrite.Directory |
Wichtig
Für den delegierten Zugriff mit Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer eine unterstützte Microsoft Entra-Rolle oder eine benutzerdefinierte Rolle zugewiesen werden, die die für diesen Vorgang erforderlichen Berechtigungen gewährt. Dieser Vorgang unterstützt die folgenden integrierten Rollen, die nur die geringstmöglichen Berechtigungen gewähren:
- Administrator für privilegierte Rollen
- Globaler Leseberechtigter
- Sicherheitsadministrator
- Sicherheitsleseberechtigter
Für Authentifizierungsmethoden (Kennwortzurücksetzung)
| Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
|---|---|---|
| Delegiert (Geschäfts-, Schul- oder Unikonto) | UserAuthenticationMethod.Read.All | UserAuthenticationMethod.Read, UserAuthenticationMethod.ReadWrite, UserAuthenticationMethod.ReadWrite.All |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
| Application | Nicht unterstützt | Nicht unterstützt |
Wichtig
Für den delegierten Zugriff über Geschäfts-, Schul- oder Unikonten, bei denen der angemeldete Benutzer auf einen anderen Benutzer reagiert, muss ihm eine unterstützte Microsoft Entra-Rolle oder eine benutzerdefinierte Rolle zugewiesen werden, die die für diesen Vorgang erforderlichen Berechtigungen gewährt. Dieser Vorgang unterstützt die folgenden integrierten Rollen, die nur die geringstmöglichen Berechtigungen gewähren:
- Globaler Leser
- Authentifizierungsadministrator
- Privileged Authentication Administrator
HTTP-Anforderung
So rufen Sie Details zu einem zeitintensiven Vorgang der Rollenverwaltungs-Warnungsaktualisierung ab:
GET /identityGovernance/roleManagementAlerts/operations/{longRunningOperationId}
So rufen Sie den Status eines zeitintensiven Vorgangs zum Zurücksetzen der Authentifizierungsmethode ab:
GET /users/{id | userPrincipalName}/authentication/operations/{id}
Optionale Abfrageparameter
Diese Methode unterstützt den $select OData-Abfrageparameter, um die Antwort anzupassen. Allgemeine Informationen finden Sie unter OData-Abfrageparameter.
Anforderungsheader
| Name | Beschreibung |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Bei erfolgreicher Ausführung gibt diese Methode einen 200 OK Antwortcode und ein longRunningOperation-Objekt im Antworttext zurück.
Bei Rollenverwaltungswarnungen enthält die resourceLocation die URL der Rollenverwaltungswarnung, wenn der Status des Vorgangs lautetsucceeded; andernfalls ist die resourceLocation leer.
Beispiele
Beispiel 1: Abrufen der Details eines zeitintensiven Vorgangs zur Aktualisierung der Warnung zur Rollenverwaltung, wenn der Status des Vorgangs lautetrunning
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/beta/identityGovernance/roleManagementAlerts/operations/refresh:DirectoryRole_19356be4-7e93-4ed6-a7c6-0ae28454d125_StaleSignInAlert
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
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/roleManagementAlerts/operations/$entity",
"id": "refresh:DirectoryRole_19356be4-7e93-4ed6-a7c6-0ae28454d125_StaleSignInAlert",
"createdDateTime": "2023-06-09T22:50:41.5414467Z",
"lastActionDateTime": "2023-06-09T22:52:09.0296021Z",
"resourceLocation": "",
"status": "running",
"statusDetail": ""
}
Beispiel 2: Abrufen der Details eines zeitintensiven Vorgangs zur Aktualisierung der Warnung zur Rollenverwaltung, wenn der Status des Vorgangs lautetsucceeded
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/beta/identityGovernance/roleManagementAlerts/operations/refresh:DirectoryRole_19356be4-7e93-4ed6-a7c6-0ae28454d125_StaleSignInAlert
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
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/roleManagementAlerts/operations/$entity",
"id": "refresh:DirectoryRole_19356be4-7e93-4ed6-a7c6-0ae28454d125_StaleSignInAlert",
"createdDateTime": "2023-06-09T22:50:41.5414467Z",
"lastActionDateTime": "2023-06-09T22:56:09.0296021Z",
"resourceLocation": "https://graph.microsoft.com/beta/identityGovernance/roleManagementAlerts/alerts/DirectoryRole_19356be4-7e93-4ed6-a7c6-0ae28454d125_StaleSignInAlert",
"status": "succeeded",
"statusDetail": ""
}
Beispiel 3: Abrufen des Status eines Vorgangs zum Zurücksetzen der Kennwortauthentifizierungsmethode.
Die ID des Vorgangs, der in dieser Anforderung verwendet werden soll, wird aus der Antwort abgerufen, die Sie vom Passwword-Zurücksetzungsvorgang erhalten.
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/beta/users/{id | userPrincipalName}/authentication/operations/{id}
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
{
"status": "running",
"createdDateTime": "2020-03-19T12-01-03.45Z",
"lastActionDateTime": "2020-03-19T12-01-04.23Z",
"id": "2d497bb-57bd-47a6-8749-5ccd0869f2bd"
}
Beispiel 4: Abrufen eines Vorgangs mit langer Ausführungszeit aus dem Branchendatendienst
Das folgende Beispiel zeigt, wie Sie einen Vorgang mit langer Ausführungszeit für den Branchendatendienst abrufen.
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/beta/external/industryData/operations/d194fa3e-18c9-47a1-0fb1-08dad8e7a876
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
{
"@odata.type": "#microsoft.graph.longRunningOperation",
"createdDateTime": "2022-12-14T05:54:35.400029Z",
"id": "d194fa3e-18c9-47a1-0fb1-08dad8e7a876",
"lastActionDateTime": "2022-12-14T05:54:43.8410226Z",
"resourceLocation": "https://graph.microsoft.com/beta/industryData/dataConnectors/022da4a0-c239-4b07-abed-08dad8e7a07a",
"status": "succeeded",
"statusDetail": null
}