Type de ressource mailAssessmentRequest

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 threatAssessmentRequest	mailAssessmentRequest	Créez une demande d’évaluation du courrier en publiant un objet mailAssessmentRequest .
Obtenir threatAssessmentRequest	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"
}