Отчеты о MailboxActivity *
Коды URI REST MailboxActivity * предоставляют обобщенные сведения о Office 365 организации почтового ящика создания и удаления. Существует четыре отчета, используйте же Общая структура и отличаются только в интервал времени, через который они сведение данных: ежедневно, еженедельно, ежемесячно и ежегодно. Для простоты в этой теме описаны четыре отчета.
Дата последнего изменения: 17 сентября 2015 г.
Область применения: Office 365
Коды URI REST
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailboxActivityDaily[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailboxActivityWeekly[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailboxActivityMonthly[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailboxActivityYearly[?ODATA options]
Поля
В $select, $filter и $orderby параметры запроса ODATA2 можно указать следующие поля. Если указан параметр $select не возвращаются все поля.
Имя |
WCF тип * |
Тип EDM * |
[В/Out] ** описание |
Пример значения |
Добавлено в версию обновления |
---|---|---|---|---|---|
Date |
System.DateTime |
Edm.DateTime |
[In/Out] Дата и время окончания отчетного периода. Ниже приведены дополнительные сведения о отчетных периодов. |
Краткий формат даты (например, 03/10/2013) или Дата и время в кавычки (например, "03/10/2013 4:55 PM") |
2013-V1 |
AccountCreated |
long |
Edm.Int64 |
[In/Out] Количество почтовых ящиков Office 365, созданные во время этого периода времени. |
265 |
2013-V1 |
AccountDeleted |
long |
Edm.Int64 |
[In/Out] Количество почтовых ящиков Office 365 удаляется во время этого периода времени. |
72 |
2013-V1 |
TenantGuid |
System.guid |
Edm.Guid |
[In/Out] GUID организации. |
16a58f78-539f-47f7-b9bf-02a63867d73b |
2013-V1 |
TenantName |
строка |
Не задан |
[In/Out] Доменное имя организации. |
example.onmicrosoft.com |
2013-V1 |
TotalNumberOfActiveMailboxes |
long |
Edm.Int64 |
[In/Out] Общее количество почтовых ящиков, которые были активны во время отчетного периода. |
1242 |
2013-V1 |
* Тип WCF относится к типу данных .NET Framework, назначенный в поле при создании ссылки на службу Windows Communications Framework (WCF) в Visual Studio. Имя относится к модели данных ADO.NET сущности (EDM) типов, которые возвращаются в формате Atom отчеты.
** [In/Out]: видеть входные параметры и сообщить о раздел столбцы выходные данные.
Замечания
Каждый элемент в отчете о включает несколько полей метаданных. Для получения дополнительных сведений см Распространенные метаданных, возвращаемых веб-службой отчетов Office 365.
Четыре типа отчетов отличаются только за время, описывающую каждой записи отчета. Время, указанная в поле Дата представляет окончания периода времени. Сообщает значения даты и времени в часовом поясе, указанном в заголовке X-timezone получить HTTPS. Если часовой пояс не указан, то используется время в формате UTC. Продолжительность времени, обнаруженных рассчитывается следующим образом:
Имя отчета |
Период времени вычисления |
---|---|
Ежедневно (GroupActivityDaily) |
Работы с отчетами день начинается точно полночь (00:00) и заканчивающейся только что до полуночи (23.59:59.9999) в тот же день. Последний день, обнаруженных будет последнего полного дня, для которого данные недоступны и не будут включены в текущий день. Дата и время возвращаются в поле Date представляет конца дня работы с отчетами. |
Еженедельно (GroupActivityWeekly) |
Начала работы с отчетами недели в точно полночь (00:00) преждевременного в субботу и заканчивается только что до полуночи (23:59:59.9999) на следующих пятница ночь. Недавно переданные запись — это один включает в себя текущего дня и таким образом обычно выходит за пределы при запросе отчета. Дата и время возвращаются в поле Date представляет конец данную неделю отчетов. |
Ежемесячно (GroupActivityMonthly) |
Работы с отчетами месяца начинается точно полночь (00:00) на первый день месяца и заканчивается перед полночь (23:59:59.9999) в последний календарный день месяца. Недавно переданные запись — это один включает в себя текущего дня и таким образом обычно выходит за пределы при запросе отчета. Дата и время возвращаются в поле Date представляет окончание работы с отчетами месяца. |
За год (GroupActivityYearly) |
Работы с отчетами год начинается в точно полночь (00:00) 1 января, календарный год и заканчивается перед полночь (23:59:59.9999) этого же календарный год 31 декабря. Недавно переданные запись — это один включает в себя текущего дня и таким образом обычно выходит за пределы при запросе отчета. Дата и время возвращаются в поле Date представляет окончание работы с отчетами месяца. |
Примеры
Следующий запрос и ответ пары показано, как получить отчет об активности почтового ящика по месяцам в формате JSON.
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailboxActivityMonthly?$format=Json
{
"d":
{
"results":
[
{
"__metadata":
{
"id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityMonthly(datetime'2012-11-30T00%3A00%3A00')",
"uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityMonthly(datetime'2012-11-30T00%3A00%3A00')",
"type":"TenantReporting.MailboxActivityReport"
},
"TenantGuid":"16a58f78-5e9f-47f7-bebf-02ae3867d73b",
"TenantName":"example.onmicrosoft.com",
"Date":"\/Date(1354233600000)\/",
"TotalNumberOfActiveMailboxes":"0",
"AccountCreated":"0",
"AccountDeleted":"0"
},
{
"__metadata":
{
"id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityMonthly(datetime'2012-12-31T00%3A00%3A00')",
"uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityMonthly(datetime'2012-12-31T00%3A00%3A00')",
"type":"TenantReporting.MailboxActivityReport"
},
"TenantGuid":"16a58f78-5e9f-47f7-bebf-02ae3867d73b",
"TenantName":"example.onmicrosoft.com",
"Date":"\/Date(1356912000000)\/",
"TotalNumberOfActiveMailboxes":"0",
"AccountCreated":"0",
"AccountDeleted":"0"
},
{
"__metadata":
{
"id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityMonthly(datetime'2013-01-31T00%3A00%3A00')",
"uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityMonthly(datetime'2013-01-31T00%3A00%3A00')",
"type":"TenantReporting.MailboxActivityReport"
},
"TenantGuid":"16a58f78-5e9f-47f7-bebf-02ae3867d73b",
"TenantName":"example.onmicrosoft.com",
"Date":"\/Date(1359590400000)\/",
"TotalNumberOfActiveMailboxes":"1",
"AccountCreated":"0",
"AccountDeleted":"0"
}
]
}
}
Следующий запрос и ответ пары показано, как получить общее число активных почтовых ящиков каждый день, в течение последних четырех дней, в обратном порядке порядке. Этот запрос Date и TotalNumberOfActiveMailboxes число запросов и запрашивает сведения в формате Atom. Разрывы были добавлены в запрос и ответ для наглядности.
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailboxActivityDaily?
$select=Date,TotalNumberOfActiveMailboxes&
$top=4&
$orderby=Date%20desc&
$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/MailboxActivityDaily</id>
<title type="text">MailboxActivityDaily</title>
<updated>2013-01-31T05:23:09Z</updated>
<link rel="self" title="MailboxActivityDaily" href="MailboxActivityDaily" />
<entry>
<id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityDaily(datetime'2013-01-29T00%3A00%3A00')</id>
<category term="TenantReporting.MailboxActivityReport" scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
<link rel="edit" title="MailboxActivityReport" href="MailboxActivityDaily(datetime'2013-01-29T00%3A00%3A00')" />
<title />
<updated>2013-01-31T05:23:09Z</updated>
<author>
<name />
</author>
<content type="application/xml">
<m:properties>
<d:Date m:type="Edm.DateTime">2013-01-29T00:00:00</d:Date>
<d:TotalNumberOfActiveMailboxes m:type="Edm.Int64">0</d:TotalNumberOfActiveMailboxes>
</m:properties>
</content>
</entry>
<entry>
<id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityDaily(datetime'2013-01-28T00%3A00%3A00')</id>
<category term="TenantReporting.MailboxActivityReport" scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
<link rel="edit" title="MailboxActivityReport" href="MailboxActivityDaily(datetime'2013-01-28T00%3A00%3A00')" />
<title />
<updated>2013-01-31T05:23:09Z</updated>
<author>
<name />
</author>
<content type="application/xml">
<m:properties>
<d:Date m:type="Edm.DateTime">2013-01-28T00:00:00</d:Date>
<d:TotalNumberOfActiveMailboxes m:type="Edm.Int64">0</d:TotalNumberOfActiveMailboxes>
</m:properties>
</content>
</entry>
<entry>
<id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityDaily(datetime'2013-01-27T00%3A00%3A00')</id>
<category term="TenantReporting.MailboxActivityReport" scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
<link rel="edit" title="MailboxActivityReport" href="MailboxActivityDaily(datetime'2013-01-27T00%3A00%3A00')" />
<title />
<updated>2013-01-31T05:23:09Z</updated>
<author>
<name />
</author>
<content type="application/xml">
<m:properties>
<d:Date m:type="Edm.DateTime">2013-01-27T00:00:00</d:Date>
<d:TotalNumberOfActiveMailboxes m:type="Edm.Int64">0</d:TotalNumberOfActiveMailboxes>
</m:properties>
</content>
</entry>
<entry>
<id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailboxActivityDaily(datetime'2013-01-26T00%3A00%3A00')</id>
<category term="TenantReporting.MailboxActivityReport" scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
<link rel="edit" title="MailboxActivityReport" href="MailboxActivityDaily(datetime'2013-01-26T00%3A00%3A00')" />
<title />
<updated>2013-01-31T05:23:09Z</updated>
<author>
<name />
</author>
<content type="application/xml">
<m:properties>
<d:Date m:type="Edm.DateTime">2013-01-26T00:00:00</d:Date>
<d:TotalNumberOfActiveMailboxes m:type="Edm.Int64">0</d:TotalNumberOfActiveMailboxes>
</m:properties>
</content>
</entry>
</feed>
Входные параметры и сообщить о выходных столбцов
[In/Out] индикаторов в таблице полей имеют следующие значения:
Поля, отмеченные [In] в поля в таблице в основном предназначены для использования в $filter=, $orderby= и другие параметры запроса, ограничивающие вводимых данных в отчете. Поля, отмеченные [In] в поля в таблице может быть включен параметр $select= и они будут отображаться в отчет операции, но они будут не содержат полезных данных.
Поля, отмеченные [In/Out] в поля, которые в таблице можно использовать в выделенный фрагмент столбца ($select=) и параметры ($filter= и $orderby=) ограничение записей. При включении одно из этих полей в параметре $select= , они будут отображаться в отчет операции и будет содержать полезные данные, если она доступна.
Совместимость
Отчеты о MailboxActivityDaily, MailboxActivityWeekly, MailboxActivityMonthly и MailboxActivityYearly были представлены в Служба Office 365 версии 2013-V1. Дополнительные сведения об управлении версиями содержатся в разделе Управление версиями в веб-службе отчетов Office 365.
Соответствующий командлеты PowerShell
Отчеты о MailboxActivity * возвращать те же данные в командлет Get-MailboxActivityReportWindows PowerShell.
Разрешения
Учетная запись для доступа к отчетов из требуются права администратора в организации, Office 365. Если учетная запись может просмотреть этот отчет в панели управления Office 365, учетная запись имеет разрешения для извлечения данных из веб-службы REST. В этом отчете требует от пользователя быть назначена роль получателей только для просмотра. В структуре разрешения по умолчанию Office 365 пользователей со следующими разрешениями администратора может вызвать этот отчет: выставления счетов администратора, глобального администратора, пароль администратора, администратора служб и администратор управления пользователями.
Степень детализации данных, сохранение состояния и доступности
Информация, доступная через этих отчетов можно разделить на один день периодов, начиная с полуночи часовой пояс, вызывающему приложению в заголовке HTTP X-timezone .
Сведения для этого отчета можно найти в течение одного года или до отмены подписки.
События с задержкой в течение 24 часов, прежде чем они отображаются в отчете.