mailAssessmentRequest-Ressourcentyp

Wird verwendet, um eine E-Mail-Bedrohungsbewertung zu erstellen und abzurufen, die von threatAssessmentRequestabgeleitet wurde.

Wenn Sie eine Anforderung zur Bewertung der E-Mail-Bedrohung erstellen, sollte die E-Mail von dem in angegebenen Benutzer empfangen recipientEmail werden. Delegierte E-Mail-Berechtigungen (Mail.Read oder Mail.Read.Shared) werden für den Zugriff auf die vom Benutzer empfangenen oder von einer anderen Person freigegebenen E-Mails erneut abgefragt.

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 Lesen der Eigenschaften und Beziehungen eines mailAssessmentRequest-Objekts.

Eigenschaften

Eigenschaft Typ Beschreibung
destinationRoutingReason mailDestinationRoutingReason Der Grund für die Weiterleitung von E-Mails an das Ziel. Mögliche Werte sind: none , , , , , , , , , mailFlowRule , , safeSender , , , blockedSender advancedSpamFiltering domainAllowList , domainBlockList notInAddressBook firstTimeSender autoPurgeToInbox autoPurgeToJunk autoPurgeToDeleted outbound notJunk junk .
messageUri Zeichenfolge Der Ressourcen-URI der E-Mail-Nachricht für die Bewertung.
recipientEmail Zeichenfolge Der E-Mail-Empfänger, dessen Richtlinien zum Bewerten der E-Mail verwendet werden.
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.
expectedAssessment threatExpectedAssessment Die erwartete Bewertung vom Submitter. Mögliche Werte: block, unblock.
id Zeichenfolge Die Anforderungs-ID für die Bedrohungsbewertung ist eine GUID (Globally Unique Identifier).
requestSource threatAssessmentRequestSource Die Quelle der Anforderung zur Bedrohungsbewertung. Mögliche Werte sind: administrator .
status threatAssessmentStatus Der Status des Bewertungsprozesses. Mögliche Werte: pending, completed.

Beziehungen

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

JSON-Darstellung

Es folgt eine JSON-Darstellung der 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"
}