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 型* |
[入力/出力]** 説明 |
値の例 |
提供されたバージョン |
|---|---|---|---|---|---|
Domain |
string |
Edm.String |
[入力/出力] この MX レコードに含まれる完全修飾ドメイン名 (FQDN)。 |
branchoffice.example.onmicrosoft.com |
2013-V1 |
HighestPriorityMailhost |
string |
Edm.String |
[入力/出力] ドメインのプライマリ メール サーバーの FQDN。 |
fastsmtp.example.com |
2013-V1 |
HighestPriorityMailhostIpAddress |
string |
Edm.String |
[入力/出力] ドメインのプライマリ メール サーバーの IP-V4 アドレス。 |
10.0.0.32 |
2013-V1 |
Organization |
string |
Edm.String |
[入力/出力] 組織の名前。 |
example.onmicrosoft.com |
2013-V1 |
PointsToService |
boolean |
Edm.Boolean |
[入力/出力] True の場合は、MX レコードが Office 365 メール サーバーを対象にしていることを意味します。 |
True |
2013-V1 |
RecordExists |
boolean |
Edm.Boolean |
[入力/出力] True の場合は、レポートが DNS から MX レコードを正常に検索したことを意味します。 |
True |
2013-V1 |
*WCF 型は、Visual Studio で Windows Communications Framework (WCF) サービス参照が作成されたときにフィールドに割り当てられる .NET Framework データ型を参照します。EDM 型は、Atom 形式のレポートで返される ADO.NET エンティティ データ モデル (EDM) 型を参照します。
**[入力/出力]: 詳しくは、「入力パラメーターとレポート出力列」のセクションを参照してください。
解説
MX レコードが正しく構成されていても、一時ネットワークまたは DNS の問題が原因で RecordExists プロパティが False として報告される場合があります。レポート システムと監視システムがこのプロパティに対するアラートをトリガーする場合は、システム管理者に不要なアラートが発行されないように、このトリガーによってレポート呼び出しが再試行されることを確認してください。
レポート内の各エントリにはメタデータの複数のフィールドが含まれます。詳しくは、「Office 365 レポート Web サービスが返す一般的なメタデータ」を参照してください。
例
準備中…
入力パラメーターとレポート出力列
フィールド表の [入力/出力] という表記には次の意味があります。
フィールド表で [入力] が付いているフィールドは、主に $filter=、$orderby= およびレポートが返すエントリを制限する他のクエリ オプションで使用するためのものです。フィールド表で [入力] が付いているフィールドは、$select= オプションに含めることができ、レポート エントリに表示されますが、有用なデータは入っていません。
フィールド表で [入力/出力] が付いているフィールドは、列選択 ($select=) およびエントリ制限 ($filter= と $orderby=) オプションの両方で使用できます。これらのフィールドを $select= オプションに含めると、レポート エントリに表示され、利用可能な場合には有用なデータが入っています。
互換性
MxRecordReport レポートは Office 365 サービス バージョン 2013-V1 で導入されました。バージョン管理の詳細については、「Office 365 レポート Web サービスのバージョン管理」を参照してください。
対応する PowerShell コマンドレット
MxRecordReport は、Get-MxRecordReport Windows PowerShell コマンドレットと同じ情報を返します。
権限
レポートにアクセスするアカウントには、その Office 365 組織の管理権限が必要です。このレポートを Office 365 コントロール パネルで表示できる場合、そのアカウントには REST Web サービスからデータを取得する権限があります。このレポートでは、ユーザーを参照のみ可受信者の役割に割り当てる必要があります。既定の Office 365 権限構造では、次の管理者権限があるユーザーはこのレポートにアクセスできます: 課金管理者、全体管理者、パスワード管理者、サービス管理者、ユーザー管理の管理者。
データの細分性、永続性、可用性
これらのレポートにより利用できる情報は、HTTP X-timezone ヘッダーの呼び出し元アプリケーションにより報告されているタイムゾーンにおける真夜中から始まる日単位で分けることができます。
このレポートの情報は、1 年間またはサブスクリプションをキャンセルするまで利用可能です。
イベントがレポートに表示されるまで、最大で 24 時間遅れる場合があります。