Partager via

Type de ressource mailAssessmentRequest

  • Article

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
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.
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
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).
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.
requestSource threatAssessmentRequestSource Source de la demande d’évaluation des menaces. Les valeurs possibles sont : 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"
}