type de ressource exchangeMessageTrace

Espace de noms: microsoft.graph

Représente les informations de suivi d’un e-mail lorsqu’il transite par le Exchange Online organization. Le suivi des messages permet aux administrateurs de suivre le cycle de vie d’un e-mail, de déterminer son status de remise (remis, en attente, en échec ou en quarantaine) et de comprendre les actions qui lui sont appliquées.

Méthodes

Méthode Type de retour Description
Répertorier les suivis des messages Collection exchangeMessageTrace Obtenir une liste des objets exchangeMessageTrace .
Obtenir les détails par destinataire collection exchangeMessageTraceDetail Obtenir une liste des objets exchangeMessageTraceDetail filtrés sur le destinataire.

Propriétés

Propriété Type Description
fromIP String Adresse IP source. Pour les messages entrants, cette valeur correspond à l’adresse IP publique du serveur de messagerie SMTP qui a envoyé le message.

Prend en charge $filter (eq).
id String Identifiant unique du suivi des messages.

Prend en charge $filter (eq).
ID de message String Champ d’en-tête Message-ID du message. Le format du paramètre Message-ID est fonction du serveur de messagerie.

Prend en charge $filter (eq).
receivedDateTime DateTimeOffset Date et heure de réception du message par Exchange Online. L’horodatage est au format UTC.

Prend en charge $filter (ge, le).
adressedestinataire String Adresse e-mail SMTP de l’utilisateur auquel le message était adressé.

Prend en charge $filter (eq).
senderAddress String L’adresse e-mail SMTP de l’utilisateur dont provient prétendument le message.

Prend en charge $filter (eq).
size Int32 Taille du message en octets.
status exchangeMessageTraceStatus Le status de remise du message. Les valeurs possibles sont : gettingStatus, , failedpending, , expandeddelivered, quarantined, filteredAsSpamunknownFutureValuerecalled. Utilisez l’en-tête de Prefer: include-unknown-enum-members requête pour obtenir la valeur suivante dans cette énumération évolutive : recalled.

Prend en charge $filter (eq).
sujet String Ligne d’objet du message.

Prend en charge $filter (contains, startsWith, endsWith).
toIP String Adresse IP de destination. Pour les messages sortants, cette valeur correspond à l’adresse IP publique dans l’enregistrement MX résolu pour le domaine de destination. Pour les messages entrants vers Exchange Online, cette valeur est vide.

Prend en charge $filter (eq).

Configuration requise

Avant de pouvoir utiliser l’API Liste, suivi des messages ou Obtenir des détails par destinataire, vous devez approvisionner un principal de service dans votre locataire pour l’application Microsoft avec l’ID d’application (client) suivant : 8bd644d1-64a1-4d4b-ae52-2e0cbf64e373 L’approvisionnement du principal de service crée une représentation locale de l’application dans votre client et active l’authentification et l’autorisation pour ces API.

Pour approvisionner le principal du service, procédez comme suit :

  1. Connectez-vous à Microsoft Graph PowerShell : 
    Connect-MgGraph -Scopes "Application.ReadWrite.All"
  2. Exécutez la commande suivante pour approvisionner le principal du service : 
    New-MgServicePrincipal -AppId 8bd644d1-64a1-4d4b-ae52-2e0cbf64e373

Relations

Aucun.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "@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"
}
  • Dernière mise à jour :