Tipo de recurso exchangeMessageTrace

Espacio de nombres: microsoft.graph

Representa la información de seguimiento de un mensaje de correo electrónico a medida que pasa por la organización de Exchange Online. El seguimiento de mensajes permite a los administradores de inquilinos realizar un seguimiento del ciclo de vida de un correo electrónico, determinar su estado de entrega (ya sea entregado, pendiente, con errores o en cuarentena) y comprender las acciones que se le aplican.

Métodos

Método Tipo devuelto Description
Enumerar seguimientos de mensajes Colección exchangeMessageTrace Obtener una lista de los objetos exchangeMessageTrace .
Obtener detalles por destinatario colección exchangeMessageTraceDetail Obtener una lista de objetos exchangeMessageTraceDetail filtrados por el destinatario.

Propiedades

Propiedad Tipo Description
fromIP Cadena La dirección IP de origen. Para los mensajes entrantes, este valor es la dirección IP pública del servidor de correo electrónico SMTP que envió el mensaje.

Admite $filter (eq).
id Cadena El identificador único del seguimiento de mensajes.

Admite $filter (eq).
identificador de mensaje Cadena El campo de encabezado de identificador de mensaje del mensaje. El formato de Message-ID depende del servidor de mensajería que envió el mensaje.

Admite $filter (eq).
receivedDateTime DateTimeOffset La fecha y hora en que Exchange Online recibió el mensaje. La marca de tiempo está en formato UTC.

Admite $filter (ge, le).
destinatarioDirección Cadena La dirección de correo electrónico SMTP del usuario al que va dirigido el mensaje.

Admite $filter (eq).
senderAddress Cadena La dirección de correo electrónico SMTP del usuario del que supuestamente procede el mensaje.

Admite $filter (eq).
size Int32 El tamaño del mensaje en bytes.
status exchangeMessageTraceStatus El estado de entrega del mensaje. Los valores posibles son: gettingStatus, pending, failed, deliveredexpanded, quarantined, filteredAsSpam, unknownFutureValue, , recalled, . Use el encabezado de Prefer: include-unknown-enum-members solicitud para obtener el siguiente valor en esta enumeración evolutiva: recalled.

Admite $filter (eq).
subject Cadena La línea de asunto del mensaje.

Admite $filter (contains, startsWith y endsWith).
aIP Cadena La dirección IP de destino. Para los mensajes salientes, este valor es la dirección IP pública en el registro MX resuelto para el dominio de destino. Para los mensajes entrantes a Exchange Online, este valor está en blanco.

Admite $filter (eq).

Requisitos previos

Para poder usar las API de seguimiento de mensajes de lista u Obtener detalles por destinatario , debe aprovisionar una entidad de servicio en el inquilino para la aplicación de Microsoft con el siguiente identificador de aplicación (cliente): 8bd644d1-64a1-4d4b-ae52-2e0cbf64e373. Al aprovisionar la entidad de servicio, se crea una representación local de la aplicación en el inquilino y se habilita la autenticación y autorización para estas API.

Para aprovisionar la entidad de servicio, puede seguir estos pasos:

  1. Conéctese a Microsoft Graph PowerShell: 
    Connect-MgGraph -Scopes "Application.ReadWrite.All"
  2. Ejecute el siguiente comando para aprovisionar la entidad de servicio: 
    New-MgServicePrincipal -AppId 8bd644d1-64a1-4d4b-ae52-2e0cbf64e373

Relaciones

Ninguna.

Representación JSON

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

{
  "@odata.type": "#microsoft.graph.exchangeMessageTrace",
  "fromIP": "String",
  "id": "String (identifier)",
  "messageId": "String",
  "receivedDateTime": "String (timestamp)",
  "recipientAddress": "String",
  "senderAddress": "String",
  "size": "Int32",
  "status": "String",
  "subject": "String",
  "toIP": "String"
}
  • Se actualizó por última vez el