MailTrafficPolicy-Bericht

Der REST-URI MailTrafficPolicy enthält zusammenfassende Informationen zu e-Mail-Verkehr zu und von der Organisation. Die Start- und Endzeit Datum/Uhrzeit des Berichts kann angegeben werden, in der Anforderung, wie Sie können den Zeitraum an, für den die Daten aggregiert werden.

Letzte Änderung: Donnerstag, 17. September 2015

Gilt für: Office 365

REST-URIs

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

Felder

Die folgenden Felder können in den ODATA2-Abfrageoptionen $select, $filter und $orderby angegeben werden. Alle Felder werden zurückgegeben, wenn keine $select-Option angegeben wird.

*Der WCF-Typ bezieht sich auf den .NET Framework-Datentyp, der dem Feld beim Erstellen eines Windows Communication Foundation (WCF)-Dienstverweises in Visual Studio zugewiesen wird. Der EDM-Typ bezieht sich auf die ADO.NET-EDM-Typen (Entity Data Model), die in Atom-formatierten Berichten zurückgegeben werden.

** Weitere Informationen zu [In/Out]-Indikatoren finden Sie im Abschnitt „Eingabeparameter und Berichtsausgabespalten".

Hinweise

Jeder Eintrag im Bericht enthält mehrere Metadatenfelder. Weitere Informationen finden Sie unter Gemeinsame Metadaten, die von der Office 365-Berichterstattungswebdienst zurückgegeben.

Das Date-Feld gibt an, wann die Nachrichten vom Office 365-System verarbeitet wurden. Die Angabe entspricht der Zeitzone dieser Server.

Verwenden von "StartDate" und "EndDate"

Die Felder StartDate und EndDate enthalten keine nützlichen Informationen in den Berichtsergebnissen und werden in der Berichtsausgabe immer auf 0001-01-01T00:00:00Z festgelegt. Sie sollen eine einfache Begrenzung des Berichtszeitfensters ermöglichen und bieten eine bessere Genauigkeit, als in einem täglichen Bericht möglich wäre.

Dies kann z. B. bei einer stündlichen Aufzeichnung E-Mail-basierter Denial-of-Service-Angriffe hilfreich sein. Wenn Sie diese Felder verwenden, müssen Sie beide in der $filter-Option angeben. Beide sind optional, aber wenn Sie eines bereitstellen, müssen Sie auch das andere bereitstellen. Wenn das StartDate/EndDate-Paar nicht in der Abfrage angegeben wird, werden die vorherigen zwei Wochen als standardmäßiger Berichtszeitraum verwendet. Im Abschnitt „Beispiele" weiter unten in diesem Thema wird die Verwendung der Felder StartDate und EndDate veranschaulicht.

Verwenden das Feld AggregateBy

Der Bericht MailTrafficPolicy zurückgegeben Zusammenfassung der Ereignisse e-Mail-Zuordnung in das System Office 365. Mit der Action, Event, Date, Senderund So weiter wird jedes Ereignis aufgezeichnet. Die erfassten Daten enthält genaue Datum und Uhrzeit der einzelnen Ereignisse. Die Berichte "Detail" wie etwa MailDetailMalware, bieten Listen mit bestimmten Ereignissen und deren genauen Zeiten. Die Berichte "Datenverkehr" wie MailTrafficPolicy, zusammenfassen und bieten zählt die Ereignisse, die über zwei Dauer: Stunde und Tag. Die Dauer, die in der Abfrageoption $filter verwenden wird angegeben, wie im folgenden Beispiel gezeigt. Wenn kein Vergleich AggregateBy in die Option $filter enthalten ist, wird die standardmäßige Hour verwendet.

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

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

Verwenden das Feld SummarizeBy

