Événements Microsoft OneDrive

  • Article

Cet article fournit les propriétés et le schéma des événements Microsoft OneDrive publiés par l’API Microsoft Graph. Pour une introduction aux schémas d’événements, consultez le schéma CloudEvents.

Types d’événement disponibles

Ces événements sont déclenchés lorsqu’un driveItem est mis à jour en fonctionnant sur ces ressources à l’aide de l’API Microsoft Graph.

Nom de l’événement Description
Microsoft.Graph.DriveItemUpdated Cet événement est déclenché lorsque du contenu dans la hiérarchie d’un driveItem de dossier racine dans OneDrive Entreprise, ou d’un dossier racine ou d’un driveItem de sous-dossier dans oneDrive personnel d’un utilisateur est mis à jour.

Exemple d’événement

Lorsqu’un événement est déclenché, le service Event Grid envoie les données relatives à cet événement aux destinations d’abonnement. Cette section contient un exemple de ce à quoi ressemblent ces données pour chaque événement Microsoft OneDrive.

Événement 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"
    },    
  }
}

Propriétés d’événement

Un événement contient les données générales suivantes :

Propriété Type Description
source string Source d’événement du locataire. Ce champ n’est pas modifiable. L’API Microsoft Graph fournit cette valeur.
subject string Chemin de l’objet de l’événement, défini par le serveur de publication.
type string Un des types d’événements pour cette source d’événement.
time string Heure à laquelle l’événement est généré selon l’heure UTC du fournisseur
id string Identificateur unique de l’événement.
data object Charge utile d’événement qui fournit les données relatives au changement d’état de la ressource.
specversion string Version de la spécification de schéma CloudEvents.

L’objet de données comporte les propriétés suivantes :

Propriété Type Description
changeType string Type de modification de l’état de la ressource.
resource string Identificateur de ressource pour lequel l’événement a été déclenché.
tenantId string ID d’organisation où l’élément driveItem est conservé.
clientState string Secret fourni par l’utilisateur au moment de la création de l’abonnement à l’API Graph.
@odata.type string Type de modification de l’API Graph.
@odata.id string Identificateur de ressource de l’API Graph pour lequel l’événement a été déclenché.
id string Identificateur de ressource pour lequel l’événement a été déclenché.
subscriptionExpirationDateTime string Heure au format RFC 3339 à laquelle l’abonnement à l’API Graph expire.
subscriptionId string Identificateur d’abonnement à l’API Graph.
tenantId string Identificateur du locataire Microsoft Entra.

Étapes suivantes