Freigeben über

Channel: doesUserHaveAccess

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.

Bestimmen Sie, ob ein Benutzer Zugriff auf einen Kanal hat.

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

HTTP-Anforderung

GET /teams/{team-id}/channels/{channel-id}/doesUserHaveAccess(userId='@userId',tenantId='@tenantId',userPrincipalName='@userPrincipalName')

Funktionsparameter

Stellen Sie in der URL der Anforderung die folgenden Abfrageparameter mit Werten bereit. In der folgenden Tabelle sind die Parameter aufgeführt, die mit dieser Funktion verwendet werden können.

Parameter Typ Beschreibung
tenantId Zeichenfolge Die ID des Microsoft Entra Mandanten, zu dem der Benutzer gehört. Der Standardwert für diese Eigenschaft ist die aktuelle tenantId des angemeldeten Benutzers oder der App.
userId String Eindeutiger Bezeichner für den Benutzer. Geben Sie entweder die userId oder die userPrincipalName-Eigenschaft in der Anforderung an.
userPrincipalName Zeichenfolge Der Benutzerprinzipalname (UPN) des Benutzers. Geben Sie entweder die userId oder die userPrincipalName-Eigenschaft in der Anforderung an.

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Funktion an.

Antwort

Wenn die Funktion erfolgreich verläuft, werden der Antwortcode 200 OK und ein boolescher Wert im Antworttext zurückgegeben.

Beispiele

Beispiel 1: Überprüfen des Zugriffs für einen internen Benutzer

Das folgende Beispiel zeigt eine Anforderung, die überprüft, ob ein interner Benutzer Zugriff auf einen Kanal hat.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/beta/teams/0fddfdc5-f319-491f-a514-be1bc1bf9ddc/channels/19:33b76eea88574bd1969dca37e2b7a819@thread.skype/doesUserHaveAccess(userId='6285581f-484b-4845-9e01-60667f8b12ae')

Antwort

Das folgende Beispiel zeigt die Antwort.

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

{
  "value": true
}

Beispiel 2: Überprüfen des Zugriffs für einen externen Benutzer

Das folgende Beispiel zeigt eine Anforderung, die die tenantId-Eigenschaft verwendet, um zu überprüfen, ob ein externer Benutzer Zugriff auf einen freigegebenen Kanal hat.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/beta/teams/0fddfdc5-f319-491f-a514-be1bc1bf9ddc/channels/19:33b76eea88574bd1969dca37e2b7a819@thread.skype/doesUserHaveAccess(userId='62855810-484b-4823-9e01-60667f8b12ae', tenantId='57fb72d0-d811-46f4-8947-305e6072eaa5')

Antwort

Das folgende Beispiel zeigt die Antwort.

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

{
  "value": true
}

Beispiel 3: Überprüfen des Benutzerzugriffs für einen Benutzer mithilfe des Benutzerprinzipalnamens

Das folgende Beispiel zeigt eine Anforderung, die die userPrincipalName-Eigenschaft verwendet, um zu überprüfen, ob ein interner Benutzer Zugriff auf einen Kanal hat.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/beta/teams/0fddfdc5-f319-491f-a514-be1bc1bf9ddc/channels/19:33b76eea88574bd1969dca37e2b7a819@thread.skype/doesUserHaveAccess(userPrincipalName='john.doe@contoso.com')

Antwort

Das folgende Beispiel zeigt die Antwort.

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

{
  "value": false
}
  • Last updated on