Compartir a través de


Informe de MailTrafficTop

El URI de REST de MailTrafficTop proporciona información resumida sobre los usuarios enviar y recibir el mayor número de mensajes de correo electrónico en la organización. El inicio y fin fecha y hora del informe pueden especificarse en la solicitud, como el período de tiempo para la que se agregan los datos.

Última modificación: jueves, 17 de septiembre de 2015

Hace referencia a: Office 365

URI de REST

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

Campos

Los siguientes campos pueden especificarse en las opciones de consulta de ODATA2 $select, $filtery $orderby . Si no hay ninguna opción de $select se proporciona, se devuelven todos los campos.

Nombre

Tipo WCF *

Tipo EDM *

[In/Out] ** descripción

Valores de ejemplo

Agregado en la versión de servicio

AggregateBy

string

No se especifica ninguno

[Entrada] Indica si se va a combinar datos en las entradas de informe que abarquen días completos. Los valores de sólo $filter permitidos son Day y Hour. Cuando no se proporciona, el informe se agrega durante períodos de 1 hora. Cuando se incluye en una opción de $select , este campo siempre devuelve null. Vea la sección "Comentarios" para obtener más información.

Day o Hour

2013-V1

Date

System.DateTime

Edm.DateTime

[In/Out] Fecha y hora que se detectó el mensaje como spam.

Fecha corta (por ejemplo, 03/10/2013) o Fecha hora con comillas (por ejemplo, "03/10/2013 4:55 PM")

2013-V1

Direction

string

No se especifica ninguno

[In/Out] Especifica si se ha enviado el correo electrónico a (Inbound) o desde (Outbound) la organización al que se detectó como spam.

Los valores están restringidos a Inbound y Outbound

2013-V1

Domain

string

No se especifica ninguno

[In/Out] El nombre de dominio completo que se procesa el correo electrónico.

example.onmicrosoft.com

2013-V1

EndDate

System.DateTime

Edm.DateTime

[Entrada] Este campo se usa para limitar el período del informe. Use este campo en una opción de consulta de $filter para establecer la fecha y hora finales del período de notificación. Si proporciona EndDate en la opción $filter , también debe proporcionar StartDate.

Fecha corta (por ejemplo, 03/10/2013) o Fecha hora con comillas (por ejemplo, "03/10/2013 4:55 PM")

2013-V1

EventType

string

No se especifica ninguno

[In/Out] El tipo de evento registrado el examen. Para obtener información acerca de los valores válidos EventType , vea Informe de MailFilterList.

SpamContentFiltered, SpamIPBlock

2013-V1

MessageCount

int

Edm.Int64

[In/Out] El número de mensajes que se ajusten a las categorías que se indican mediante los demás campos, durante el período de adición.

1254

2013-V1

Name

string

No se especifica ninguno

La dirección de correo electrónico SMTP del usuario asociado a los mensajes en la entrada del informe de resumen.

userone@example.com

2013-V1

Organization

string

No se especifica ninguno

[In/Out] El nombre de dominio completo que se procesa el correo electrónico.

example.onmicrosoft.com

2013-V1

StartDate

System.DateTime

Edm.DateTime

[Entrada] Este campo se usa para limitar el período del informe. Use este campo en una opción de consulta de $filter para establecer la fecha de inicio y la hora del período de notificación. Si proporciona un StartDate en la opción $filter , también debe especificar un EndDate.

Fecha corta (por ejemplo, 03/10/2013) o Fecha hora con comillas (por ejemplo, "03/10/2013 4:55 PM")

2013-V1

SummarizeBy

string

No se especifica ninguno

[Entrada] El campo de informe especificado en la opción de $filter mediante este campo determina cómo se combinan las entradas de informe para formar un resumen. Vea la sección "Comentarios" para obtener más información. Cuando se incluye en una opción de $select , este campo siempre devuelve null.

Action, EventType, Domainy Direction son los únicos valores que se pueden usar en una opción de $filter con este campo permitidos

2013-V1

* El Tipo de WCF hace referencia al tipo de datos .NET Framework asignado al campo cuando se crea una referencia de servicio Windows Communication Foundation (WCF) en Visual Studio. El Tipo de EDM hace referencia a los tipos de ADO.NET Entity Data Model (EDM) devueltos en los informes con formato Atom.

