Udostępnij za pośrednictwem


Zdarzenia zadań do wykonania firmy Microsoft

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.