accessPackageAssignment: additionalAccess

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.

Rufen Sie in Microsoft Entra Entitlement Management eine Auflistung von accessPackageAssignment-Objekten ab, die angeben, dass ein Zielbenutzer über eine Zuweisung zu einem bestimmten Zugriffspaket sowie eine Zuweisung zu einem anderen, potenziell inkompatiblen Zugriffspaket verfügt. Es kann verwendet werden, um die Konfiguration der inkompatiblen Zugriffspakete für ein bestimmtes Zugriffspaket vorzubereiten.

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.

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
Application Nicht unterstützt Nicht unterstützt

Tipp

Für den delegierten Zugriff mit Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer eine Administratorrolle mit unterstützten Rollenberechtigungen über eine der folgenden Optionen zugewiesen werden:

  • Eine Rolle im Berechtigungsverwaltungssystem , bei der die Rollen mit den geringsten Berechtigungen sind:
    • Katalogleser. Dies ist die Option mit den geringsten Berechtigungen
    • Katalogersteller
    • Zugriff auf Paket-Manager
  • Weitere privilegierte Microsoft Entra-Rollen, die für diesen Vorgang unterstützt werden:
    • Sicherheitsleseberechtigter
    • Globaler Leser
    • Complianceadministrator
    • Sicherheitsadministrator
    • Identity Governance Administrator

In reinen App-Szenarien kann der aufrufenden App anstelle der EntitlementManagement.Read.All Anwendungsberechtigung eine der oben genannten unterstützten Rollen zugewiesen werden. Die Katalogleserolle ist weniger privilegiert als die EntitlementManagement.Read.All Anwendungsberechtigung.

Weitere Informationen finden Sie unter Delegierung und Rollen in der Berechtigungsverwaltung und Delegieren der Zugriffsgovernance an Zugriffspaket-Manager in der Berechtigungsverwaltung.

HTTP-Anforderung

GET /identityGovernance/entitlementManagement/accessPackageAssignments/additionalAccess(accessPackageId='parameterValue',incompatibleAccessPackageId='parameterValue')

Funktionsparameter

Die folgende Tabelle zeigt die Parameter, die mit dieser Funktion angegeben werden müssen. Die beiden Zugriffspaket-IDs müssen unterschiedlich sein.

Parameter Typ Beschreibung
accessPackageId Zeichenfolge Gibt die ID eines Zugriffspakets an, für das der Aufrufer die Zuweisungen abrufen möchte. Erforderlich.
incompatibleAccessPackageId Zeichenfolge Das spezifische inkompatible Zugriffspaket, für das der Aufrufer nur die Zuweisungen abrufen möchte, bei denen der Benutzer auch über eine Zuweisung zu diesem inkompatiblen Zugriffspaket verfügt. Erforderlich.

Optionale Abfrageparameter

Diese Methode unterstützt die $selectAbfrageparameter , $filterund $expand OData, 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 eine Auflistung von accessPackageAssignment-Objekten im Antworttext zurück.

Wenn sich ein Resultset über mehrere Seiten erstreckt, gibt Microsoft Graph diese Seite mit einer @odata.nextLink Eigenschaft in der Antwort zurück, die eine URL zur nächsten Ergebnisseite enthält. Wenn diese Eigenschaft vorhanden ist, stellen Sie weitere Anforderungen mit der @odata.nextLink URL in jeder Antwort, bis alle Ergebnisse zurückgegeben werden. Weitere Informationen finden Sie unter Auslagern von Microsoft Graph-Daten in Ihrer App.

Beispiele

Im folgenden Beispiel werden die Zugriffspaketzuweisungen für Benutzer abgerufen, die über Zuweisungen zu beiden Zugriffspaketen verfügen.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignments/additionalAccess(accessPackageId='2506aef1-3929-4d24-a61e-7c8b83d95e6f',incompatibleAccessPackageId='d5d99728-8c0b-4ede-83d2-cf9b0e8dabfb')?$expand=target

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

{
  "value": [
        {
            "@odata.type": "#microsoft.graph.accessPackageAssignment",
            "id": "a61f7889-ae61-4e97-a4dc-e4fa525f5b33",
            "catalogId": "beedadfe-01d5-4025-910b-84abb9369997",
            "accessPackageId": "2506aef1-3929-4d24-a61e-7c8b83d95e6f",
            "assignmentPolicyId": "07c7c99d-6cf3-4527-bd05-5fc2ac8e96e7",
            "targetId": "cdbdf152-82ce-479c-b5b8-df90f561d5c7",
            "target": {
                "id": "ebaf071e-c647-42c6-b86f-fbe3625b4b63",
                "objectId": "cdbdf152-82ce-479c-b5b8-df90f561d5c7",
                "displayName": "user1"
            }
        },
        {
            "@odata.type": "#microsoft.graph.accessPackageAssignment",
            "id": "a7284263-8233-44de-8095-0ee3ff5a1716",
            "catalogId": "beedadfe-01d5-4025-910b-84abb9369997",
            "accessPackageId": "2506aef1-3929-4d24-a61e-7c8b83d95e6f",
            "assignmentPolicyId": "07c7c99d-6cf3-4527-bd05-5fc2ac8e96e7",
            "targetId": "79a8f0b6-61dc-41db-b49e-470c278e05b6",
            "target": {
                "id": "9865b0f8-868f-42c6-a49b-3067eb4b2da1",
                "objectId": "79a8f0b6-61dc-41db-b49e-470c278e05b6",
                "displayName": "user2"
            }
        }
  ]
}