Tipo de recurso threatSubmission

Espacio de nombres: microsoft.graph.security

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.

Representa un informe de un elemento a Microsoft Defender para Office 365 para su análisis y a fin de confirmar si el elemento es malintencionado o seguro. Los elementos pueden incluir un correo electrónico, un archivo adjunto de correo electrónico o una dirección URL. Los usuarios pueden enviar un informe en el portal de Microsoft 365 Defender (https://security.microsoft.com).

Este recurso puede representar una amenaza: un caso de falso negativo de un correo electrónico que puede ser malware, suplantación de identidad (phishing) o spam, o un archivo adjunto malicioso a un correo electrónico, o una dirección URL malintencionada. O puede representar un caso falso positivo en el que un correo electrónico, datos adjuntos o URL son legítimos pero están bloqueados por Microsoft Defender para Office 365, por ejemplo, un correo electrónico que no es correo no deseado o un archivo adjunto de correo electrónico o una dirección URL segura. Los casos de falsos negativos y falsos positivos podrían haberse permitido o bloqueado, respectivamente, por directivas de inquilino que anulan a Microsoft Defender para Office 365.

Este recurso es de tipo abstracto. Es el tipo base para emailThreatSubmission, fileThreatSubmission y urlThreatSubmission.

Propiedades

Propiedad Tipo Descripción
adminReview security.submissionAdminReview Especifica la propiedad de revisión del administrador que constituye quién revisó el envío del usuario, cuándo y como se identificó.
categoría submissionCategory Especifica la categoría del envío. Admite $filter = category eq 'value'. Los valores posibles son: notJunk, spam, phishing, malwarey unkownFutureValue.
clientSource submissionClientSource Especifica el origen del envío. Los valores posibles son microsoft, other, y unkownFutureValue.
contentType submissionContentType Especifica el tipo de contenido que se va a enviar. Los valores posibles son: email, url, file, appy unkownFutureValue.
createdBy security.submissionUserIdentity Especifica quién envió el correo electrónico como una amenaza. Admite $filter = createdBy/email eq 'value'.
createdDateTime DateTimeOffset Especifica cuándo se creó el envío de amenaza. Admite $filter = createdDateTime ge 2022-01-01T00:00:00Z and createdDateTime lt 2022-01-02T00:00:00Z.
id Cadena Especifica el identificador del envío de amenazas.
result security.submissionResult Especifica el resultado del análisis realizado por Microsoft.
source submissionSource Especifica el rol del remitente. Admite $filter = source eq 'value'. Los valores posibles son administrator, user, y unkownFutureValue.
status longRunningOperationStatus Indica si Microsoft ha analizado el envío de amenaza. Admite $filter = status eq 'value'. Los valores posibles son: notStarted, running, succeeded, failed, skipped y unkownFutureValue.
tenantId Cadena Indica el identificador de inquilino del remitente. No es necesario cuando se crea mediante una POST operación. Se extrae del token de la llamada posterior a la API.

Relaciones

Ninguna.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "@odata.type": "#microsoft.graph.security.threatSubmission",
  "id": "String (identifier)",
  "tenantId": "String",
  "createdDateTime": "String (timestamp)",
  "contentType": "String",
  "category": "String",
  "source": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.security.submissionUserIdentity"
  },
  "status": "String",
  "result": {
    "@odata.type": "microsoft.graph.security.submissionResult"
  },
  "adminReview": {
    "@odata.type": "microsoft.graph.security.submissionAdminReview"
  },
  "clientSource": "String"
}
  • Last updated on