Abonnements auflisten

Namespace: microsoft.graph

Rufen Sie die Eigenschaften und die Beziehungen von Webhook-Abonnements basierend auf der App-ID, dem Benutzer und der Rolle des Benutzers mit einem Mandanten auf.

Der Inhalt der Antwort hängt vom Kontext der aufrufenden App ab. Ausführliche Informationen finden Sie in den Szenarien im Abschnitt Berechtigungen.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst	US Government L4	US Government L5 (DOD)	China, betrieben von 21Vianet
✅	✅	✅	✅

Berechtigungen

Diese API unterstützt die folgenden Berechtigungsbereiche. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Unterstützte Ressource	Delegiert (Geschäfts-, Schul- oder Unikonto)	Delegiert (persönliches Microsoft-Konto)	Anwendung
callRecord (/communications/callRecords)	Nicht unterstützt	Nicht unterstützt	CallRecords.Read.All
callRecording communications/onlineMeetings/getAllRecordings Alle Aufzeichnungen in einem organization.	Nicht unterstützt	Nicht unterstützt	OnlineMeetingRecording.Read.All
callRecording communications/onlineMeetings/{onlineMeetingId}/recordings Alle Aufzeichnungen für eine bestimmte Besprechung.	OnlineMeetingRecording.Read.All	Nicht unterstützt	OnlineMeetingRecording.Read.All
callRecording users/{userId}/onlineMeetings/getAllRecordings Eine Anrufaufzeichnung, die in einer Besprechung verfügbar wird, die von einem bestimmten Benutzer organisiert wird.	OnlineMeetingRecording.Read.All	Nicht unterstützt	OnlineMeetingRecording.Read.All
callTranscript communications/onlineMeetings/getAllTranscripts Alle Transkripte in einem organization.	Nicht unterstützt	Nicht unterstützt	OnlineMeetingTranscript.Read.All
callTranscript communications/onlineMeetings/{onlineMeetingId}/transcripts Alle Transkripte für eine bestimmte Besprechung.	OnlineMeetingTranscript.Read.All	Nicht unterstützt	OnlineMeetingTranscript.Read.All
callTranscript users/{userId}/onlineMeetings/getAllTranscripts Ein Anruftranskript, das in einer Besprechung verfügbar wird, die von einem bestimmten Benutzer organisiert wird.	OnlineMeetingTranscript.Read.All	Nicht unterstützt	OnlineMeetingTranscript.Read.All
Kanal (/teams/getAllChannels – alle Kanäle in einer Organisation)	Nicht unterstützt	Nicht unterstützt	Channel.ReadBasic.All, ChannelSettings.Read.All
channel (/teams/{id}/channels)	Channel.ReadBasic.All, ChannelSettings.Read.All, Subscription.Read.All	Nicht unterstützt	Channel.ReadBasic.All, ChannelSettings.Read.All
chat (/Chats – alle Chats in einer Organisation)	Nicht unterstützt	Nicht unterstützt	Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All
chat (/chats/{id})	Chat.ReadBasic, Chat.Read, Chat.ReadWrite, Subscription.Read.All	Nicht unterstützt	ChatSettings.Read.Chat*, ChatSettings.ReadWrite.Chat*, Chat.Manage.Chat*, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All
chat /appCatalogs/teamsApps/{id}/installedToChats Alle Chats in einem organization, in denen eine bestimmte Teams-App installiert ist.	Nicht unterstützt	Nicht unterstützt	Chat.ReadBasic.WhereInstalled, Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled
ChatMessage (/Teams/{ID}/Channels/{ID}/Messages)	ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All, Subscription.Read.All	Nicht unterstützt	ChannelMessage.Read.Group*, ChannelMessage.Read.All
ChatMessage (/Teams/getAllMessages – alle Kanalnachrichten in der Organisation)	Nicht unterstützt	Nicht unterstützt	ChannelMessage.Read.All
ChatMessage (/Chats/{ID}/Messages)	Chat.Read, Chat.ReadWrite, Subscription.Read.All	Nicht unterstützt	Chat.Read.All
ChatMessage (/Chats/getAllMessages – Alle Chatnachrichten in der Organisation)	Nicht unterstützt	Nicht unterstützt	Chat.Read.All
chatMessage (/users/{id}/chats/getAllMessages –- Chatnachrichten für alle Chats, an denen ein bestimmter Benutzer beteiligt ist)	Chat.Read, Chat.ReadWrite	Nicht unterstützt	Chat.Read.All, Chat.ReadWrite.All
chatMessage /appCatalogs/teamsApps/{id}/installedToChats/getAllMessages Chatnachrichten für alle Chats in einem organization, in dem eine bestimmte Teams-App installiert ist.	Nicht unterstützt	Nicht unterstützt	Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled
contact	Contacts.Read, Subscription.Read.All	Contacts.Read, Subscription.Read.All	Contacts.Read
conversationMember (/teams/{id}/channels/getAllMembers)	Nicht unterstützt	Nicht unterstützt	ChannelMember.Read.All
conversationMember (/chats/getAllMembers)	Nicht unterstützt	Nicht unterstützt	ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All
conversationMember (/chats/{id}/members)	ChatMember.Read, ChatMember.ReadWrite, Chat.ReadBasic, Chat.Read, Chat.ReadWrite	Nicht unterstützt	ChatMember.Read.Chat*, Chat.Manage.Chat*, ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All
conversationMember /appCatalogs/teamsApps/{id}/installedToChats/getAllMembers Chatmitglieder für alle Chats in einem organization, in dem eine bestimmte Teams-App installiert ist.	Nicht unterstützt	Nicht unterstützt	ChatMember.Read.WhereInstalled, ChatMember.ReadWrite.WhereInstalled, Chat.ReadBasic.WhereInstalled, Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled
conversationMember (/teams/{id}/members)	TeamMember.Read.All, Subscription.Read.All	Nicht unterstützt	TeamMember.Read.All
driveItem (persönliche OneDrive-Umgebung eines Benutzers)	Nicht unterstützt	Files.ReadWrite, Subscription.Read.All	Nicht unterstützt
driveItem (OneDrive for Business)	Files.ReadWrite.All, Subscription.Read.All	Nicht unterstützt	Files.ReadWrite.All
event	Calendars.Read, Subscription.Read.All	Calendars.Read, Subscription.Read.All	Calendars.Read
group	Group.Read.All, Subscription.Read.All	Nicht unterstützt	Group.Read.All
group conversation	Group.Read.All, Subscription.Read.All	Nicht unterstützt	Nicht unterstützt
list	Sites.ReadWrite.All, Subscription.Read.All	Nicht unterstützt	Sites.ReadWrite.All
message	Mail.ReadBasic, Mail.Read, Subscription.Read.All	Mail.ReadBasic, Mail.Read, Subscription.Read.All	Mail.Read
presence	Presence.Read.All, Subscription.Read.All	Nicht unterstützt	Nicht unterstützt
Drucker	Nicht unterstützt	Nicht unterstützt	Printer.Read.All, Printer.ReadWrite.All
printTaskDefinition	Nicht unterstützt	Nicht unterstützt	PrintTaskDefinition.ReadWrite.All
security alert	SecurityEvents.ReadWrite.All, Subscription.Read.All	Nicht unterstützt	SecurityEvents.ReadWrite.All
Team (/teams – alle Teams in einer Organisation)	Nicht unterstützt	Nicht unterstützt	Team.ReadBasic.All, TeamSettings.Read.All
team (/teams/{id})	Team.ReadBasic.All, TeamSettings.Read.All, Subscription.Read.All	Nicht unterstützt	Team.ReadBasic.All, TeamSettings.Read.All
todoTask	Tasks.ReadWrite, Subscription.Read.All	Tasks.ReadWrite, Subscription.Read.All	Nicht unterstützt
user	User.Read.All, Subscription.Read.All	User.Read.All	User.Read.All

