Partager via

Type de ressource mailAssessmentRequest

  • Article

Espace de noms: microsoft.graph

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 .

Utilisé pour créer et récupérer une évaluation des menaces par courrier, dérivée de threatAssessmentRequest.

Lorsque vous créez une demande d’évaluation des menaces de messagerie, le message doit être reçu par l’utilisateur spécifié dans recipientEmail. Des autorisations de messagerie déléguées (Mail.Read ou Mail.Read.Shared) sont requises pour accéder au courrier reçu par l’utilisateur ou partagé par quelqu’un d’autre.

Méthodes

Méthode Type renvoyé Description
Créer mailAssessmentRequest Create une nouvelle demande d’évaluation de messagerie en publiant un objet mailAssessmentRequest.
Obtenir mailAssessmentRequest Lisez les propriétés et les relations d’un objet mailAssessmentRequest .

Propriétés

Propriété Type Description
destinationRoutingReason mailDestinationRoutingReason Raison pour laquelle le courrier a été routé vers sa destination. Les valeurs possibles sont , nonemailFlowRule, safeSender, blockedSender, advancedSpamFiltering, domainAllowListdomainBlockList, notInAddressBook, firstTimeSender, autoPurgeToInbox, autoPurgeToJunk, notJunkautoPurgeToDeletedoutbound, . junk
messageUri Chaîne URI de ressource du message électronique pour l’évaluation.
recipientEmail Chaîne Destinataire du courrier dont les stratégies sont utilisées pour évaluer le courrier.
category threatCategory Catégorie de menace. Les valeurs possibles sont spam, phishing et malware.
contentType threatAssessmentContentType Type de contenu de l’évaluation des menaces. Les valeurs possibles sont mail, url et file.
createdBy identitySet Créateur de la demande d’évaluation des menaces.
createdDateTime DateTimeOffset Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
expectedAssessment threatExpectedAssessment Évaluation attendue de l’émetteur. Les valeurs possibles sont les suivantes : block, unblock.
id Chaîne L’ID de demande d’évaluation des menaces est un identificateur global unique (GUID).
requestSource threatAssessmentRequestSource Source de la demande d’évaluation des menaces. Les valeurs possibles sont les suivantes : user, administrator.
status threatAssessmentStatus Le processus d’évaluation status. Les valeurs possibles sont les suivantes : pending, completed.

Relations

Relation Type Description
results collection threatAssessmentResult Collection de résultats d’évaluation des menaces. En lecture seule. Par défaut, un GET /threatAssessmentRequests/{id} ne retourne pas cette propriété, sauf si vous l’appliquez $expand .

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "destinationRoutingReason": "String",
  "messageUri": "String",
  "recipientEmail": "String",
  "category": "String",
  "contentType": "String",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "expectedAssessment": "String",
  "id": "String (identifier)",
  "requestSource": "String",
  "status": "String"
}