MailDetailTransportRule 报告

项目
12/20/2016

MailDetailTransportRule REST URI 提供有关处理电子邮件时使用的 Exchange 邮件传输规则的详细信息。报告的开始和结束日期/时间可在请求中指定。

上次修改时间： 2015年9月17日

适用范围： Office 365

REST URI

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

字段

可在 $select、$filter 和 $orderby ODATA2 查询选项中指定下列字段。如果没有提供 $select 选项，将返回所有字段。

名称	WCF 类型*	EDM 类型*	[In/Out]** 说明	示例值	在其中添加的服务版本
Action	string	未指定	[In/Out] 对邮件所采取操作的说明（如果有）。如果没有执行任何操作，此字段可能为空白或 null。有关有效操作值的信息，请参阅 MailFilterList 报告。	SetSpamConfidenceLevel、RejectMessage	2013-V1
Date	System.DateTime	Edm.DateTime	[In/Out] 处理邮件的日期和时间。	简写日期（例如，03/10/2013）或带引号的日期时间（例如，"03/10/2013 4:55 PM"）	2013-V1
Direction	string	未指定	[In/Out] 指定电子邮件被处理时是发送到 (Inbound) 组织还是从组织发出 (Outbound)。	值限制为 Inbound 和 Outbound。	2013-V1
Domain	string	未指定	[In/Out] 处理电子邮件的完全限定的域名。	example.onmicrosoft.com	2013-V1
EndDate	System.DateTime	Edm.DateTime	[In] 此字段用于限制报告期间。在 $filter 查询选项中使用此字段设置报告期间的结束日期和时间。如果您在 $filter 选项中提供 EndDate，则还必须提供 StartDate。	简写日期（例如，03/10/2013）或带引号的日期时间（例如，"03/10/2013 4:55 PM"）	2013-V1
EventType	string	未指定	[In/Out] 记录的扫描事件的类型。有关有效 EventType 值的信息，请参阅 MailFilterList 报告。	SpamContentFiltered、SpamIPBlock	2013-V1
MessageId	string	未指定	[In/Out] 邮件的 Internet MessageID 邮件头（如果有提供）。此值还可明确为 null。	如果没有为邮件提供 ID，则对于 Atom，报告数据将显示 <d:MessageId m:null="true" />，而对于 JSON，报告数据将显示 "MessageId":null。	2013-V1
MessageSize	int	Edm.Int64	[In/Out] 邮件大小，以字节为单位。	130840	2013-V1
MessageTraceId	System.Guid	Edm.Guid	[In/Out] 用于获取邮件传输跟踪详细信息的标识符。MessageTraceId 字段的内部格式应视为不透明，因为格式会变化。有关邮件跟踪的详细信息，请参阅 MessageTrace 报告。	ae4ad8f6-7613-411c-e67e-08cfc740629	2013-V1
Organization	string	未指定	[In/Out] 处理电子邮件的完全限定的域名。	example.onmicrosoft.com	2013-V1
RecipientAddress	string	未指定	[In/Out] 邮件发送到的用户的 SMTP 电子邮件地址。	userone@example.onmicrosoft.com	2013-V1
SenderAddress	string	未指定	[In/Out] 发出邮件的用户 SMTP 电子邮件地址。	usertwo@example.onmicrosoft.com	2013-V1
StartDate	System.DateTime	Edm.DateTime	[In] 此字段用于限制报告期间。在 $filter 查询选项中使用此字段设置报告期间的开始日期和时间。如果您在 $filter 选项中提供 StartDate，则还必须指定 EndDate。	简写日期（例如，03/10/2013）或带引号的日期时间（例如，"03/10/2013 4:55 PM"）	2013-V1
Subject	string	未指定	[In/Out] 邮件的主题行（如果邮件上已存在）。	Free M0ney WoN!	2013-V1
TransportRule	string	未指定	在处理步骤中执行的 Exchange 传输规则的名称。有关有效 TransportRule 值的信息，请参阅 MailFilterList 报告。	PII Detction	2013-V1

*WCF 类型指在 Visual Studio 中创建 Windows Communications Framework (WCF) 服务参考时分配给字段的 .NET Framework 数据类型。EDM 类型指 ATOM 格式化报告中返回的 ADO.NET 实体数据模型 (EDM) 类型。

