Identitätsressourcentyp

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.

Stellt die Identität eines Akteurs dar. Ein Akteur kann beispielsweise ein Benutzer, ein Gerät oder eine Anwendung sein. Mehrere Microsoft Graph-APIs teilen diese Ressource, und die zurückgegebenen Daten variieren je nach API.

In Berechtigungsverwaltungsszenarien wird diese Ressource verwendet, um Identitäten in Kontexten darzustellen, z. B. verwandte Personen in Access-Paketvorschlägen.

Basistyp der userIdentity.

Eigenschaften

Eigenschaft Typ Beschreibung
displayName Zeichenfolge Der Anzeigename der Identität.

Bei Laufwerkelementen ist der Anzeigename möglicherweise nicht immer verfügbar oder nicht immer aktuell. Wenn ein Benutzer z. B. seinen Anzeigenamen ändert, zeigt die API möglicherweise den neuen Wert in einer zukünftigen Antwort an, aber die dem Benutzer zugeordneten Elemente werden bei Verwendung von Delta nicht als geändert angezeigt.
id Zeichenfolge Eindeutiger Bezeichner für die Identität oder den Akteur. In der API für Zugriffsüberprüfungsentscheidungen kann diese Eigenschaft beispielsweise die ID des Prinzipals, d. h. der Gruppe, des Benutzers oder der Anwendung, die überprüft werden soll, aufzeichnen.
tenantId Zeichenfolge Eindeutige Identität des Mandanten. Optional.
thumbnails thumbnailSet Schlüsselsammlung von Miniaturansichtsressourcen. Optional. Gilt z. B. für Laufwerkselemente.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "displayName": "String",
  "id": "String (identifier)",
  "tenantId": "String",
  "thumbnails": { "@odata.type": "microsoft.graph.thumbnailSet" }
}