Type de ressource retentionEvent

Article
04/05/2024

Espace de noms : microsoft.graph.security

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Représente un déclencheur pour les étiquettes de rétention basées sur les événements où le début de la période de rétention est basé sur le moment où un type spécifique d’événement se produit. Pour en savoir plus à ce sujet, consultez Démarrer la rétention lorsqu’un événement se produit.

Méthodes

Méthode	Type de retour	Description
Répertorier retentionEvents	collection microsoft.graph.security.retentionEvent	Obtenez la liste des objets retentionEvent et de leurs propriétés.
Créer un événement de rétention	microsoft.graph.security.retentionEvent	Créez un objet retentionEvent .
Obtenir retentionEvent	microsoft.graph.security.retentionEvent	Lisez les propriétés et les relations d’un objet retentionEvent .
Supprimer retentionEvent	Aucune	Supprime un objet retentionEvent .
List retentionEventType	collection microsoft.graph.security.retentionEventType	Obtenez les ressources retentionEventType à partir de la propriété de navigation eventType de l’exapnd.
Créer retentionEventType	microsoft.graph.security.retentionEventType	Ajoutez eventType en ajoutant la propriété odata appropriée lors de la création d’un événement.

Propriétés

Propriété	Type	Description
createdBy	microsoft.graph.identitySet	Utilisateur qui a créé l’événement retentionEvent.
createdDateTime	DateTimeOffset	Date et heure de création de retentionEvent.
description	Chaîne	Informations facultatives sur l’événement.
displayName	Chaîne	Nom de l’événement.
eventPropagationResult	microsoft.graph.security.eventPropagationResult	Représente le status de réussite d’un événement créé et des informations supplémentaires.
eventQuery	collection microsoft.graph.security.eventQuery	Représente la charge de travail (SharePoint Online, OneDrive Entreprise, Exchange Online) et les informations d’identification associées à un événement de rétention.
retentionEventStatus	collection microsoft.graph.security.retentionEventStatus	État de la propogation d’événement aux emplacements délimités après la création de l’événement.
eventTriggerDateTime	DateTimeOffset	Heure facultative à laquelle l’événement doit être déclenché.
id	Chaîne	Représente l’ID unique de l’utilisateur qui a créé l’événement retentionEvent. entité.
lastModifiedBy	microsoft.graph.identitySet	Utilisateur qui a modifié la dernière fois retentionEvent.
lastModifiedDateTime	DateTimeOffset	Date et heure de la dernière modification de retentionEvent.
lastStatusUpdateDateTime	DateTimeOffset	Dernière fois que le status de l’événement a été mis à jour.

Relations

Relation	Type	Description
retentionEventType	microsoft.graph.security.retentionEventType	Spécifie l’événement qui démarrera la période de rétention pour les étiquettes qui utilisent ce type d’événement lors de la création d’un événement.

Représentation JSON

Voici une représentation JSON de la ressource.

{
  "@odata.type": "#microsoft.graph.security.retentionEvent",
  "id": "String (identifier)",
  "displayName": "String",
  "description": "String",
  "eventQueries": [
    {
      "@odata.type": "microsoft.graph.security.eventQuery"
    }
  ],
  "eventTriggerDateTime": "String (timestamp)",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "createdDateTime": "String (timestamp)",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "eventPropagationResults": [
    {
      "@odata.type": "microsoft.graph.security.eventPropagationResult"
    }
  ],
  "eventStatus": {
    "@odata.type": "microsoft.graph.security.retentionEventStatus"
  },
  "lastStatusUpdateDateTime": "String (timestamp)"
}