** Para obtener información acerca de [In/Out] indicadores, vea la sección "Parámetros de entrada y salida columnas de informe".

Comentarios

Cada entrada en el informe incluye varios campos de metadatos. Para obtener más información, vea Metadatos comunes devueltos por el servicio web de informes de Office 365.

El campo Date indica si los mensajes fueron administrados por el sistema Office 365 y se indican en la zona horaria de esos servidores.

La opción de ODATA $orderby no funciona con este informe.

Uso de StartDate y EndDate

Los campos StartDate y EndDate no proporcionan información útil en los resultados del informe y siempre se establecen en 0001-01-01T00:00:00Z en la salida del informe. Están pensadas para habilitar fácil de restricción de la ventana de tiempo de generación de informes y a continuación, proporcione un mayor precisión que estaría disponible en un informe "diario".

Esto puede ser especialmente útil, por ejemplo, al grabar basada en correo electrónico ataques de denegación de servicio en cada hora. Al usar estos campos, debe incluir en la opción $filter . Se consideran opcionales, pero si se proporciona una, debe proporcionar a la otra. Si el par StartDate y EndDate no se proporciona en la consulta, el informe de un período de tiempo predeterminado es las dos semanas anteriores. La sección "Ejemplos" más adelante en este tema muestra cómo usar los campos StartDate y EndDate .

Utilizando el campo AggregateBy

El informe de MailTrafficTop devuelve los resúmenes de los usuarios de recuento de mensajes más alto del sistema Office 365. Cada evento se registra con su Action, Event, Date, Sendery así sucesivamente. Los datos registrados por Office 365 incluyen la fecha exacta y la hora de cada evento. El "Detalles" informes como MailDetailMalware proporcionan listas de eventos específicos y sus tiempos exactas. Los informes de "tráfico", como MailTrafficTop, resumir y puede proporcionar recuentos de los eventos en dos duraciones: hora y día. Especifique qué duración para usar en la opción de consulta $filter , tal como se muestra en el ejemplo siguiente. Si ninguna comparación AggregateBy se incluye en la opción $filter , se usa el valor predeterminado Hour .

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailTrafficTop?$filter=AggregateBy eq 'Day'

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailTrafficTop?$filter=AggregateBy eq 'Hour'

Utilizando el campo SummarizeBy

El campo SummarizeBy permite la salida del informe "collapse" en un nombre de campo especificado. Por ejemplo, supongamos que se produjeron los correos salientes entrantes y 100 a 200 durante un único período informes de día de duración. Si su consulta incluye $filter=AggregateBy eq ‘Day’, el informe devolvería dos entradas independientes para ese día: uno para los mensajes de correo electrónico entrantes que muestra un MessageCount de 200 y un Direction de Inboundy a continuación, otra entrada de mensajes de correo electrónico salientes que muestra un MessageCount de 100 y un Direction de Outbound. Si también proporcionan el campo SummarizeBy en la opción $filter , como en SummarizeBy eq ‘Direction’, el informe incluiría, a continuación, sólo una entrada para ese día, con un campo vacío Direction y un MessageCount de 300. El campo dirección está vacío, debido a que la entrada resume ambos mensaje Direction eq ‘Inbound’ conjuntamente los recuentos de mensajes recuentos y Direction eq ‘Outbound’ .

Sólo los siguientes campos son compatibles para su uso con SummarizeBy.

  • Action

  • EventType

  • Direction

  • Domain

Las solicitudes de pueden incluir más de uno de los campos permitidos para resumir, como se muestra en la siguiente opción de $filter .

$filter=SummarizeBy eq 'EventType,Action'

Si la solicitud de SummarizeBy usa en un campo y también incluye el nombre de ese campo en la opción $select , siempre se registrará el campo con un valor vacío.

La solicitud siguiente muestra cómo solicitar el resumen diario de usuarios de correo electrónico superior, con solo los campos Name, Date, Directiony MessageCount devueltos. Los resultados se van a agregarse por día. Saltos de línea se agregaron a la solicitud para mayor claridad.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailTrafficTop?
$select= Date,Name,Direction,MessageCount&
$filter=AggregateBy%20eq%20'Day'&
$format=Atom

