Udostępnij za pośrednictwem


Zdarzenia usługi Microsoft OneDrive

Ten artykuł zawiera właściwości i schemat zdarzeń usługi Microsoft OneDrive publikowanych przez interfejs API programu Microsoft Graph. Aby zapoznać się ze schematami zdarzeń, zobacz Schemat CloudEvents.

Dostępne typy zdarzeń

Te zdarzenia są wyzwalane po zaktualizowaniu elementu driveItem przez działanie tych zasobów przy użyciu interfejsu API programu Microsoft Graph.

Nazwa zdarzenia opis
Microsoft.Graph.DriveItemUpdated To zdarzenie jest wyzwalane, gdy zawartość w hierarchii dysku folderu głównegoItem w OneDrive dla Firm lub folderu głównego lub podfolderu driveItem w osobistej usłudze OneDrive użytkownika jest aktualizowana.

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 te dane będą wyglądać dla każdego zdarzenia usługi Microsoft OneDrive.

Zdarzenie Microsoft.Graph.DriveItemUpdated

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.DriveItemUpdated",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "driveItem/<driveItem-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "subscriptionId": "<microsoft-graph-subscription-id>",
    "tenantId": "<tenant-id>",
    "clientState": "<user-provided secret>",
    "expirationDateTime": "2023-10-05T18:11:08.587Z",
    "resource": "<guid>",
    "siteUrl": "<sharepoint relative URL>",
    "webId": "<guid>",
    "resourceData": {
      "@odata.type": "#Microsoft.Graph.driveItem"
    },    
  }
}

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 jest przechowywany element driveItem.
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.