Feedback Bearbeiten

Benutzernutzungsrechte auflisten

  • Artikel
  • 6 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 usageRight-Objekten für einen bestimmten Benutzer.

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) User.Read, User.ReadWrite, User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Anwendung User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All

HTTP-Anforderung

GET /users/{userId}/usageRights

Optionale Abfrageparameter

Diese API unterstützt den $filter OData-Abfrageparameter. Die folgenden Muster von $filter werden unterstützt:

  • $filter = status eq 'value'
  • $filter = serviceIdentifier eq 'value'
  • $filter = status eq 'value' und serviceIdentifier eq 'value'
  • $filter = Status in ('Wert1', 'Wert2')
  • $filter = serviceIdentifier in ('value1', 'value2')
  • $filter = Status in ('value1', 'value2') und serviceIdentifier in ('value1', 'value2')

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich.
odata.maxpagesize Legen Sie die maximale Seitengröße des Ergebnisses fest. Optional.

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 usageRight-Objekten im Antworttext zurück.

Wenn weitere Seiten in der Antwort vorhanden sind, wird außerdem @odata.nextLink zurückgegeben.

Beispiele

Beispiel 1: Abrufen aller Nutzungsrechte für einen Benutzer

Anforderung

GET https://graph.microsoft.com/beta/users/{userId}/usageRights

Antwort

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

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

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('64952b80-51fd-4378-9ba5-589a840afb80')/usageRights",
  "@odata.nextLink": "https://graph.microsoft.com/beta/users/64952b80-51fd-4378-9ba5-589a840afb80/usageRights?$skiptoken=W4diD29cGKX1bX",
  "value": [
    {
      "id": "c2e034cb-3cbc-41be-a496-bfcd031e4cfc",
      "catalogId": "CFQ7TTC0KCRG:0001",
      "serviceIdentifier": "mscrm.f6d23ec7-255c-4bd8-8c99-dc041d5cb8b3.517f7ddd-df45-4f1c-83ec-a081a047f546",
      "state": "active"
    }
  ]
}

Beispiel 2: Abrufen von Nutzungsrechten für einen Benutzer mit bestimmten Dienstbezeichnern und Status

Anforderung

GET https://graph.microsoft.com/beta/users/{userId}/usageRights?$filter=state in ('active', 'suspended') and serviceIdentifier in ('ABCD')

Antwort

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

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

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('64952b80-51fd-4378-9ba5-589a840afb80')/usageRights",
  "value": [
    {
      "id": "505261eb-b4ee-421c-8206-05529ae2c150",
      "catalogId": "CFQ7TTC0KCRG:0001",
      "serviceIdentifier": "ABCD",
      "state": "active"
    }
  ]
}