Freigeben über


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 einer Organisation.
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 einer Organisation.
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 einer Organisation, in der 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 einer Organisation, in der 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 einer Organisation, in der 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 für Arbeit oder Schule) 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
offerShiftRequest
(/teams/{id}/schedule/offerShiftRequests)
Änderungen an einer Angebotsverschiebungsanforderung in einem Team.
Schedule.Read.All, Schedule.ReadWrite.All Nicht unterstützt Schedule.Read.All, Schedule.ReadWrite.All
openShiftChangeRequest
(/teams/{id}/schedule/openShiftChangeRequests)
Änderungen an allen offenen Schichtanforderungen in einem Team.
Schedule.Read.All, Schedule.ReadWrite.All Nicht unterstützt Schedule.Read.All, Schedule.ReadWrite.All
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
shift
(/teams/{id}/schedule/shifts)
Änderungen an jeder Verschiebung in einem Team.
Schedule.Read.All, Schedule.ReadWrite.All Nicht unterstützt Schedule.Read.All, Schedule.ReadWrite.All
swapShiftsChangeRequest
(/teams/{id}/schedule/swapShiftsChangeRequests)
Änderungen an allen Verschiebungsanforderungen in einem Team.
Schedule.Read.All, Schedule.ReadWrite.All Nicht unterstützt Schedule.Read.All, Schedule.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
timeOffRequest
(/teams/{id}/schedule/timeOffRequests)
Änderungen an einer Anforderung für eine ausserplanende Zeit in einem Team.
Schedule.Read.All, Schedule.ReadWrite.All Nicht unterstützt Schedule.Read.All, Schedule.ReadWrite.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 globaler Administrator möchte alle Abonnements aller Apps in ihrem Verzeichnis anzeigen. 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 globaler 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. Erfahren Sie mehr über die Authentifizierung und Autorisierung.

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

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

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.