Microsoft SharePoint-Ereignisse

  • Artikel

Dieser Artikel enthält die Eigenschaften und das Schema für Microsoft SharePoint-Ereignisse, die von der Microsoft Graph-API veröffentlicht werden. Eine Einführung in Ereignisschemas finden Sie unter CloudEvents-Schema.

Verfügbare Ereignistypen

Diese Ereignisse werden ausgelöst, wenn ein listItem aktualisiert wird, indem diese Ressourcen mithilfe der Microsoft Graph-API ausgeführt werden.

Ereignisname Beschreibung
Microsoft.Graph.ListUpdated Wird ausgelöst, wenn eine Liste in Microsoft Sharepoint aktualisiert wird.

Beispielereignis

Wenn ein Ereignis ausgelöst wird, sendet der Event Grid-Dienst Daten zu diesem Ereignis an Ziele, die es abonniert haben. Dieser Abschnitt enthält ein Beispiel dafür, wie diese Daten für jedes Microsoft SharePoint-Ereignis aussehen würden.

Microsoft.Graph.ListUpdated-Ereignis

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.ListUpdated",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "listItem/<listItem-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "subscriptionId": "<microsoft-graph-subscription-id>",
    "tenantId": "<tenant-id>",
    "clientState": "<user-provided secret>",
    "expirationDateTime": "2023-10-05T18:11:08.587Z",
    "resource": "<guid>",
    "siteUrl": "<relative path>",
    "webId": "<guid>",
    "resourceData": {
      "@odata.type": "#Microsoft.Graph.listItem"
    },    
  }
}

Ereigniseigenschaften

Ein Ereignis weist die folgenden Daten auf oberster Ebene aus:

Eigenschaft Type Beschreibung
source Zeichenfolge Die Mandantenereignisquelle. Dieses Feld ist nicht beschreibbar. Die Microsoft Graph-API stellt diesen Wert bereit.
subject Zeichenfolge Vom Herausgeber definierter Pfad zum Ereignisbetreff
type Zeichenfolge Einer der Ereignistypen für diese Ereignisquelle.
time Zeichenfolge Die Zeit, in der das Ereignis generiert wird, basierend auf der UTC-Zeitangabe des Anbieters.
id Zeichenfolge Eindeutiger Bezeichner für das Ereignis.
data Objekt (object) Ereignisnutzdaten, die die Daten zur Änderung des Ressourcenzustands bereitstellen.
specversion Zeichenfolge Version der CloudEvents-Schemaspezifikation.

Das Datenobjekt weist die folgenden Eigenschaften auf:

Eigenschaft Type Beschreibung
changeType Zeichenfolge Der Typ der Ressourcenstatusänderung.
resource Zeichenfolge Der Ressourcenbezeichner, für den das Ereignis ausgelöst wurde.
tenantId Zeichenfolge Die Organisations-ID, in der die Liste aufbewahrt wird.
clientState Zeichenfolge Ein Geheimnis, das vom Benutzer zum Zeitpunkt der Graph-API-Abonnementerstellung bereitgestellt wird.
@odata.type Zeichenfolge Der Graph-API-Änderungstyp.
@odata.id Zeichenfolge Der Graph-API-Ressourcenbezeichner, für den das Ereignis ausgelöst wurde.
id Zeichenfolge Der Ressourcenbezeichner, für den das Ereignis ausgelöst wurde.
subscriptionExpirationDateTime Zeichenfolge Der Zeitpunkt im RFC 3339-Format, zu dem das Graph-API-Abonnement abläuft.
subscriptionId Zeichenfolge Der Graph-API-Abonnementbezeichner.
tenantId Zeichenfolge Die Microsoft Entra Mandanten-ID.

Nächste Schritte