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 $selectOData-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"
      }
    }
  ]
}