**[In/Out]：请参阅"输入参数和报告输出列"部分。

备注

报告中的每个条目都包含元数据的多个字段。有关详细信息，请参阅 Office 365 报告 Web 服务返回的常见元数据。

Date 字段指示邮件由 Office 365 系统处理的时间，并按那些服务器所在的时区报告时间。

使用 StartDate 和 EndDate

StartDate 和 EndDate 字段不在报告结果中提供有用的信息，且在报告输出中始终设置为 0001-01-01T00:00:00Z。它们旨在便于限制报告时间段，且提供比"每日"报告更为精确的精度。

这在每小时记录一次电子邮件传输规则使用活动等情况下尤其有用。使用这些字段时，必须在 $filter 选项中包含 StartDate 和 EndDate 字段。它们都被视为可选，但如果您提供一个，则需要提供另一个。如果查询中没有提供 StartDate/EndDate 对，则默认报告时间段是过去两周。下文的"示例"部分显示如何使用 StartDate 和 EndDate 字段。

示例

下面的 MailDetailTransportRule 请求将返回 2013 年 2 月 8 日由检测个人身份信息 (PII) 的传输规则处理的入站邮件的邮件标题行、大小和收件人地址。结果为 Atom XML 格式。为清楚起见，请求中添加了换行符，并从结果中删除了一些 Atom XML 结果。

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailDetailTransportRule?
    $select=Subject,MessageSize,RecipientAddress&
    $filter=Direction%20eq%20'Inbound'%20and%20StartDate%20eq%20datetime'2013-02-08T00:00:00'%20
      and%20EndDate%20eq%20datetime'2013-02-08T23:59:59'%20and%20TransportRule%20eq%20'PII%20Detection'&
    $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/MailDetailTransportRule</id>
  <title type="text">MailDetailTransportRule</title>
  <updated>2013-02-08T08:06:32Z</updated>
  <link rel="self" title="MailDetailTransportRule" href="MailDetailTransportRule" />
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(0)</id>
    <category term="TenantReporting.MailDetailTransportRuleReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailDetailTransportRuleReport" href="MailDetailTransportRule(0)" />
    <title />
    <updated>2013-02-08T08:06:32Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Subject>ClickZ Asia Weekly: Facebook Graph Search - A Fresh Take on SEO</d:Subject>
        <d:MessageSize m:type="Edm.Int32">40320</d:MessageSize>
        <d:RecipientAddress>userone@example.onmicrosoft.com</d:RecipientAddress>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(1)</id>
    <category term="TenantReporting.MailDetailTransportRuleReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailDetailTransportRuleReport" href="MailDetailTransportRule(1)" />
    <title />
    <updated>2013-02-08T08:06:32Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Subject>ClickZ Asia Weekly: Facebook Graph Search - A Fresh Take on SEO</d:Subject>
        <d:MessageSize m:type="Edm.Int32">40320</d:MessageSize>
        <d:RecipientAddress>userone@example.onmicrosoft.com</d:RecipientAddress>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(2)</id>
    <category term="TenantReporting.MailDetailTransportRuleReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailDetailTransportRuleReport" href="MailDetailTransportRule(2)" />
    <title />
    <updated>2013-02-08T08:06:32Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Subject>ClickZ Asia Weekly: Facebook Graph Search - A Fresh Take on SEO</d:Subject>
        <d:MessageSize m:type="Edm.Int32">40495</d:MessageSize>
        <d:RecipientAddress>userone@example.onmicrosoft.com</d:RecipientAddress>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(3)</id>
    <category term="TenantReporting.MailDetailTransportRuleReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailDetailTransportRuleReport" href="MailDetailTransportRule(3)" />
    <title />
    <updated>2013-02-08T08:06:32Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Subject>ClickZ Asia Weekly: Facebook Graph Search - A Fresh Take on SEO</d:Subject>
        <d:MessageSize m:type="Edm.Int32">40495</d:MessageSize>
        <d:RecipientAddress>userone@example.onmicrosoft.com</d:RecipientAddress>
      </m:properties>
    </content>
  </entry>

  [[ XML entries removed for clarity]]

  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(4)</id>
    <category term="TenantReporting.MailDetailTransportRuleReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailDetailTransportRuleReport" href="MailDetailTransportRule(4)" />
    <title />
    <updated>2013-02-08T08:06:32Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Subject>ClickZ Asia Today: What Are the Real Challenges for Digital Marketing in 2013?</d:Subject>
        <d:MessageSize m:type="Edm.Int32">30552</d:MessageSize>
        <d:RecipientAddress>userone@example.onmicrosoft.com</d:RecipientAddress>
      </m:properties>
    </content>
  </entry>
