StaleMailboxDetail レポート
StaleMailboxDetail REST URI は、最近アクセスされていない Office 365 組織内のメールボックスに関する詳細情報を提供します。このレポートは、StaleMailbox レポート と組み合わせて非アクティブなメールボックスを管理するために使用します。
最終更新日: 2015年9月17日
適用対象: Office 365
REST URI
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/StaleMailboxDetail[?ODATA options]
フィールド
$select および $filter ODATA2 クエリ オプションで以下のフィールドを指定できます。$select オプションが指定されなかった場合は、すべてのフィールドが返されます。エントリは、常に、古い順に返され、最後のエントリが最も新しい日付になります。
このレポートは $orderby オプションをサポートしていません。
名前 |
WCF 型* |
EDM 型* |
[入力/出力]** 説明 |
値の例 |
提供されたバージョン |
---|---|---|---|---|---|
Date |
System.DateTime |
Edm.DateTime |
[入力/出力] レポート エントリの日時。 このフィールドの使用方法については、「解説」セクションを参照してください。 |
短い形式の日付 (たとえば、03/10/2013) または引用符付きの日付/時刻 (たとえば、"03/10/2013 4:55 PM") |
2013-V1 |
DaysInactive |
int |
Edm.Int32 |
Date フィールドで指定された期間にメールボックスが非アクティブだった日数。ユーザーがメールボックスにログインしたことがない場合、このフィールドはメールボックスが作成されてからの日数を示します。 |
25 |
2013-V1 |
LastLogin |
System.DateTime |
Edm.DateTime |
メールボックスが最後にアクセスされた日時。メールボックスがアクセスされたことがない場合、このフィールドは明示的に null になります。 |
2012-09-27T16:44:57 |
2013-V1 |
TenantGuid |
System.guid |
Edm.Guid |
[入力/出力] Office 365 組織の GUID。 |
16a58f78-539f-47f7-b9bf-02a63867d73b |
2013-V1 |
TenantName |
string |
指定なし |
[入力/出力] 組織のドメイン名。 |
example.onmicrosoft.com |
2013-V1 |
UserName |
string |
指定なし |
[入力/出力] メールボックスに関連付けられた表示名。 |
UserOne |
2013-V1 |
WindowsLiveID |
string |
指定なし |
[入力/出力] SMTP 電子メール アドレス形式の、メールボックスに関連付けられた Windows Live ID。 |
userone@example.onmicrosoft.com |
2013-V1 |
*WCF 型 は、Visual Studio で Windows Communication Foundation (WCF) サービス参照が作成されたときにフィールドに割り当てられた .NET Framework データ型を参照します。EDM 型は、Atom 形式のレポートで返される ADO.NET エンティティ データ モデル (EDM) 型を参照します。
**[入力/出力] インジケータについては、「入力パラメーターとレポート出力列」のセクションを参照してください。
解説
レポート内の各エントリにはメタデータの複数のフィールドが含まれます。 詳しくは、「Office 365 レポート Web サービスが返す一般的なメタデータ」を参照してください。
レポート期間の制御
他の多くのレポートの場合、StartDate フィールドと EndDate フィールドを使用してレポート期間を制御します。このレポートにはこれらのフィールドがありません。代わりに、単一の Date フィールドを使用して非アクティブなメールボックスに関する詳細を報告する単一の日付を指定します。$filter オプションで Date を指定しなかった場合は、レポートが、既定で、非アクティブなメールボックスごとに、情報が存在する過去 90 日分を提供するように設定されます。この情報を使用すれば、非アクティブなメールボックスの数に関する傾向を分析できます。
現在非アクティブなメールボックスに関する詳細を取得するには、$filter オプションで前日の日付を指定します。データはデータ マートに少し遅れて到着するうえ、過去のメールボックス カウントは丸一日が経過後にログに記録されるため、「今日」の分のデータが利用可能になることはほとんどありません。たとえば、今日が 2 月 14 日の場合は、$filter オプションを次のように指定することになります。
...$filter=Date eq datetime'2013-02-13T00:00'
過去 14 日間の各日のカウントを要求するには、次のコードを使用します (今日が 2013 年 2 月 14 日だとします)。
...$filter=Date ge datetime'2013-02-01T00:00'
StaleMailboxDetail レポートは、$top オプションもサポートします。特定の期間を指定する場合に、両方のオプションを使用します。以下は、2013 年 1 月の第 1 週の古いメールボックス カウントを返します。
...$filter=Date ge datetime'2013-01-01T00:00'&$top=7
例
以下の要求と応答は、2013 年 1 月 1 日に非アクティブだったメールボックスの詳細を取得する方法を示しています。見やすくするために、要求と応答の両方に改行が追加されています。
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/StaleMailboxDetail?
$select=Date,DaysInactive,LastLogin,UserName,WindowsLiveID&
$filter=Date%20ge%20datetime'2013-01-01T00:00:00'&
$top=1&$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/StaleMailboxDetail</id>
<title type="text">StaleMailboxDetail</title>
<updated>2013-02-10T03:40:33Z</updated>
<link rel="self" title="StaleMailboxDetail" href="StaleMailboxDetail" />
<entry>
<id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailboxDetail(datetime'2013-01-11T00%3A00%3A00')</id>
<category term="TenantReporting.StaleMailboxDetailReport"
scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
<link rel="edit" title="StaleMailboxDetailReport" href="StaleMailboxDetail(datetime'2013-01-11T00%3A00%3A00')" />
<title />
<updated>2013-02-10T03:40:33Z</updated>
<author>
<name />
</author>
<content type="application/xml">
<m:properties>
<d:Date m:type="Edm.DateTime">2013-01-11T00:00:00</d:Date>
<d:WindowsLiveID>userone@example.onmicrosoft.com</d:WindowsLiveID>
<d:UserName>UserOne</d:UserName>
<d:LastLogin m:type="Edm.DateTime" m:null="true" />
<d:DaysInactive m:type="Edm.Int32">115</d:DaysInactive>
</m:properties>
</content>
</entry>
</feed>
次のコード例は、同じクエリの結果を JSON 形式で示します。
{
"d":
[
{
"__metadata":
{
"id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailboxDetail(datetime'2013-01-11T00%3A00%3A00')",
"uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailboxDetail(datetime'2013-01-11T00%3A00%3A00')",
"type":"TenantReporting.StaleMailboxDetailReport"
},
"Date":"\/Date(1357862400000)\/",
"WindowsLiveID":"userone@example.onmicrosoft.com",
"UserName":"UserOne",
"LastLogin":null,
"DaysInactive":115
}
]
}
入力パラメーターとレポート出力列
フィールド表の [入力/出力] という表記には次の意味があります。
フィールド表で [入力] が付いているフィールドは、主に $filter=、$orderby= およびレポートが返すエントリを制限する他のクエリ オプションで使用するためのものです。フィールド表で [入力] が付いているフィールドは、$select= オプションに含めることができ、レポート エントリに表示されますが、有用なデータは入っていません。
前述したように、このレポートは $orderby オプションをサポートしていません。
フィールド表で [入力/出力] が付いているフィールドは、列選択 ($select=) およびエントリ制限 ($filter=) オプションの両方で使用できます。これらのフィールドを $select= オプションに含めると、レポート エントリに表示され、利用可能な場合には有用なデータが入っています。
互換性
StaleMailboxDetail レポートは Office 365 サービス バージョン 2013-V1 で導入されました。バージョン管理の詳細については、「Office 365 レポート Web サービスのバージョン管理」を参照してください。
対応する Windows PowerShell コマンドレット
StaleMailboxDetail レポートは、Get-StaleMailboxDetailReport Windows PowerShell コマンドレットと同じ情報を返します。
権限
レポートにアクセスするアカウントには、その Office 365 組織の管理権限が必要です。このレポートを Office 365 コントロール パネルで表示できる場合、そのアカウントには REST Web サービスからデータを取得する権限があります。 このレポートでは、ユーザーを参照のみ可受信者の役割に割り当てる必要があります。 既定の Office 365 権限構造では、次の管理者権限があるユーザーはこのレポートにアクセスできます: 課金管理者、全体管理者、パスワード管理者、サービス管理者、ユーザー管理の管理者。詳しくは、「MailboxUsage レポート」を参照してください。
データの細分性、永続性、可用性
このレポートで利用できる情報は 1 日 1 回収集されます。
このレポートの情報は、1 年間またはサブスクリプションをキャンセルするまで利用可能です。
イベントがレポートに表示されるまで、最大で 24 時間遅れる場合があります。