MxRecordReport 报告
MxRecordReport REST URI 提供有关 Office 365 组织当前邮箱交换器 (MX) DNS 记录的信息。使用此报告帮助排除 DNS 配置设置故障。此报告与其他报告不同,不包含持续时间,而是报告当前 MX 记录状态。
上次修改时间: 2015年9月17日
适用范围: Office 365
REST URI
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MxRecordReport[?ODATA options]
字段
下列字段可在 $select、$filter 和 $orderby ODATA2 查询选项中指定。如果没有提供 $select 选项,将返回所有字段。
名称 |
WCF 类型* |
EDM 类型* |
[In/Out]** 说明 |
示例值 |
在其中添加的服务版本 |
---|---|---|---|---|---|
Domain |
string |
Edm.String |
[In/Out] 此 MX 记录涵盖的完全限定的域名 (FQDN)。 |
branchoffice.example.onmicrosoft.com |
2013-V1 |
HighestPriorityMailhost |
string |
Edm.String |
[In/Out] 域的主邮件服务器的 FQDN |
fastsmtp.example.com |
2013-V1 |
HighestPriorityMailhostIpAddress |
string |
Edm.String |
[In/Out] 域的主邮件服务器的 IP-V4 地址 |
10.0.0.32 |
2013-V1 |
Organization |
string |
Edm.String |
[In/Out] 组织名称。 |
example.onmicrosoft.com |
2013-V1 |
PointsToService |
boolean |
Edm.Boolean |
[In/Out] 如果为 true,则表示 MX 记录定位 Office 365 邮件服务器 |
True |
2013-V1 |
RecordExists |
boolean |
Edm.Boolean |
[In/Out] 如果为 true,则表示报告已成功从 DNS 查找 MX 记录。 |
True |
2013-V1 |
*WCF 类型指在 Visual Studio 中创建 Windows Communications Framework (WCF) 服务参考时分配给字段的 .NET Framework 数据类型。EDM 类型指 ATOM 格式化报告中返回的 ADO.NET 实体数据模型 (EDM) 类型。
**[In/Out]:有关详细信息,请参阅"输入参数和报告输出列"部分。
备注
有时,临时网络或 DNS 问题可能导致 RecordExists 属性报告为 False,即使 MX 记录配置正确也是如此。如果您的报告和监控系统触发此属性的警告,请确保该触发重新尝试报告调用,从而可能不必提醒系统管理员。
报告中的每个条目都包含元数据的多个字段。有关详细信息,请参阅 Office 365 报告 Web 服务返回的常见元数据。
示例
即将推出…
输入参数和报告输出列
字段表格中的 [In/Out] 指示符具有以下含义:
字段表中标记为 [In] 的字段主要在 $filter=、$orderby= 和其他限制报告应返回哪些条目的查询选项中使用。字段表中标记为 [In] 的字段可包含在 $select= 选项中,它们将在报告条目中出现,但不包含有用数据。
字段表中标记为 [In/Out] 的字段可在列选择 ($select=) 和条目限制($filter= 和 $orderby=)选项中使用。当您在 $select= 选项中包含这些字段之一时,它们将在报告条目中出现,且将在提供时包含有用数据。
兼容性
MxRecordReport 报告在 Office 365 服务版本 2013-V1 中引入。有关版本控制的详细信息,请参阅 Office 365 报告 Web 服务中的版本控制。
相应 PowerShell cmdlet
MxRecordReport 将返回与 Get-MxRecordReport Windows PowerShell cmdlet 相同的信息。
权限
您用于访问报告的帐户必须拥有该 Office 365 组织的管理权限。如果此帐户可以在 Office 365 控制面板中查看此报告,则此帐户具有从 REST Web 服务检索数据的权限。此报告要求为用户分配收件人(仅查看)角色。在默认的 Office 365 权限结构中,具有下列管理员权限的用户可以访问此报告:帐务管理员 、全局管理员、密码管理员、服务管理员和用户管理管理员。
数据粒度、持久性和可用性
通过这些报告提供的信息可分隔为多个一天的时间段,从调用应用程序在 HTTP X-timezone 标头中报告的时区的午夜开始。
此报告的信息适用于一年的时间,或者直到取消订阅为止。
事件可能被推迟达 24 小时,然后才能显示在报告中。