Hinweis: Mit * markierte Berechtigungen verwenden ressourcenspezifische Zustimmung.

Antwort-Ergebnisse basieren auf dem Kontext der aufrufenden App. In den folgenden Abschnitten werden die gängigen Szenarien beschrieben.

Grundlegende Szenarien

In den meisten Fällen möchte eine Anwendung diejenigen Abonnements abrufen, die sie ursprünglich für den derzeit angemeldeten Benutzer oder für alle Benutzer im Verzeichnis (Firmen-oder Schulkonten) erstellt hat. Für diese Szenarien sind keine speziellen Berechtigungen erforderlich, die über die berechtigungen hinausgehen, die die App ursprünglich zum Erstellen ihrer Abonnements verwendet hat.

Kontext der aufrufenden Anwendung	Die Antwort enthält
App ruft im Auftrag des angemeldeten Benutzers ab (delegierte Berechtigung). -und- Die App besitzt die ursprüngliche Berechtigung, die benötigt wurde, um das Abonnement zu erstellen. Hinweis: Dies gilt sowohl für persönliche Microsoft-Konten als auch für Firmen- oder Schulkonten.	Abonnements, die von dieser App einzig für den angemeldeten Benutzer erstellt wurden.
Die App ruft im eigenen Namen ab (Anwendungsberechtigung). -und- Die App besitzt die ursprüngliche Berechtigung, die benötigt wurde, um das Abonnement zu erstellen. Hinweis: Dies gilt nur für Geschäfts-, Schul- oder Unikonten.	Abonnements, die von dieser App für sich selbst oder für alle Benutzer im Verzeichnis erstellt wurden.

