Отчет о StaleMailboxDetail

Статья
11/14/2016

StaleMailboxDetail REST URI предоставляет подробные сведения о почтовых ящиках в организации Office 365, не использовавшиеся недавно. Этот отчет используется в сочетании с Отчет о StaleMailbox управление неактивными почтовыми ящиками.

Дата последнего изменения: 17 сентября 2015 г.

Область применения: Office 365

Коды URI REST

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

Поля

Можно указать следующие поля в параметры запроса ODATA2 $select и $filter . Если указан параметр $select не возвращаются все поля. С последней записи, время последнего в том порядке, всегда возвращаются записи.

В этом отчете не поддерживает параметр $orderby .

Имя	WCF тип *	Тип EDM *	[В/Out] ** описание	Пример значения	Добавлено в версию обновления
Date	System.DateTime	Edm.DateTime	[In/Out] Дата и время записи отчета. Сведения об использовании этого поля в разделе «Замечания».	Краткий формат даты (например, 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	[In/Out] GUID Office 365 организации.	16a58f78-539f-47f7-b9bf-02a63867d73b	2013-V1
TenantName	строка	Не задан	[In/Out] Доменное имя организации.	example.onmicrosoft.com	2013-V1
UserName	строка	Не задан	[In/Out] Отображаемое имя, связанное с почтовым ящиком.	UserOne	2013-V1
WindowsLiveID	строка	Не задан	[In/Out] Windows Live ID связанный с почтовым ящиком, в формат адреса электронной почты SMTP.	userone@example.onmicrosoft.com	2013-V1

* Тип WCF относится к типу данных .NET Framework, назначенные в поле при создании Windows Communication Foundation (WCF) ссылки на службу в Visual Studio. Имя относится к модели данных ADO.NET сущности (EDM) типов, которые возвращаются в формате Atom отчеты.

** Сведения о индикаторы [In/Out] см в разделе «Входные и выходные столбцы отчета».

Примечания.

Каждый элемент в отчете о включает несколько полей метаданных. Для получения дополнительных сведений см Распространенные метаданных, возвращаемых веб-службой отчетов Office 365.

Управление отчетного периода

С помощью многие другие отчеты управлять отчетного периода времени, используя поля StartDate и EndDate . В этом отчете не этим полям и вместо этого использует один Date поля для указания одного дня на котором сведений о неактивного почтового ящика. Если не указать параметр $filter с указанного Date , в отчете будет по умолчанию для предоставления предыдущей 90 дней, для которых отсутствует сведения для каждой неактивного почтового ящика. С помощью эти сведения можно анализировать тенденции количество неактивных почтовых ящиков.

Чтобы получить подробные сведения о в настоящее время неактивные почтовые ящики, используйте вчерашний день в параметре $filter . Поскольку данные немного задержать для киоска данных, и числа устаревших почтовых ящиков регистрируются в конце полного дня, практически не будут данных «сегодня». Например если сегодня 14 февраля, вы задаете параметр $filter следующим образом.

...$filter=Date eq datetime'2013-02-13T00:00'

Чтобы запросить счетчики для каждого из последних 14 дней (при условии сегодня — 14 февраля 2013 г.), используйте следующие рекомендации.

...$filter=Date ge datetime'2013-02-01T00:00'

Отчет о StaleMailboxDetail поддерживает параметр $top . Чтобы указать определенный период времени, используйте оба параметра. В следующем примере возвращается что устаревшие почтового ящика счетчиков, как во время первой недели января 2013 г.

...$filter=Date ge datetime'2013-01-01T00:00'&$top=7

Примеры

Следующий запрос и ответ показано, как для получения сведений о почтовых ящиков, которые были неактивных 1 января 2013 г., в формате Atom XML. Для запроса и ответа для ясности были добавлены символы перевода строки.

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
          }
      ]
  }

Входные параметры и сообщить о выходных столбцов

[In/Out] индикаторов в таблице полей имеют следующие значения:

Поля, отмеченные [In] в таблице предназначены для использования в $filter=, $orderby=, поля и другие параметры запроса, ограничить вводимых данных в отчете. Поля, помеченные [In] в таблице поля могут быть включены в параметр $select= и они будут отображаться в отчет операции, но они будут не содержат полезных данных.

Как было указано ранее, этот отчет не поддерживает параметр $orderby .
Поля, отмеченные [In/Out] в поля, которые можно использовать в таблице в выделенный фрагмент столбца ($select=) и ограничение запись ($filter= параметры. При включении эти поля параметр $select= будет отображаться в отчет операции и будет содержать полезные данные, если она доступна.

Совместимость

Отчет о StaleMailboxDetail была введена в Служба Office 365 версии 2013-V1. Дополнительные сведения об управлении версиями содержатся в разделе Управление версиями в веб-службе отчетов Office 365.

Соответствующий командлетов Windows PowerShell

Отчет о StaleMailboxDetail возвращает те же данные в командлет Get-StaleMailboxDetailReportWindows PowerShell.

Разрешения

Учетная запись, используемая для доступа к отчетам необходимо иметь права администратора в организации Office 365. Если учетная запись может просмотреть этот отчет в Office 365 панель управления, учетная запись имеет разрешения для извлечения данных из веб-службы REST. В этом отчете требует от пользователя быть назначена роль получателей только для просмотра. В структуре разрешения по умолчанию Office 365 пользователей со следующими разрешениями администратора может вызвать этот отчет: выставления счетов администратора, глобального администратора, пароль администратора, администратора служб и администратор управления пользователями. Для получения дополнительных сведений см Отчет об использовании почтового ящика..

Степень детализации данных, сохранение состояния и доступности

Информация, доступная через этот отчет собранных один раз в день.

Сведения для этого отчета можно найти в течение одного года или до отмены подписки.

События с задержкой в течение 24 часов, прежде чем они отображаются в отчете.

Поделиться через