A continuación muestra los resultados de la solicitud. Para simplificar los resultados, se han quitado la mayoría de los elementos de metadatos. Nota Existen son dos entradas, uno con Direction de Inboundy el otro para el mismo día con un Direction de Outbound.

<?xml version="1.0" encoding="utf-8"?>
<feed xml:base="https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/">
  <id>https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailTrafficTop</id>
  <title type="text">MailTrafficTop</title>
  <entry>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-29T00:00:00</d:Date>
        <d:Name>userone@example.onmicrosoft.com</d:Name>
        <d:Direction>Name</d:Direction>
        <d:MessageCount m:type="Edm.Int32">55</d:MessageCount>
      </m:properties>
    </content>
  </entry>
  <entry>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-29T00:00:00</d:Date>
        <d:Name>userone@example.onmicrosoft.com</d:Name>
        <d:Direction>Outbound</d:Direction>
        <d:MessageCount m:type="Edm.Int32">4</d:MessageCount>
      </m:properties>
    </content>
  </entry>
 </feed>

Si realiza la misma solicitud con la incorporación de resumir por Direction, la solicitud se convierte en el siguiente.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailTrafficTop?
$select=Date,Name,Direction,MessageCount&
$filter=AggregateBy%20eq%20'Day'%20and%20SummarizeBy%20eq%20'Direction'&
$format=Atom

La respuesta de ese mismo día, a continuación, se contrae o resume el campo Direction . En otras palabras, combina los recuentos de todas las entradas que sólo se diferencian en su valor de campo de Direction . El elemento Direction se devuelve como vacía, que indica que la entrada del informe combina recuentos de eventos, se omitirá las diferencias entre los valores de Direction .

<?xml version="1.0" encoding="utf-8"?>
<feed xml:base="https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/">
  <id>https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailTrafficTop</id>
  <title type="text">MailTrafficTop</title>
  <entry>
    <content type="application/xml">
      <m:properties>
        <d:Direction>Inbound</d:Direction>
        <d:Date m:type="Edm.DateTime">2013-01-29T00:00:00</d:Date>
        <d:Name>userone@example.onmicrosoft.com</d:Name>
        <d:Direction>
        </d:Direction>
        <d:MessageCount m:type="Edm.Int32">59</d:MessageCount>
      </m:properties>
    </content>
  </entry>
 </feed>

Ejemplos

En el ejemplo siguiente se muestra cómo recuperar información acerca de las cuentas de usuario de tres principales que reciben la mayor parte del correo de 6 de febrero de 2013 en formato Atom. Saltos de línea se agregaron a la solicitud y la respuesta para mayor claridad.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailTrafficTop?
$select=Name,Date,Direction,MessageCount&
$filter=AggregateBy%20eq%20'Day'%20and%20
  StartDate%20eq%20datetime'2013-02-06T00:00:00Z'%20and%20
  EndDate%20eq%20datetime'2013-02-07T00:00:00Z'%20and%20
  Direction%20eq%20'Inbound'&
$orderby=MessageCount&
$top=3&
$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/MailTrafficTop</id>
  <title type="text">MailTrafficTop</title>
  <updated>2013-02-09T16:19:53Z</updated>
  <link rel="self" title="MailTrafficTop" href="MailTrafficTop" />
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficTop(0)</id>
    <category term="TenantReporting.MailTrafficTopReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailTrafficTopReport" href="MailTrafficTop(0)" />
    <title />
    <updated>2013-02-09T16:19:53Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-02-06T00:00:00</d:Date>
        <d:Name>userone@example.onmicrosoft.com</d:Name>
        <d:Direction>Inbound</d:Direction>
        <d:MessageCount m:type="Edm.Int32">1</d:MessageCount>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficTop(1)</id>
    <category term="TenantReporting.MailTrafficTopReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailTrafficTopReport" href="MailTrafficTop(1)" />
    <title />
    <updated>2013-02-09T16:19:53Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-02-06T00:00:00</d:Date>
        <d:Name>usertwo@example.onmicrosoft.com</d:Name>
        <d:Direction>Inbound</d:Direction>
        <d:MessageCount m:type="Edm.Int32">71</d:MessageCount>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficTop(2)</id>
    <category term="TenantReporting.MailTrafficTopReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailTrafficTopReport" href="MailTrafficTop(2)" />
    <title />
    <updated>2013-02-09T16:19:53Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-02-06T00:00:00</d:Date>
        <d:Name>userthree@example.onmicrosoft.com</d:Name>
        <d:Direction>Inbound</d:Direction>
        <d:MessageCount m:type="Edm.Int32">6</d:MessageCount>
      </m:properties>
    </content>
  </entry>
