Relatórios de MailTrafficSummary

O URI do REST MailTrafficSummary fornece uma lista resumida de várias categorias relacionadas a mensagens processadas pelo sistema de email Office 365 da organização. A data de início e término/hora do relatório pode ser especificada na solicitação, assim como o período de tempo para o qual os dados são agregados. Este relatório retorna 20 campos de forma genérica nomeados e os dados nesses campos podem ser alterado com base em outras opções.

Última alteração: quinta-feira, 17 de setembro de 2015

Aplica-se a: Office 365

URIs REST

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailTrafficTop[?ODATA options]

Campos

Os campos a seguir podem ser especificados em Opções de consulta ODATA2 $select, $filtere $orderby . Todos os campos são retornados se nenhuma opção $select for fornecida.

* O Tipo de WCF refere-se ao tipo de dados .NET Framework atribuído ao campo quando você cria um Windows Communication Foundation (WCF) referência de serviço no Visual Studio. O Tipo de EDM refere-se para os tipos de modelo de dados de entidade ADO.NET (EDM) retornados nos relatórios Atom formatada.

* * Para obter informações sobre [/ saída] indicadores, consulte a seção "Parâmetros de entrada e relatar as colunas de saída".

Comentários

Cada entrada no relatório inclui vários campos de metadados. Para obter mais informações, consulte Metadados comum retornados pelo serviço web de relatório do Office 365.

O campo Date indica quando as mensagens foram tratadas pelo sistema Office 365 e informadas no fuso horário desses servidores.

A opção de $orderby ODATA não funciona com este relatório.

Usando StartDate e EndDate

Os campos StartDate e EndDate não fornecem informações úteis nos resultados do relatório e sempre estão definidos para 0001-01-01T00:00:00Z na saída do relatório. Eles servem para habilitar fácil restrição da janela de tempo de relatórios e fornecer mais fina precisão de seria disponíveis em um relatório "diariamente".

Isso pode ser especialmente útil, por exemplo, quando a gravação de ataques de negação de serviço baseados em email em uma base por hora. Ao usar esses campos, você deve incluir ambos na opção $filter . Eles são considerados opcionais, mas se você fornecer um, você precisa fornecer o outro. Se o par StartDate/EndDate não forem fornecido na consulta, o padrão de período de relatório é as duas semanas anteriores. A seção "Exemplos" posteriormente neste tópico mostra como usar os campos StartDate e EndDate .

Categorias e definições de campo Cn

A definição da forma genérica nomeados C1 por meio de C20 campos alterações com base no valor especificado para Category. Para especificar uma categoria, inclua uma expressão correspondente na opção $filter , como no exemplo a seguir.

$filter=Category eq 'TopMailRecipient'

A seguir lista os valores permitidos para o campo Category e o tipo de informação é retornada.

• InboundDLPHits retorna uma lista ordenada do número de vezes que as ações de política de prevention (DLP) de perda de dados indicado foram acionadas durante o período do relatório para mensagens de entrada.

• InboundDLPPolicyRuleHits retorna uma lista ordenada do número de vezes que as ações de regra de política DLP indicadas foram acionadas durante o período do relatório para mensagens de entrada.

• InboundTransportRuleHits retorna uma lista ordenada do número de vezes que as ações de regra de transporte indicadas foram acionadas durante o período do relatório para mensagens de entrada.

• OutboundDLPHits retorna uma lista ordenada do número de vezes que as ações de política de proteção de vazamento de dados (DLP) indicado foram acionadas durante o período do relatório para mensagens de saída.

• OutboundDLPPolicyRuleHits retorna uma lista ordenada do número de vezes que as ações de regra de política DLP indicadas foram acionadas durante o período do relatório para mensagens de saída.

• OutboundTransportRuleHits retorna uma lista ordenada do número de vezes que as ações de regra de transporte indicadas foram acionadas durante o período do relatório para mensagens de saída.

• TopMailSender retorna uma lista ordenada dos usuários que enviou a maioria das email durante o período do relatório.

• TopMailRecipient retorna uma lista ordenada dos usuários que recebeu a maioria das email durante o período do relatório.

• TopMalware retorna uma lista ordenada de malware detectado durante o período do relatório.

• TopMalwareRecipient retorna uma lista ordenada dos usuários que recebeu a maioria das mensagens que contêm malware durante o período do relatório.

• TopSpamRecipient retorna uma lista ordenada dos usuários que recebeu a maioria das mensagens contendo spam durante o período do relatório.

A tabela a seguir lista o valor de categoria e as definições de resultantes dos campos Cn. Somente as colunas que contêm informações estão listadas na tabela. Colunas que não possuem dados no relatório tem um valor nulo. Muitos dos valores retornados nas colunas também aparecem nas listas retornadas pelo relatório MailFilterList . Se você usar a expressão $filter políticas DLP específicas de correspondência, regras DLP ou regras de transporte, use os valores retornados no relatório MailFilterList para garantir correspondências exatos.