Erweiterte Szenarien

In einigen Fällen möchte eine App von anderen Apps erstellte Abonnements abrufen. Ein Benutzer möchte z. B. alle Abonnements anzeigen, die mit jeglichen Apps in seinem Auftrag erstellt wurden. Oder ein Administrator könnte alle Abonnements einsehen wollen, die von allen Apps in seinem Verzeichnis eingerichtet wurden. Für derartige Szenarien wird eine delegierte Berechtigung Subscription.Read.All benötigt.

Kontext der aufrufenden Anwendung	Die Antwort enthält
App ruft im Auftrag des angemeldeten Benutzers ab (delegierte Berechtigung). Der Benutzer besitzt keine Administratorrechte. -und- Die App verfügt über die Berechtigung Subscription.Read.All Hinweis: Dies gilt sowohl für persönliche Microsoft-Konten als auch für Firmen- oder Schulkonten.	Abonnements, die von jeglichen Apps einzig für den angemeldeten Benutzer erstellt wurden.
App ruft im Auftrag des angemeldeten Benutzers ab (delegierte Berechtigung). Der Benutzer ist ein Administrator. -und- Die App verfügt über die Berechtigung Subscription.Read.All Hinweis: Dies gilt nur für Firmen- oder Schulkonten.	Abonnements, die von jeglichen Apps für alle Benutzer im Verzeichnis erstellt wurden.

HTTP-Anforderung

GET /subscriptions

Optionale Abfrageparameter

Diese Methode unterstützt die OData-Abfrageparameter nicht, um die Antwort anzupassen.

Anforderungsheader

Name	Typ	Beschreibung
Authorization	string	Bearer {token}. Erforderlich.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Im Erfolgsfall erzeugt diese Methode einen 200 OKAntwortcode sowie eine Auflistung aller Abonnement-Objekte im Antworttext.

Beispiel

Anforderung

HTTP

GET https://graph.microsoft.com/v1.0/subscriptions

C#

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Subscriptions.GetAsync();

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

CLI

// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc subscriptions list

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Go

import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)



subscriptions, err := graphClient.Subscriptions().Get(context.Background(), nil)

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Java

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

SubscriptionCollectionResponse result = graphClient.subscriptions().get();

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

let subscriptions = await client.api('/subscriptions')
	.get();

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

PHP

<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->subscriptions()->get()->wait();

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

PowerShell

Import-Module Microsoft.Graph.ChangeNotifications

Get-MgSubscription

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Python

from msgraph import GraphServiceClient

graph_client = GraphServiceClient(credentials, scopes)


result = await graph_client.subscriptions.get()

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Die hier angezeigte Antwort kann zur besseren Lesbarkeit gekürzt werden.

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

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#subscriptions",
  "value": [
    {
      "id": "0fc0d6db-0073-42e5-a186-853da75fb308",
      "resource": "Users",
      "applicationId": "24d3b144-21ae-4080-943f-7067b395b913",
      "changeType": "updated,deleted",
      "clientState": null,
      "notificationUrl": "https://webhookappexample.azurewebsites.net/api/notifications",
      "lifecycleNotificationUrl":"https://webhook.azurewebsites.net/api/send/lifecycleNotifications",
      "expirationDateTime": "2018-03-12T05:00:00Z",
      "creatorId": "8ee44408-0679-472c-bc2a-692812af3437",
      "latestSupportedTlsVersion": "v1_2",
      "encryptionCertificate": "",
      "encryptionCertificateId": "",
      "includeResourceData": false,
      "notificationContentType": "application/json"
    }
  ]
}

Hinweis: Der Wert der Eigenschaft clientState wird aus Sicherheitsgründen nicht zurückgegeben.

Wenn eine Anforderung mehrere Seiten voller Daten erzeugt, so enthält die Antwort eine @odata.nextLink Eigenschaft, um die Ergebnisse besser verwalten zu können. Weitere Informationen finden Sie unter Paging der Microsoft Graph-Daten in Ihrer App.