Workflows auflisten
Namespace: microsoft.graph.identityGovernance
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.
Rufen Sie eine Liste der Workflowressourcen ab, die Lebenszyklusworkflows zugeordnet sind.
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) | LifecycleWorkflows.Read.All | LifecycleWorkflows.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | LifecycleWorkflows.Read.All | LifecycleWorkflows.ReadWrite.All |
In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer eine unterstützte Microsoft Entra-Rolle oder eine benutzerdefinierte Rolle mit einer unterstützten Rollenberechtigung zugewiesen werden. Globaler Leser und Lebenszyklusworkflowadministrator sind die Rollen mit den geringsten Berechtigungen, die für diesen Vorgang unterstützt werden.
HTTP-Anforderung
GET /identityGovernance/lifecycleWorkflows/workflows
Optionale Abfrageparameter
Diese Methode unterstützt die $search
OData-Abfrageparameter , $orderby
und $filter
zum Anpassen der Antwort.
$expand
wird nur von den Beziehungen createdBy und lastModifiedBy unterstützt. Allgemeine Informationen finden Sie unter OData-Abfrageparameter.
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | 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 gibt die Methode einen 200 OK
Antwortcode und eine Sammlung von microsoft.graph.identityGovernance.workflow-Objekten im Antworttext zurück.
Beispiele
Beispiel 1: Abrufen aller im Mandanten erstellten Workflows
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows
Antwort
Das folgende Beispiel zeigt die Antwort.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/workflows",
"value": [
{
"category": "joiner",
"description": "Configure pre-hire tasks for onboarding employees before their first day",
"displayName": "Global pre hire",
"lastModifiedDateTime": "2022-08-16T20:05:51.4618603Z",
"createdDateTime": "2022-01-10T20:04:30.619368Z",
"id": "c007a148-5bf1-4f38-82b4-377fb23b1711",
"isEnabled": true,
"isSchedulingEnabled": true,
"version": 12
},
{
"category": "joiner",
"description": "Configure new hire tasks for onboarding employees on their first day",
"displayName": "Global new hire",
"lastModifiedDateTime": "2022-08-18T17:24:42.6051254Z",
"createdDateTime": "2022-05-06T14:10:39.9700268Z",
"id": "559d8339-ab4e-4c41-a517-ed5d8dd9fbf5",
"isEnabled": true,
"isSchedulingEnabled": true,
"version": 5
},
{
"category": "joiner",
"description": "Configure pre-hire tasks for onboarding employees before their first day",
"displayName": "Onboard pre-hire employee",
"lastModifiedDateTime": "2022-08-16T20:01:28.3589067Z",
"createdDateTime": "2022-08-16T17:48:55.2262907Z",
"id": "d0454160-b8e9-432f-8a85-790021e64c9e",
"isEnabled": false,
"isSchedulingEnabled": false,
"version": 1
},
{
"category": "leaver",
"description": "Configure offboarding tasks for employees after their last day of work",
"displayName": "Post-Offboarding of an employee",
"lastModifiedDateTime": "2022-08-17T18:57:30.5091553Z",
"createdDateTime": "2022-08-17T18:57:07.1840042Z",
"id": "15f9c6db-ada8-4417-927f-17ac24b54b9b",
"isEnabled": true,
"isSchedulingEnabled": false,
"version": 1
},
{
"category": "leaver",
"description": "Execute real-time termination tasks for employees on their last day of work",
"displayName": "Real-time employee termination",
"lastModifiedDateTime": "2022-08-19T20:34:15.4212506Z",
"createdDateTime": "2022-08-19T20:34:15.4212481Z",
"id": "57bc6612-2c20-4141-9dab-aa11a95b8fbc",
"isEnabled": true,
"isSchedulingEnabled": false,
"version": 1
},
{
"category": "joiner",
"description": "Configure new hire tasks for onboarding employees on their first day",
"displayName": "Onboard new hire employee",
"lastModifiedDateTime": "2022-08-24T15:39:17.6496744Z",
"createdDateTime": "2022-08-24T15:39:17.6496704Z",
"id": "156ce798-1eb6-4e0a-8515-e79f54d04390",
"isEnabled": true,
"isSchedulingEnabled": false,
"version": 1
}
]
}
Beispiel 2: Abrufen nur bestimmter Eigenschaften von "Leaver"-Workflows
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows?$filter=category eq 'leaver'&$select=id,category,displayName,isEnabled,isSchedulingEnabled
Antwort
Das folgende Beispiel zeigt die Antwort.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/workflows(category,displayName,isEnabled,isSchedulingEnabled)",
"value": [
{
"category": "leaver",
"displayName": "Pre-Offboarding employees in the R&D department",
"id": "c0548e6c-8849-46e8-be14-8b6d2b04957e",
"isEnabled": true,
"isSchedulingEnabled": true
}
]
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für