Os campos C4-C20 não são usados atualmente e são reservados para expansão futura.

Exemplos

O exemplo a seguir solicita os destinatários de duas email principais para os últimos três meses do 2012. Quebras de linha foram adicionadas para a solicitação e a resposta para manter a clareza.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailTrafficSummary?
  $select=C1,C2,C3&
  $filter=Category%20eq%20'TopMailRecipient'%20and%20
    StartDate%20eq%20datetime'2012-10-01T00:00:00Z'%20and%20
    EndDate%20eq%20datetime'2013-12-31T23:59:59Z'&
  $top=2&
  $format=Atom

<?xml version="1.0" encoding="utf-8"?>
<feed xml:base="https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/" 
  xmlns="http://www.w3.org/2005/Atom" 
  xmlns:d="https://schemas.microsoft.com/ado/2007/08/dataservices" 
  xmlns:m="https://schemas.microsoft.com/ado/2007/08/dataservices/metadata">
  <id>https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailTrafficSummary</id>
  <title type="text">MailTrafficSummary</title>
  <updated>2013-02-09T20:06:36Z</updated>
  <link rel="self" title="MailTrafficSummary" href="MailTrafficSummary" />
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficSummary(0)</id>
    <category term="TenantReporting.MailTrafficSummaryReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailTrafficSummaryReport" href="MailTrafficSummary(0)" />
    <title />
    <updated>2013-02-09T20:06:36Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:C1>userone@example.onmicrosoft.com</d:C1>
        <d:C2>3185</d:C2>
        <d:C3 m:null="true" />
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficSummary(0)</id>
    <category term="TenantReporting.MailTrafficSummaryReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailTrafficSummaryReport" href="MailTrafficSummary(0)" />
    <title />
    <updated>2013-02-09T20:06:36Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:C1>usertwo@example.onmicrosoft.com</d:C1>
        <d:C2>352</d:C2>
        <d:C3 m:null="true" />
      </m:properties>
    </content>
  </entry>
</feed>

O exemplo a seguir mostra os mesmos resultados no formato JSON.

  {
    "d":
      [
          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficSummary(0)",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficSummary(0)",
                "type":"TenantReporting.MailTrafficSummaryReport"
              },
            "C1":"userone@example.onmicrosoft.com",
            "C2":"3185",
            "C3":null
          },
          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficSummary(0)",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficSummary(0)",
                "type":"TenantReporting.MailTrafficSummaryReport"
              },
            "C1":"usetwo@example.onmicrosoft.com",
            "C2":"352",
            "C3":null
          }
      ]
  }

Parâmetros de entrada e relatar colunas de saída

Os indicadores de [/ saída] na tabela campos têm os significados a seguintes:

• Campos marcados [In] nos campos de tabela destinam-se principalmente para uso em $filter=, $orderby=, e outras opções de consulta que restringir quais entradas retorna o relatório. Campos marcados [In] na tabela campos podem ser incluídos na opção $select= e eles serão exibidos nas entradas de relatório, mas que não irão conter nenhum dado útil.

• Campos marcados [/ saída] nos campos de tabela pode ser usada nas opções de ($filter= e $orderby=) da restrição de entrada e seleção de coluna ($select=). Quando você inclui um desses campos na opção $select= , ele aparecerá nas entradas de relatório e irá conter dados úteis quando ele estiver disponível.

Compatibilidade

O relatório de MailTrafficSummary foi introduzido no Office 365 service version 2013-V1. Para obter mais informações sobre o controle de versão, consulte Controle de versão no serviço da web de relatório do Office 365.

Cmdlets do Windows PowerShell correspondentes

O relatório de MailTrafficTop retorna as mesmas informações que o cmdlet Get-MailTrafficSummaryReportWindows PowerShell. 

Permissões

A conta usada para acessar os relatórios deve ter permissões administrativas na organização Office 365. Se a conta pode exibir este relatório no Office 365 painel de controle, a conta tem permissões para recuperar os dados do serviço web REST. Este relatório requer que o usuário a ser atribuído à função destinatários somente para exibição. Na estrutura de permissões de Office 365 padrão, os usuários com as seguintes permissões de administrador podem acessar este relatório: administrador de gerenciamento de usuário, administrador global, administrador de senha, administrador de serviço e administrador de faturamento. Para obter mais informações, consulte Relatório de uso de caixa postal:.

Disponibilidade, persistência e granularidade de dados

Informações disponíveis neste relatório serão armazenadas com a data e hora exatas para cada evento. Você pode usar qualquer período viável e a duração, incluindo os campos StartDate e EndDate na opção $filter . Tempos são relatados no fuso horário do servidor de email de verificação.

As informações para esse relatório estão disponíveis por um período de 14 dias ou até que a assinatura será cancelada.

Eventos podem ser atrasados por até 24 horas antes que eles aparecem em um relatório.