Tipo de recurso mailAssessmentRequest

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

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	Create 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	Description
destinationRoutingReason	mailDestinationRoutingReason	El motivo del correo enrutado a su destino. Los valores posibles son: , , , , blockedSenderadvancedSpamFiltering, domainAllowList, domainBlockList, notInAddressBook, , firstTimeSender, autoPurgeToInbox, autoPurgeToJunk, autoPurgeToDeleted, outbound, , junknotJunk. safeSendermailFlowRulenone
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.
categoría	threatCategory	Categoría de amenaza. Los valores posibles son: spam, phishing y malware.
contentType	threatAssessmentContentType	Tipo de contenido de evaluación de amenazas. Los valores posibles son: mail, url y 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.
expectedAssessment	threatExpectedAssessment	La evaluación esperada del remitente. Los valores posibles son block y unblock.
id	Cadena	El identificador de solicitud de evaluación de amenazas es un identificador único global (GUID).
requestSource	threatAssessmentRequestSource	Origen de la solicitud de evaluación de amenazas. Los valores posibles son user y administrator.
status	threatAssessmentStatus	Estado del proceso de evaluación. Los valores posibles son pending y 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"
}