Freigeben über

Microsoft ToDo-Ereignisse

  • Artikel

Dieser Artikel enthält die Eigenschaften und das Schema für Microsoft ToDo Task-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 TodoTask erstellt, aktualisiert oder gelöscht wird, indem diese Ressourcen mithilfe der Microsoft Graph-API ausgeführt werden. Beachten Sie, dass Sie nur Änderungen aus einer bestimmten Aufgabenliste abonnieren können.

Ereignisname Beschreibung
Microsoft.Graph.ToDoCreated Wird ausgelöst, wenn eine TodoTask in microsoft ToDo-Aufgabenliste erstellt wird.
Microsoft.Graph.ToDoUpdated Wird ausgelöst, wenn eine TodoTask in microsoft ToDo-Aufgabenliste aktualisiert wird.
Microsoft.Graph.ToDoDeleted Wird ausgelöst, wenn eine TodoTask in der Aufgabenliste von Microsoft ToDo gelöscht 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 Security Alert-Ereignis aussehen würden.

Microsoft.Graph.ToDoCreated-Ereignis

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.ToDoCreated",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "TodoTask/<ToDoTask-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "expirationDateTime": "2023-10-01T06:21:57-07:00",
    "changeType": "Created",
    "subscriptionId": "<guid>",
    "resource": "todob2/graph/v1/users(<user-id>)/tasks",
    "clientState": "<user-provided secret>",
    "resourceData": {
      "id": "<ToDoTask-id>",
      "@odata.type": "#microsoft.graph.todoTask"
    }
  }
}

Microsoft.Graph.ToDoUpdated-Ereignis

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.ToDoUpdated",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "TodoTask/<ToDoTask-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "expirationDateTime": "2023-10-01T06:21:57-07:00",
    "changeType": "Updated",
    "subscriptionId": "<guid>",
    "resource": "todob2/graph/v1/users(<user-id>)/tasks",
    "clientState": "<user-provided secret>",
    "resourceData": {
      "id": "<ToDoTask-id>",
      "@odata.type": "#microsoft.graph.todoTask"
    }
  }
}

Microsoft.Graph.ToDoDeleted-Ereignis

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.ToDoDeleted",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "TodoTask/<ToDoTask-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "expirationDateTime": "2023-10-01T06:21:57-07:00",
    "changeType": "Deleted",
    "subscriptionId": "<guid>",
    "resource": "todob2/graph/v1/users(<user-id>)/tasks",
    "clientState": "<user-provided secret>",
    "resourceData": {
     "id": "<ToDoTask-id>",
     "@odata.type": "#microsoft.graph.todoTask"
    }
  }
}

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 Warnung ausgelöst wurde.
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