Feedback Bearbeiten

accessPackageResourceRoles auflisten

  • Artikel
  • 7 Minuten Lesedauer

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Dient zum Abrufen einer Liste von accessPackageResourceRole -Objekten einer accessPackageResource in einem accessPackageCatalog. Die Ressource sollte dem Katalog durch Erstellen eines accessPackageResourceRequesthinzugefügt worden sein. Diese Liste von Rollen kann dann vom Aufrufer verwendet werden, um eine Rolle auszuwählen, die beim anschließenden Erstellen eines accessPackageResourceRoleScopeerforderlich ist.

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Anwendung EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All

HTTP-Anforderung

GET /identityGovernance/entitlementManagement/accessPackageCatalogs/{catalogId}/accessPackageResourceRoles?$filter=(originSystem+eq+%27{originSystemType}%27+and+accessPackageResource/id+eq+%27{resourceId}%27)&$expand=accessPackageResource

Optionale Abfrageparameter

Diese Methode verwendet OData-Abfrageparameter, um die Antwort zu erstellen. Allgemeine Informationen finden Sie unter OData-Abfrageparameter.

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich.

Anforderungstext

Geben Sie für diese Methode keinen Anforderungstext an.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 200 OK Antwortcode und eine Sammlung von accessPackageResourceRole-Objekten im Antworttext zurück.

Beispiele

Beispiel 1: Abrufen der Rollen einer Ressource für eine Gruppe

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageCatalogs/15d889df-3eb8-4e9b-bfb4-b1908849aec4/accessPackageResourceRoles?$filter=(originSystem+eq+%27AadGroup%27+and+accessPackageResource/id+eq+%27a35bef72-a8aa-4ca3-af30-f6b2ece7208f%27)&$expand=accessPackageResource

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 200 OK
Content-type: application/json

{
  "value": [
    {
      "id": "id-value",
      "displayName": "Member",
      "description": "description-value",
      "originId": "originId-value",
      "originSystem": "originSystem-value"
    }
  ]
}

Beispiel 2: Abrufen der Rollen einer Ressource für eine SharePoint Onlinewebsite

Dies ist ein Beispiel für das Abrufen der Rollen einer Ressource, um die OriginId jeder Rolle abzurufen. Dies wird verwendet, nachdem eine SharePoint Onlinewebsite als Ressource zum Katalog hinzugefügt wurde, da die OriginId einer Rolle benötigt wird, um die Rolle einem Zugriffspaket hinzuzufügen.

Anforderung

Es folgt ein Beispiel für die Anforderung zum Abrufen der Rollen einer bestimmten Ressource 53c71803-a0a8-4777-aecc-075de8ee3991, die ein originSystem von SharePointOnline aufweist und sich im Katalog beedadfe-01d5-4025-910b-84abb9369997 befindet.

GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageCatalogs/beedadfe-01d5-4025-910b-84abb9369997/accessPackageResourceRoles?$filter=(originSystem+eq+%27SharePointOnline%27+and+accessPackageResource/id+eq+%2753c71803-a0a8-4777-aecc-075de8ee3991%27)&$select=displayName,originId

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort. Der displayName ist identisch mit dem in der SharePoint Onlineansicht einer Website dargestellten, und die originId ist der zugrunde liegende Bezeichner, der von SharePoint Online für die Rolle erstellt wurde.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 200 OK
Content-type: application/json

{
  "value": [
    {
        "displayName": "Contributors",
        "originId": "4"
    },
    {
        "displayName": "Creators",
        "originId": "3"
    },
    {
        "displayName": "Viewers",
        "originId": "5"
    }
  ]
}