Freigeben über

mailAssessmentRequest-Ressourcentyp

  • Artikel

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

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
Create mailAssessmentRequest Create eine neue E-Mail-Bewertungsanforderung durch Veröffentlichen eines mailAssessmentRequest-Objekts.
Get mailAssessmentRequest Liest die Eigenschaften und Beziehungen eines mailAssessmentRequest-Objekts .

Eigenschaften

Eigenschaft Typ Beschreibung
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
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 durch den Übermittlungsenden. Mögliche Werte: block, unblock.
id Zeichenfolge Die Anforderungs-ID der Bedrohungsbewertung ist eine GUID (Globally Unique Identifier).
requestSource threatAssessmentRequestSource Die Quelle der Bedrohungsbewertungsanforderung. Mögliche Werte sind: user und 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"
}