Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Se usa para crear y recuperar una evaluación de amenazas de correo derivada de threatAssessmentRequest.
Al crear una solicitud de evaluación de amenazas por correo, el usuario especificado en recipientEmail. Los permisos de correo delegado (Mail.Read o Mail.Read.Shared) son necesarios para acceder al correo recibido por el usuario o compartido por otra persona.
Métodos
| Método | Tipo de valor devuelto | Descripción |
|---|---|---|
| Crear | mailAssessmentRequest | Cree una nueva solicitud de evaluación de correo mediante la publicación de un objeto mailAssessmentRequest . |
| Get | mailAssessmentRequest | Lea las propiedades y relaciones de un objeto mailAssessmentRequest . |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| categoría | threatCategory | Categoría de amenaza. Los valores posibles son: spam, phishing, malware. |
| contentType | threatAssessmentContentType | Tipo de contenido de evaluación de amenazas. Los valores posibles son: mail, url, file. |
| createdBy | identitySet | Creador de la solicitud de evaluación de amenazas. |
| createdDateTime | DateTimeOffset | El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. |
| destinationRoutingReason | mailDestinationRoutingReason | El motivo del correo enrutado a su destino. Los valores posibles son: none, mailFlowRule, , safeSender, advancedSpamFilteringblockedSender, domainAllowList, domainBlockList, , notInAddressBook, firstTimeSender, autoPurgeToInbox, autoPurgeToJunk, , autoPurgeToDeleted, outbound, , notJunk. junk |
| expectedAssessment | threatExpectedAssessment | La evaluación esperada del remitente. Los valores posibles son: block, unblock. |
| id | Cadena | El identificador de solicitud de evaluación de amenazas es un identificador único global (GUID). |
| messageUri | Cadena | URI del recurso del mensaje de correo para la evaluación. |
| recipientEmail | Cadena | Destinatario del correo cuyas directivas se usan para evaluar el correo. |
| requestSource | threatAssessmentRequestSource | Origen de la solicitud de evaluación de amenazas. Los valores posibles son: administrator. |
| status | threatAssessmentStatus | Estado del proceso de evaluación. Los valores posibles son: pending, completed. |
Relaciones
| Relación | Tipo | Description |
|---|---|---|
| Resultados | colección threatAssessmentResult | Colección de resultados de evaluación de amenazas. Solo lectura. De forma predeterminada, no GET /threatAssessmentRequests/{id} devuelve esta propiedad a menos que se aplique $expand en ella. |
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"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"
}