Auflisten von AssignmentRequests
Namespace: microsoft.graph
Rufen Sie in Microsoft Entra Berechtigungsverwaltung eine Liste der accessPackageAssignmentRequest-Objekte ab. Die resultierende Liste enthält alle aktuellen und abgelaufenen Zuweisungsanforderungen, auf die der Aufrufer Zugriff hat, über alle Kataloge und Zugriffspakete hinweg.
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) | EntitlementManagement.Read.All | EntitlementManagement.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | EntitlementManagement.Read.All | EntitlementManagement.ReadWrite.All |
HTTP-Anforderung
GET /identityGovernance/entitlementManagement/assignmentRequests
Abfrageparameter
Diese Methode unterstützt die $select
OData-Abfrageparameter und $expand
$filter
zum Anpassen der Antwort. Nicht alle Attribute einer accessPackageAssignmentRequest werden zum Filtern unterstützt.
Wenn der Benutzer oder die Anwendung nur über Berechtigungen innerhalb eines bestimmten Katalogs oder katalogs verfügt, müssen Sie in die Abfrage einen Filter einschließen, der ein Zugriffspaket angibt, z $expand=accessPackage&$filter=accessPackage/id eq '9bbe5f7d-f1e7-4eb1-a586-38cdf6f8b1ea'
. B. .
Beispielszenarien für die Verwendung von Abfrageparametern
- Um Anforderungen abzurufen, die nach einem bestimmten Datum erstellt wurden, schließen Sie in die Abfrage ein
$filter=createdDateTime gt 2022-04-01T00:00:01Z
. - Um das Zugriffspaket jeder Anforderung abzurufen, fügen Sie in die Abfrage ein
$expand=accessPackage
. - Um die resultierende Zuweisung abzurufen, fügen Sie in die Abfrage ein
$expand=assignment
. - Um weitere Details zum Anforderer zu erhalten, fügen Sie in die Abfrage ein
$expand=requestor
.
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 Auflistung von accessPackageAssignmentRequest-Objekten im Antworttext zurück.
Beispiele
Anforderung
GET https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/assignmentRequests
Antwort
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"id": "7999249e-249e-7999-9e24-99799e249979",
"requestType": "userAdd",
"state": "delivered",
"status": "Delivered",
"createdDateTime": "2019-10-25T22:55:11.623Z",
"completedDateTime": "2019-10-26T22:55:11.623Z",
"schedule": {
"@odata.type": "microsoft.graph.entitlementManagementSchedule"
}
}
]
}