Das Feld SummarizeBy können Sie Ergebnisse des Berichts auf eine angegebene Feldname "reduzieren". Beispielsweise angenommen, 200 ein- und 100 ausgehender e-Mails während einer einzelnen Tag-Long Berichtszeitraums aufgetreten sind. Wenn Ihre Abfrage $filter=AggregateBy eq ‘Day’enthält, würde der Bericht zwei separate Einträge für diesen Tag zurück: eine für eingehende e-Mails, die mit einer MessageCount von 200 und einer Direction von Inboundund anderen Eintrag für ausgehende e-Mails, die mit einer MessageCount von 100 und eine Direction der Outbound. Wenn Sie auch die Option $filter wie SummarizeBy eq 'Direction', in das Feld SummarizeBy bereitstellen würde der Bericht dann nur einen Eintrag für den Tag, mit einer leeren Direction dar und eine MessageCount von 300 enthalten. Das Feld Direction ist leer, da der Eintrag sind beide Direction eq 'Inbound' -Nachricht, die Bestell- und Direction eq ‘Outbound’ Nachricht zusammen zählt zusammengefasst.

Nur die folgenden Felder sind für die Verwendung mit SummarizeByunterstützt.

• Action

• EventType

• Direction

• Domain

Ihre Anfragen können mehr als eine der zulässigen Felder, wie in der folgenden $filter Option zusammenfassen enthalten.

$filter=SummarizeBy eq 'EventType,Action'

Wenn die Anforderung SummarizeBy für ein Feld verwendet und außerdem die Option $select der Feldname enthält, wird das Feld mit einem leeren Wert immer gemeldet.

Die folgende Anforderung veranschaulicht, wie die tägliche Zusammenfassung der e-Mail-Verkehr mit nur der Date, Directionund MessageCount die zurückgegebenen Felder anfordern. Die Ergebnisse werden nach Tag zusammengefasst werden soll. Die Anforderung aus Gründen der Übersichtlichkeit wurden Zeilenumbrüche hinzugefügt.

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

Die folgende Abbildung zeigt die Ergebnisse der Anforderung. Um die Ergebnisse zu vereinfachen, wurden die meisten Metadatenelemente entfernt. Beachten Sie, dass es zwei Einträge, eine Vorlage mit Direction des Inboundund der andere für den gleichen Tag mit einem Direction des Outbound gibt.

<?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/MailTrafficPolicy</id>
  <title type="text">MailTrafficPolicy</title>
  <entry>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-29T00:00:00</d:Date>
        <d:Direction>Inbound</d:Direction>
        <d:MessageCount m:type="Edm.Int32">7</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:Direction>Outbound</d:Direction>
        <d:MessageCount m:type="Edm.Int32">58</d:MessageCount>
      </m:properties>
    </content>
  </entry>
 </feed>

Wenn Sie die gleiche Anforderung durch Hinzufügen von DirectionZusammenfassen von vornehmen, wird die Anforderung Folgendes.

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

Die Antwort für denselben Tag reduziert oder eine Zusammenfassung das Direction dar. Anders ausgedrückt, kombiniert es die Werte für alle Einträge, die nur in ihrer Direction Feldwert abweichen. Das Direction -Element wird als leer ist, was bedeutet, dass der Eintrag im Bericht zählt für Ereignisse kombiniert, ignorieren Differenzen Direction Werte zurückgegeben.

<?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/MailTrafficPolicy</id>
  <title type="text">MailTrafficPolicy</title>
  <entry>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-29T00:00:00</d:Date>
        <d:Direction>
        </d:Direction>
        <d:MessageCount m:type="Edm.Int32">65</d:MessageCount>
      </m:properties>
    </content>
  </entry>
 </feed>

Beispiele

