Zdarzenia zadań do wykonania firmy Microsoft

Artykuł
12/12/2023

Ten artykuł zawiera właściwości i schemat zdarzeń zadań zadań do wykonania firmy Microsoft, które są publikowane przez interfejs API programu Microsoft Graph. Aby zapoznać się ze schematami zdarzeń, zobacz Schemat CloudEvents.

Dostępne typy zdarzeń

Te zdarzenia są wyzwalane po utworzeniu, zaktualizowaniu lub usunięciu zadania todoTask przez działanie tych zasobów przy użyciu interfejsu API programu Microsoft Graph. Należy pamiętać, że można subskrybować tylko zmiany z określonej listy zadań.

Nazwa zdarzenia	opis
Microsoft.Graph.ToDoCreated	Wyzwalane po utworzeniu listy zadań todoTask w aplikacji Microsoft ToDo.
Microsoft.Graph.ToDoUpdated	Wyzwalane po zaktualizowaniu listy zadań todoTask w usłudze Microsoft ToDo.
Microsoft.Graph.ToDoDeleted	Wyzwalane po usunięciu listy zadań todoTask w usłudze Microsoft ToDo.

Przykładowe zdarzenie

Po wyzwoleniu zdarzenia usługa Event Grid wysyła dane o tym zdarzeniu do subskrybowania miejsc docelowych. Ta sekcja zawiera przykład tego, jak wyglądają te dane dla każdego zdarzenia alertu zabezpieczeń firmy Microsoft.

Zdarzenie Microsoft.Graph.ToDoCreated

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

Zdarzenie Microsoft.Graph.ToDoUpdated

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

Zdarzenie Microsoft.Graph.ToDoDeleted

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

Właściwości zdarzenia

Zdarzenie ma następujące dane najwyższego poziomu:

Właściwość	Type	opis
`source`	string	Źródło zdarzeń dzierżawy. To pole nie jest możliwe do zapisu. Interfejs API programu Microsoft Graph zapewnia tę wartość.
`subject`	string	Zdefiniowana przez wydawcę ścieżka do tematu zdarzenia.
`type`	string	Jeden z typów zdarzeń dla tego źródła zdarzeń.
`time`	string	Czas generowania zdarzenia na podstawie czasu UTC dostawcy
`id`	string	Unikatowy identyfikator zdarzenia.
`data`	obiekt	Ładunek zdarzenia, który dostarcza dane dotyczące zmiany stanu zasobu.
`specversion`	string	Wersja specyfikacji schematu CloudEvents.

Obiekt danych ma następujące właściwości:

Właściwość	Type	opis
`changeType`	string	Typ zmiany stanu zasobu.
`resource`	string	Identyfikator zasobu, dla którego zostało zgłoszone zdarzenie.
`tenantId`	string	Identyfikator organizacji, w którym został zgłoszony alert.
`clientState`	string	Wpis tajny dostarczony przez użytkownika podczas tworzenia subskrypcji interfejsu API programu Graph.
`@odata.type`	string	Typ zmiany interfejsu API programu Graph.
`@odata.id`	string	Identyfikator zasobu interfejsu API programu Graph, dla którego zostało zgłoszone zdarzenie.
`id`	string	Identyfikator zasobu, dla którego zostało zgłoszone zdarzenie.
`subscriptionExpirationDateTime`	string	Czas w formacie RFC 3339 , w którym wygasa subskrypcja interfejsu API programu Graph.
`subscriptionId`	string	Identyfikator subskrypcji interfejsu API programu Graph.
`tenantId`	string	Identyfikator dzierżawy entra firmy Microsoft.

Następne kroki

Aby zapoznać się z wprowadzeniem do zdarzeń partnerskich usługi Azure Event Grid, zobacz Omówienie zdarzeń partnerskich
Aby uzyskać informacje na temat subskrybowania interfejsu API programu Microsoft Graph w celu odbierania zdarzeń, zobacz subskrybowanie zdarzeń interfejsu API programu Microsoft Graph.
Aby uzyskać informacje o programach obsługi zdarzeń usługi Azure Event Grid, zobacz Programy obsługi zdarzeń.
Aby uzyskać więcej informacji na temat tworzenia subskrypcji usługi Azure Event Grid, zobacz tworzenie subskrypcji zdarzeń i schematu subskrypcji usługi Event Grid.
Aby uzyskać informacje o sposobie konfigurowania subskrypcji zdarzeń w celu wybrania określonych zdarzeń do dostarczenia, zobacz filtrowanie zdarzeń. Możesz również odwołać się do zdarzeń filtrowania.

Udostępnij za pośrednictwem