</feed>

A continuación muestra los mismos resultados informes en formato JSON.

  {
    "d":
      [
          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficTop(0)",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficTop(0)",
                "type":"TenantReporting.MailTrafficTopReport"
              },
            "Date":"\/Date(1360108800000)\/",
            "Name":"useone@example.onmicrosoft.com",
            "Direction":"Inbound",
            "MessageCount":1
          },
          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficTop(1)",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficTop(1)",
                "type":"TenantReporting.MailTrafficTopReport"
              },
            "Date":"\/Date(1360108800000)\/",
            "Name":"usetwo@example.onmicrosoft.com",
            "Direction":"Inbound",
            "MessageCount":71
          },
          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficTop(2)",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficTop(2)",
                "type":"TenantReporting.MailTrafficTopReport"
              },
            "Date":"\/Date(1360108800000)\/",
            "Name":"usethree@example.onmicrosoft.com",
            "Direction":"Inbound",
            "MessageCount":6
          }
      ]
  }

Parámetros de entrada y salida columnas de informe

Los indicadores de [In/Out] en la tabla campos tienen los significados siguientes:

  • Campos marcados [In] en los campos de tabla principalmente están diseñados para su uso en $filter=, $orderby=, y otras opciones de consulta que restringir las entradas que se devuelve el informe. Los campos marcados [In] en la tabla campos pueden incluirse en la opción $select= y aparecen en las entradas de informe, pero no va a contener ningún dato útil.

  • En los campos de tabla puede utilizarse en la selección de columna ($select=) y la restricción ($filter= y $orderby=) opciones de entrada de los campos marcados [In/Out]. Cuando uno de estos campos se incluye en la opción $select= , aparecerán en las entradas de informe y va a contener datos útiles cuando esté disponible.

Compatibilidad

El informe de MailTrafficTop se introdujo en Versión 2013-V1 del servicio de Office 365. Para obtener más información sobre el control de versiones, vea Control de versiones en el servicio web de informes de Office 365.

Cmdlets de Windows PowerShell correspondientes

El informe de MailTrafficTop devuelve la misma información que el cmdlet de Get-MailTrafficTopReportWindows PowerShell. 

Permisos

La cuenta que use para tener acceso a los informes debe tener permisos administrativos en la organización de Office 365. Si la cuenta puede ver este informe en el Panel de Control Office 365, la cuenta tiene permisos para recuperar los datos desde el servicio web REST. Este informe requiere que el usuario que se asignará a la función de los destinatarios con permiso de vista. En la estructura de permisos Office 365 de forma predeterminada, los usuarios con los siguientes permisos de administrador pueden tener acceso a este informe: administrador del usuario, administrador global, Administrador de contraseñas, Administrador de servicio y Administrador de facturación.

Disponibilidad, la persistencia y la granularidad de datos

Información disponible en este informe se almacena con la fecha exacta y la hora para cada evento. Puede utilizar cualquier período de tiempo viable y la duración, incluyendo los campos StartDate y EndDate en la opción $filter . Veces se indican en la zona horaria del servidor de análisis del correo electrónico. Este informe se calcula las estadísticas de mensaje en horas o días, dependiendo del campo AggregateBy .

La información de este informe está disponible durante un período de 14 días, o hasta que se cancele la suscripción.

Los eventos se pueden retrasar por 24 horas antes de que aparezcan en un informe.