</feed>

以下介绍了 JSON 格式的相同的报告信息。

{
    "d":
      [
        
          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(0)",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(0)",
                "type":"TenantReporting.MailDetailTransportRuleReport"
              },
            "Subject":"ClickZ Asia Weekly: Facebook Graph Search - A Fresh Take on SEO",
            "MessageSize":40320,
            "RecipientAddress":"userone@example.onmicrosoft.com"
          },
        
          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(1)",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(1)",
                "type":"TenantReporting.MailDetailTransportRuleReport"
              },
            "Subject":"ClickZ Asia Weekly: Facebook Graph Search - A Fresh Take on SEO",
            "MessageSize":40320,
            "RecipientAddress":"userone@example.onmicrosoft.com"
          },
        
          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(2)",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(2)",
                "type":"TenantReporting.MailDetailTransportRuleReport"
              },
            "Subject":"ClickZ Asia Weekly: Facebook Graph Search - A Fresh Take on SEO",
            "MessageSize":40495,
            "RecipientAddress":"userone@example.onmicrosoft.com"
          },
        
          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(3)",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(3)",
                "type":"TenantReporting.MailDetailTransportRuleReport"
              },
            "Subject":"ClickZ Asia Weekly: Facebook Graph Search - A Fresh Take on SEO",
            "MessageSize":40495,
            "RecipientAddress":"userone@example.onmicrosoft.com"
          },

[[ items removed for clarity ]]

          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(4)",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(4)",
                "type":"TenantReporting.MailDetailTransportRuleReport"
              },
            "Subject":"ClickZ Asia Today: What Are the Real Challenges for Digital Marketing in 2013?",
            "MessageSize":30552,
            "RecipientAddress":"userone@example.onmicrosoft.com"
          }
        
      ]
    
  }

输入参数和报告输出列

字段表格中的 [In/Out] 指示符具有以下含义：

字段表中标记为 [In] 的字段主要在 $filter=、$orderby= 和其他限制报告应返回哪些条目的查询选项中使用。字段表中标记为 [In] 的字段可包含在 $select= 选项中，他们将在报告条目中出现，但不包含有用数据。
字段表中标记为 [In/Out] 的字段可在列选择 ($select=) 和条目限制（$filter= 和 $orderby=）选项中使用。当您在 $select= 选项中包含这些字段之一时，它们将在报告条目中出现，且将在提供时包含有用数据。

兼容性

MailDetailTransportRule 报告在 Office 365 服务版本 2013-V1 中引入。有关版本控制的详细信息，请参阅 Office 365 报告 Web 服务中的版本控制。

相应的 PowerShell cmdlet

MailDetailTransportRule 报告将返回与 Get-MailDetailTransportRuleReport Windows PowerShell cmdlet 相同的信息。

权限

您用于访问报告的帐户必须拥有该 Office 365 组织的管理权限。如果此帐户可以在 Office 365 控制面板中查看此报告，则此帐户具有从 REST Web 服务检索数据的权限。此报告要求为用户分配收件人（仅查看）角色。在默认的 Office 365 权限结构中，具有下列管理员权限的用户可以访问此报告：帐务管理员、全局管理员、密码管理员、服务管理员和用户管理管理员。

数据粒度、持久性和可用性

此报告提供的信息包含每个事件的确切日期和时间。您可以通过在 $filter 选项中包含 StartDate 和 EndDate 字段来使用任何可行的时间段和持续时间。时间按服务器扫描电子邮件的时区报告。

此报告的信息适用于 7 天的时间段，或者直到取消订阅为止。

事件可能被推迟达 24 小时，然后才能显示在报告中。

通过