exchangeMessageTrace tipo de recurso

Namespace: microsoft.graph

Representa as informações de rastreamento de uma mensagem de email à medida que ela passa pela organização do Exchange Online. O rastreamento de mensagens permite que os administradores de locatários rastreiem o ciclo de vida de um email, determinem seu status de entrega — entregue, pendente, com falha ou em quarentena — e entendam as ações aplicadas a ele.

Métodos

Método Tipo de retorno Descrição
Listar rastreamentos de mensagens Coleção exchangeMessageTrace Obtenha uma lista de objetos exchangeMessageTrace .
Obter detalhes por destinatário Coleção exchangeMessageTraceDetail Obtenha uma lista de objetos exchangeMessageTraceDetail filtrados no destinatário.

Propriedades

Propriedade Tipo Descrição
do IP Cadeia de caracteres O endereço IP de origem. Para mensagens de entrada, esse valor é o endereço IP público do servidor de email SMTP que enviou a mensagem.

Suporta $filter (eq).
id Cadeia de caracteres O identificador exclusivo para o rastreamento de mensagens.

Suporta $filter (eq).
messageId Cadeia de caracteres O campo de cabeçalho Message-ID da mensagem. O formato da Message-ID depende do Messaging Server que envia a mensagem.

Suporta $filter (eq).
receivedDateTime DateTimeOffset A data e a hora em que a mensagem foi recebida pelo Exchange Online. O carimbo de data/hora está no formato UTC.

Suporta $filter (ge, le).
endereço de destinatário Cadeia de caracteres O endereço de email SMTP do usuário para o qual a mensagem foi endereçada.

Suporta $filter (eq).
senderAddress Cadeia de caracteres O endereço de email SMTP do usuário do qual a mensagem supostamente era.

Suporta $filter (eq).
size Int32 O tamanho da mensagem em bytes.
status exchangeMessageTraceStatus O status de entrega da mensagem. Os valores possíveis são: gettingStatus, pending, failed, deliveredexpanded, , quarantined, , filteredAsSpam, . unknownFutureValue

Suporta $filter (eq).
assunto Cadeia de caracteres A linha de assunto da mensagem.

Suporta $filter (contains, startsWith, endsWith).
toIP Cadeia de caracteres O endereço IP de destino. Para mensagens de saída, esse valor é o endereço IP público no registro MX resolvido para o domínio de destino. Para mensagens de entrada para o Exchange Online, esse valor fica em branco.

Suporta $filter (eq).

Pré-requisitos

Antes de usar as APIs Listar rastreamentos de mensagens ou Obter detalhes por destinatário, você deve provisionar uma entidade de serviço em seu locatário para o aplicativo Microsoft com a seguinte ID de aplicativo (cliente): 8bd644d1-64a1-4d4b-ae52-2e0cbf64e373. O provisionamento da entidade de serviço cria uma representação local do aplicativo em seu locatário e habilita a autenticação e a autorização para essas APIs.

Para provisionar a entidade de serviço, você pode seguir estas etapas:

  1. Conecte-se ao Microsoft Graph PowerShell: 
    Connect-MgGraph -Scopes "Application.ReadWrite.All"
  2. Execute o seguinte comando para provisionar a entidade de serviço: 
    New-MgServicePrincipal -AppId 8bd644d1-64a1-4d4b-ae52-2e0cbf64e373

Relações

Nenhum

Representação JSON

A representação JSON a seguir mostra o 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"
}
  • Last updated on