MailboxUsage レポート
MailboxUsage REST URI は、Office 365 組織のメールボックスの使用に関する概要統計情報を提供します。 レポートには、メールボックスの数、いっぱいになったメールボックスの数、あまり使用されていないものの数が含まれます。特定のメールボックスに関する情報を取得するには、このレポートを MailboxUsageDetail レポートと共に使用してください。
最終更新日: 2015年9月17日
適用対象: Office 365
REST URI
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailboxUsage[?ODATA options]
フィールド
以下のフィールドを、$select、$filter および $orderby ODATA2 クエリ オプションで指定できます。$select オプションが指定されない場合、すべてのフィールドが返されます。
名前 |
WCF 型* |
EDM 型* |
[入力/出力]** 説明 |
値の例 |
提供されたバージョン |
|---|---|---|---|---|---|
Date |
System.DateTime |
Edm.DateTime |
[入力/出力] レポート期間の終了日時。レポート期間の詳細については、以下を参照してください。 |
短い形式の日付 (たとえば、03/10/2013) または引用符付きの日付/時刻 (たとえば、"03/10/2013 4:55 PM") |
2013-V1 |
MailboxesOverWarningSize |
long |
Edm.Int64 |
[入力/出力] 警告サイズを超えている Office 365 メールボックスの数。詳細については、「解説」セクションを参照してください。 |
265 |
2013-V1 |
MailboxesUsedLessThan25Percent |
long |
Edm.Int64 |
[入力/出力] レポート期間に含まれる日数の 25% 未満しか使用されなかった Office 365 メールボックスの数。 |
72 |
2013-V1 |
TenantGuid |
System.guid |
Edm.Guid |
[入力/出力] 組織の GUID。 |
16a58f78-539f-47f7-b9bf-02a63867d73b |
2013-V1 |
TenantName |
string |
指定なし |
[入力/出力] 組織のドメイン名。 |
example.onmicrosoft.com |
2013-V1 |
TotalInactiveMailboxCount |
long |
Edm.Int64 |
[入力/出力] レポート期間中はずっと非アクティブだったメールボックスの総数。 |
1242 |
2013-V1 |
TotalMailboxCount |
long |
Edm.Int64 |
[入力/出力] レポート期間中に存在したメールボックスの総数。 |
*WCF 型は、Visual Studio で Windows Communications Framework (WCF) サービス参照が作成されたときにフィールドに割り当てられる .NET Framework データ型を参照します。EDM 型は、Atom 形式のレポートで返される ADO.NET エンティティ データ モデル (EDM) 型を参照します。
**[入力/出力]: 詳しくは、「入力パラメーターとレポート出力列」のセクションを参照してください。
解説
Office 365 メールボックスには、警告レベルとサイズ制限という 2 つのクォータ レベルが定義されています。メールボックスが警告サイズ制限を超えている場合は、電子メール クライアントからユーザーに不要なメールの削除が要請されます。ユーザーは、サイズ制限に到達するまでメールの送受信を行うことができますが、到達した時点でメールの送受信ができなくなります。MailboxesOverWarningSize プロパティは、どちらかの制限を超えたメールボックスの数を示します (サイズ制限は警告サイズより大きい値に設定されるものとします)。
レポート内の各エントリにはメタデータの複数のフィールドが含まれます。詳しくは、「Office 365 レポート Web サービスが返す一般的なメタデータ」を参照してください。
例
準備中…
入力パラメーターとレポート出力列
フィールド表の [入力/出力] という表記には次の意味があります。
フィールド表で [入力] が付いているフィールドは、主に $filter=、$orderby= およびレポートが返すエントリを制限する他のクエリ オプションで使用するためのものです。フィールド表で [入力] が付いているフィールドは、$select= オプションに含めることができ、レポート エントリに表示されますが、有用なデータは入っていません。
フィールド表で [入力/出力] が付いているフィールドは、列選択 ($select=) およびエントリ制限 ($filter= と $orderby=) オプションの両方で使用できます。これらのフィールドを $select= オプションに含めると、レポート エントリに表示され、利用可能な場合には有用なデータが入っています。
互換性
MailboxUsage レポートは Office 365 サービス バージョン 2013-V1 で導入されました。詳細については、「Office 365 レポート Web サービスのバージョン管理」を参照してください。
対応する PowerShell コマンドレット
MailboxUsage レポートは、Get-MailboxUsageReport Windows PowerShell コマンドレットと同じ情報を返します。
権限
レポートにアクセスするアカウントには、その Office 365 組織の管理権限が必要です。このレポートを Office 365 コントロール パネルで表示できる場合、そのアカウントには REST Web サービスからデータを取得する権限があります。このレポートでは、ユーザーを参照のみ可受信者の役割に割り当てる必要があります。既定の Office 365 権限構造では、次の管理者権限があるユーザーはこのレポートにアクセスできます: 課金管理者、全体管理者、パスワード管理者、サービス管理者、ユーザー管理の管理者。
データの細分性、永続性、可用性
これらのレポートにより利用できる情報は、HTTP X-timezone ヘッダーの呼び出し元アプリケーションにより報告されているタイムゾーンにおける真夜中から始まる日単位で分けることができます。
このレポートの情報は、1 年間またはサブスクリプションをキャンセルするまで利用可能です。
イベントがレポートに表示されるまで、最大で 24 時間遅れる場合があります。