Delen via

Microsoft ToDo-gebeurtenissen

  • Artikel

Dit artikel bevat de eigenschappen en het schema voor Microsoft ToDo-taak gebeurtenissen, die worden gepubliceerd door Microsoft Graph API. Zie Het CloudEvents-schema voor een inleiding tot gebeurtenisschema's.

Beschikbare gebeurtenistypen

Deze gebeurtenissen worden geactiveerd wanneer een todoTask wordt gemaakt, bijgewerkt of verwijderd door deze resources te gebruiken met behulp van Microsoft Graph API. U kunt zich alleen abonneren op wijzigingen in een specifieke takenlijst.

Gebeurtenisnaam Beschrijving
Microsoft.Graph.ToDoCreated Geactiveerd wanneer een todoTask in Microsoft ToDo-takenlijst wordt gemaakt.
Microsoft.Graph.ToDoUpdated Geactiveerd wanneer een todoTask in De takenlijst van Microsoft ToDo wordt bijgewerkt.
Microsoft.Graph.ToDoDeleted Geactiveerd wanneer een todoTask in Microsoft ToDo-takenlijst wordt verwijderd.

Voorbeeld van een gebeurtenis

Wanneer een gebeurtenis wordt geactiveerd, verzendt de Event Grid-service gegevens over die gebeurtenis om bestemmingen te abonneren. Deze sectie bevat een voorbeeld van hoe die gegevens eruit zouden zien voor elke Microsoft Security Alert-gebeurtenis.

Microsoft.Graph.ToDoCreated-gebeurtenis

{
  "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-gebeurtenis

{
  "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-gebeurtenis

{
  "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"
    }
  }
}

Eigenschappen van gebeurtenis

Een gebeurtenis bevat de volgende gegevens op het hoogste niveau:

Eigenschap Type Omschrijving
source tekenreeks De bron van de tenant-gebeurtenis. Dit veld kan niet worden geschreven. Microsoft Graph API biedt deze waarde.
subject tekenreeks Het door de uitgever gedefinieerde pad naar het gebeurtenisonderwerp.
type tekenreeks Een van de gebeurtenistypen voor deze gebeurtenisbron.
time tekenreeks Het tijdstip waarop de gebeurtenis wordt gegenereerd op basis van de UTC-tijd van de provider
id tekenreeks Unieke id voor de gebeurtenis.
data object Nettolading van gebeurtenissen die de gegevens over de wijziging van de resourcestatus levert.
specversion tekenreeks CloudEvents schemaspecificatieversie.

Het gegevensobject heeft de volgende eigenschappen:

Eigenschap Type Omschrijving
changeType tekenreeks Het type resourcestatuswijziging.
resource tekenreeks De resource-id waarvoor de gebeurtenis is gegenereerd.
tenantId tekenreeks De organisatie-id waar de waarschuwing is gegenereerd.
clientState tekenreeks Een geheim dat door de gebruiker wordt verstrekt op het moment dat het Graph API-abonnement is gemaakt.
@odata.type tekenreeks Het type Graph API-wijziging.
@odata.id tekenreeks De Graph API-resource-id waarvoor de gebeurtenis is gegenereerd.
id tekenreeks De resource-id waarvoor de gebeurtenis is gegenereerd.
subscriptionExpirationDateTime tekenreeks De tijd in RFC 3339-indeling waarop het Graph API-abonnement verloopt.
subscriptionId tekenreeks De Graph API-abonnements-id.
tenantId tekenreeks De Tenant-id van Microsoft Entra.

Volgende stappen