Das folgende Beispiel zeigt, wie Sie eine Zusammenfassung der Nachrichten Abrufen des Unternehmens für 1. Januar 2013 im Format Atom-XML-basierte eingehende. Für diesen Bericht wurde SummarizeBy EventType verwendet, damit die Ausgabe einer einzelnen Bericht-Eintrag für alle Nachricht Abschneidedispositionen ist. Zeilenumbrüche für die Anforderung und die Antwort hinzugefügt wurden, und Einträge aus der Antwort aus Gründen der Übersichtlichkeit entfernt wurden.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailTrafficPolicy?
$select=Date,DlpPolicy,MessageCount,TransportRule&
$filter=Direction%20eq%20'Inbound'%20and%20
  AggregateBy%20eq%20'Day'%20and%20
  StartDate%20eq%20datetime'2013-01-01T00:00:00Z'%20and%20
  EndDate%20eq%20datetime'2013-01-02T00:00:00Z'&$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/MailTrafficPolicy</id>
  <title type="text">MailTrafficPolicy</title>
  <updated>2013-02-09T15:25:28Z</updated>
  <link rel="self" title="MailTrafficPolicy" href="MailTrafficPolicy" />
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficPolicy(0)</id>
    <category term="TenantReporting.MailTrafficPolicyReport"
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailTrafficPolicyReport" href="MailTrafficPolicy(0)" />
    <title />
    <updated>2013-02-09T15:25:28Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-01T00:00:00</d:Date>
        <d:DlpPolicy>
        </d:DlpPolicy>
        <d:TransportRule>PII Detection</d:TransportRule>
        <d:MessageCount m:type="Edm.Int32">17</d:MessageCount>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficPolicy(1)</id>
    <category term="TenantReporting.MailTrafficPolicyReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailTrafficPolicyReport" href="MailTrafficPolicy(1)" />
    <title />
    <updated>2013-02-09T15:25:28Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-01T00:00:00</d:Date>
        <d:DlpPolicy>
        </d:DlpPolicy>
        <d:TransportRule>PII Detection</d:TransportRule>
        <d:MessageCount m:type="Edm.Int32">17</d:MessageCount>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficPolicy(2)</id>
    <category term="TenantReporting.MailTrafficPolicyReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailTrafficPolicyReport" href="MailTrafficPolicy(2)" />
    <title />
    <updated>2013-02-09T15:25:28Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-01T00:00:00</d:Date>
        <d:DlpPolicy>PII Detection</d:DlpPolicy>
        <d:TransportRule>PII Detection</d:TransportRule>
        <d:MessageCount m:type="Edm.Int32">17</d:MessageCount>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficPolicy(3)</id>
    <category term="TenantReporting.MailTrafficPolicyReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailTrafficPolicyReport" href="MailTrafficPolicy(3)" />
    <title />
    <updated>2013-02-09T15:25:28Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-01T00:00:00</d:Date>
        <d:DlpPolicy>PII Detection</d:DlpPolicy>
        <d:TransportRule>PII Detection</d:TransportRule>
        <d:MessageCount m:type="Edm.Int32">17</d:MessageCount>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficPolicy(4)</id>
    <category term="TenantReporting.MailTrafficPolicyReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailTrafficPolicyReport" href="MailTrafficPolicy(4)" />
    <title />
    <updated>2013-02-09T15:25:28Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-01T00:00:00</d:Date>
        <d:DlpPolicy>PII Detection</d:DlpPolicy>
        <d:TransportRule>PII Detection</d:TransportRule>
        <d:MessageCount m:type="Edm.Int32">17</d:MessageCount>
      </m:properties>
    </content>
  </entry>
</feed>

