mailAssessmentRequest-Ressourcentyp

Wird verwendet, um eine E-Mail-Bedrohungsbewertung zu erstellen und abzurufen, die von threatAssessmentRequest abgeleitet wird.

Wenn Sie eine E-Mail-Bedrohungsbewertungsanforderung erstellen, sollte die E-Mail von dem in recipientEmailangegebenen Benutzer empfangen werden. Delegierte E-Mail-Berechtigungen (Mail.Read oder Mail.Read.Shared) sind erforderlich, um auf die vom Benutzer empfangenen oder von einer anderen Person freigegebenen E-Mails zuzugreifen.

Methoden

Methode	Rückgabetyp	Beschreibung
Erstellen von threatAssessmentRequest	mailAssessmentRequest	Erstellen Sie eine neue E-Mail-Bewertungsanforderung, indem Sie ein mailAssessmentRequest-Objekt veröffentlichen.
Abrufen von threatAssessmentRequest	mailAssessmentRequest	Liest die Eigenschaften und Beziehungen eines mailAssessmentRequest-Objekts .

Eigenschaften

Eigenschaft	Typ	Beschreibung
category	threatCategory	Die Bedrohungskategorie. Mögliche Werte sind: spam, phishing und malware.
contentType	threatAssessmentContentType	Der Inhaltstyp der Bedrohungsbewertung. Mögliche Werte sind: mail, url und file.
createdBy	identitySet	Der Ersteller der Bedrohungsbewertungsanforderung.
createdDateTime	DateTimeOffset	Der Typ „Zeitstempel“ stellt die Datums- und Uhrzeitinformationen im Format der ISO 8601 dar und gibt immer die UTC an. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
destinationRoutingReason	mailDestinationRoutingReason	Der Grund für E-Mails, die an ihr Ziel weitergeleitet wurden. Mögliche Werte sind: none, mailFlowRule, safeSender, blockedSender, advancedSpamFiltering, , domainAllowList, notInAddressBookdomainBlockList, firstTimeSender, autoPurgeToInbox, autoPurgeToJunk, autoPurgeToDeletedoutbound, , notJunk, . junk
expectedAssessment	threatExpectedAssessment	Die erwartete Bewertung durch den Übermittlungsenden. Mögliche Werte: block, unblock.
id	String	Die Anforderungs-ID der Bedrohungsbewertung ist eine GUID (Globally Unique Identifier).
messageUri	String	Der Ressourcen-URI der E-Mail-Nachricht für die Bewertung.
recipientEmail	String	Der E-Mail-Empfänger, dessen Richtlinien zum Bewerten der E-Mail verwendet werden.
requestSource	threatAssessmentRequestSource	Die Quelle der Bedrohungsbewertungsanforderung. Mögliche Werte sind: administrator.
status	threatAssessmentStatus	Der Bewertungsprozess status. Mögliche Werte: pending, completed.

Beziehungen

Beziehung	Typ	Beschreibung
results	threatAssessmentResult-Sammlung	Eine Sammlung von Ergebnissen der Bedrohungsbewertung. Schreibgeschützt. Standardmäßig gibt eine GET /threatAssessmentRequests/{id} diese Eigenschaft nur dann zurück, wenn Sie sie anwenden $expand .

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "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"
}