Dela via

Microsoft ToDo-händelser

  • Artikel

Den här artikeln innehåller egenskaper och schema för Händelser i Microsoft ToDo Task som publiceras av Microsoft Graph API. En introduktion till händelsescheman finns i CloudEvents-schema.

Tillgängliga händelsetyper

Dessa händelser utlöses när en todoTask skapas, uppdateras eller tas bort genom användning av dessa resurser med hjälp av Microsoft Graph API. Observera att du bara kan prenumerera på ändringar från en specifik uppgiftslista.

Händelsenamn beskrivning
Microsoft.Graph.ToDoCreated Utlöses när en todoTask i Microsoft ToDo-uppgiftslistan skapas.
Microsoft.Graph.ToDoUpdated Utlöses när en todoTask i Microsoft ToDo-uppgiftslistan uppdateras.
Microsoft.Graph.ToDoDeleted Utlöses när en todoTask i Microsoft ToDo-uppgiftslistan tas bort.

Exempelhändelse

När en händelse utlöses skickar Event Grid-tjänsten data om händelsen till prenumererande mål. Det här avsnittet innehåller ett exempel på hur dessa data skulle se ut för varje Microsoft Security Alert-händelse.

Microsoft.Graph.ToDoCreated-händelse

{
  "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-händelse

{
  "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-händelse

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

Händelseegenskaper

En händelse har följande data på den översta nivån:

Property Type Description
source sträng Klienthändelsekällan. Det här fältet kan inte skrivas. Microsoft Graph API tillhandahåller det här värdet.
subject sträng Utgivardefinierad sökväg till händelseobjektet.
type sträng En av händelsetyperna för den här händelsekällan.
time sträng Den tid då händelsen genereras baserat på leverantörens UTC-tid
id sträng Unik identifierare för händelsen.
data objekt Händelsenyttolast som innehåller data om resurstillståndsändringen.
specversion sträng CloudEvents schemaspecifikationsversion.

Dataobjektet har följande egenskaper:

Property Type Description
changeType sträng Typ av ändring av resurstillstånd.
resource sträng Resursidentifieraren som händelsen skapades för.
tenantId sträng Organisations-ID:t där aviseringen utlöstes.
clientState sträng En hemlighet som tillhandahålls av användaren när Graph API-prenumerationen skapas.
@odata.type sträng Ändringstypen för Graph API.
@odata.id sträng Graph API-resursidentifieraren som händelsen skapades för.
id sträng Resursidentifieraren som händelsen skapades för.
subscriptionExpirationDateTime sträng Tiden i RFC 3339-format där Graph API-prenumerationen upphör att gälla.
subscriptionId sträng Graph API-prenumerationsidentifieraren.
tenantId sträng Microsoft Entra-klientidentifieraren.

Nästa steg