Delen via

Microsoft OneDrive-gebeurtenissen

  • Artikel

Dit artikel bevat de eigenschappen en het schema voor Microsoft OneDrive-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 driveItem wordt bijgewerkt door deze resources te gebruiken met behulp van Microsoft Graph API.

Gebeurtenisnaam Beschrijving
Microsoft.Graph.DriveItemUpdated Deze gebeurtenis wordt geactiveerd wanneer inhoud in de hiërarchie van een hoofdmap driveItem in OneDrive voor Bedrijven, of van een hoofdmap of submap driveItem in de persoonlijke OneDrive van een gebruiker wordt bijgewerkt.

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 OneDrive-gebeurtenis.

Microsoft.Graph.DriveItemUpdated-gebeurtenis

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

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 driveItem wordt bewaard.
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