Dela via

Microsoft OneDrive-händelser

  • Artikel

Den här artikeln innehåller egenskaper och schema för Microsoft OneDrive-händelser 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 driveItem uppdateras genom att köras över dessa resurser med hjälp av Microsoft Graph API.

Händelsenamn beskrivning
Microsoft.Graph.DriveItemUpdated Den här händelsen utlöses när innehåll i hierarkin för en rotmappsenhetItem i OneDrive för företag, eller av en rotmapp eller undermappsenhetItem i en användares personliga OneDrive uppdateras.

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 OneDrive-händelse.

Microsoft.Graph.DriveItemUpdated-händelse

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

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 driveItem lagras.
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