Die folgende Abbildung zeigt die gleichen reporting Ergebnisse im JSON-Format.

  {
    "d":
      {
        "results":
          [
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficPolicy(0)",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficPolicy(0)",
                    "type":"TenantReporting.MailTrafficPolicyReport"
                  },
                "Date":"\/Date(1356998400000)\/",
                "DlpPolicy":"",
                "TransportRule":"PII Detection",
                "MessageCount":17
              },
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficPolicy(1)",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficPolicy(1)",
                    "type":"TenantReporting.MailTrafficPolicyReport"
                  },
                "Date":"\/Date(1356998400000)\/",
                "DlpPolicy":"",
                "TransportRule":"PII Detection",
                "MessageCount":17
              },
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficPolicy(2)",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficPolicy(2)",
                    "type":"TenantReporting.MailTrafficPolicyReport"
                  },
                "Date":"\/Date(1356998400000)\/",
                "DlpPolicy":"PII Detection",
                "TransportRule":"PII Detection",
                "MessageCount":17
              },
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficPolicy(3)",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficPolicy(3)",
                    "type":"TenantReporting.MailTrafficPolicyReport"
                  },
                "Date":"\/Date(1356998400000)\/",
                "DlpPolicy":"PII Detection",
                "TransportRule":"PII Detection",
                "MessageCount":17
              },
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficPolicy(4)",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailTrafficPolicy(4)",
                    "type":"TenantReporting.MailTrafficPolicyReport"
                  },
                "Date":"\/Date(1356998400000)\/",
                "DlpPolicy":"PII Detection",
                "TransportRule":"PII Detection",
                "MessageCount":17
              }
          ]
      }
  }

Eingabeparameter und Berichtsausgabespalten

Die [In/Out]-Indikatoren in der Feldertabelle haben folgende Bedeutung:

• In der Feldertabelle mit [In] markierte Felder dienen in erster Linie für die Verwendung in $filter=, $orderby= und anderen Abfrageoptionen, die die im Bericht zurückgegebenen Einträge einschränken. In der Feldertabelle mit [In] markierte Felder können in die $select=-Option eingeschlossen werden und werden im Bericht angezeigt, enthalten jedoch keine nützlichen Daten.

• In der Feldertabelle mit [In/Out] markierte Felder können in Optionen zur Spaltenauswahl ($select=) und zur Eintragseinschränkung ($filter= und $orderby=) verwendet werden. Wenn Sie eines dieser Felder in die $select=-Option einschließen, wird es in den Berichtseinträgen angezeigt und enthält ggf. auch nützliche Daten.

Kompatibilität

Der Bericht MailTrafficPolicy wurde in Office 365-Dienstversion 2013-V1 eingeführt. Weitere Informationen zu versionsverwaltung finden Sie unter Versionsverwaltung in den Webdienst Office 365 Reporting.

Entsprechende Windows PowerShell-Cmdlets

Der Bericht MailDetailSpam gibt die gleiche Informationen wie das Cmdlet Get-MailTrafficPolicyReportWindows PowerShell zurück. 

Berechtigungen

Das Konto, mit denen Sie Zugriff auf die Berichte benötigen in der Organisation Office 365 Administratorberechtigungen. Wenn das Konto in diesem Bericht in der Systemsteuerung Office 365 anzeigen kann, verfügt das Konto über Berechtigungen zum Abrufen der Daten aus dem REST-Webdienst. In diesem Bericht muss der Benutzer, die Rolle des Kontaktobjekts Empfänger zugewiesen werden soll. In der Standardeinstellung Office 365 Berechtigungsstruktur, können Benutzer mit der folgenden Administratorberechtigungen öffnen dieses Berichts: Abrechnung Administrator, globaler Administrator, Kennwort-Administrator, Dienstadministrator und Benutzerverwaltungsadministrator.

Granularität, Dauerhaftigkeit und Verfügbarkeit von Daten

Informationen in diesem Bericht wird mit dem genauen Datum und Zeit für jedes Ereignis gespeichert. Sie können machbare Zeitraum und die Dauer einschließlich der Felder, StartDate und EndDate die Option $filter verwenden. Wie oft werden in der Zeitzone des Servers überprüfen von e-Mail gemeldet. In diesem Bericht berechnet, dass die Anzahl von Nachrichten über Stunden oder Tage, je nach den AggregateBy dar.

Die Informationen für diesen Bericht steht für einen Zeitraum von 14 Tagen oder bis das Abonnement abgebrochen wird.

Ereignisse können bis zu 24 Stunden verzögert sein, bevor sie in einem Bericht angezeigt werden.