Отчеты о ConnectionbyClientType *

Коды URI REST ConnectionbyClientType * предоставляют обобщенные сведения о Office 365 Exchange Online подключений, упорядоченные по используется тип клиентского приложения. Существует четыре отчета, используйте же Общая структура и отличаются только в интервал времени, через который они сведение данных: ежедневно, еженедельно, ежемесячно и ежегодно. Для простоты четыре отчета приведено подробное описание друг с другом.

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

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

Коды URI REST

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/ConnectionbyClientTypeDaily[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/ConnectionbyClientTypeWeekly[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/ConnectionbyClientTypeMonthly[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/ConnectionbyClientTypeYearly[?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

ClientType

строка

Edm.String

[In/Out] Тип клиентского приложения, используемые для доступа к Exchange Online.

Lync 2013

2013-V1

Count

long

Edm.Int64

[In/Out] Число подключений по типу клиента во время отчета периода времени.

72

2013-V1

TenantGuid

System.guid

Edm.Guid

[In/Out] GUID организации.

16a58f78-539f-47f7-b9bf-02a63867d73b

2013-V1

TenantName

строка

Edm.String

[In/Out] Имя основного домена организации.

example.onmicrosoft.com

2013-V1

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

** [In/Out]: для получения дополнительных сведений см входные параметры и сообщить о раздел столбцы выходные данные.

Замечания

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

Четыре типа отчетов отличаются только за время, описывающую каждой записи отчета. Время, указанная в поле Дата представляет окончания периода времени. Сообщает значения даты и времени в часовом поясе, указанном в заголовке X-timezone получить HTTPS. Если часовой пояс не указан, то используется время в формате UTC. Продолжительность времени, обнаруженных рассчитывается следующим образом.

Имя отчета

Период времени вычисления

Ежедневно (ConnectionbyClientTypeDaily)

Работы с отчетами день начинается точно полночь (00:00) и заканчивающейся только что до полуночи (23.59:59.9999) в тот же день. Последний день, обнаруженных будет последнего полного дня, для которого данные доступны и не будут включены в текущий день. Дата и время возвращаются в поле Date представляет конца дня работы с отчетами.

Еженедельно (ConnectionbyClientTypeWeekly)

Начала работы с отчетами недели в точно полночь (00:00) преждевременного в субботу и заканчивается только что до полуночи (23:59:59.9999) на следующих пятница ночь. Недавно переданные запись — это один включает в себя текущий день и поэтому обычно выходит за пределы при запросе отчета. Дата и время возвращаются в поле Date представляет конец данную неделю отчетов.

Ежемесячно (ConnectionbyClientTypeMonthly)

Работы с отчетами месяца начинается точно полночь (00:00) на первый день месяца и заканчивается перед полночь (23.59:59.9999) в последний календарный день месяца. Недавно переданные запись — это один включает в себя текущего дня и таким образом обычно выходит за пределы при запросе отчета. Дата и время возвращаются в поле Date представляет окончание работы с отчетами месяца.

За год (ConnectionbyClientTypeYearly)

Работы с отчетами год начинается в точно полночь (00:00) 1 января, календарный год и заканчивается перед полночь (23.59:59.9999) этого же календарный год 31 декабря. Недавно переданные запись — это один включает в себя текущего дня и таким образом обычно выходит за пределы при запросе отчета. Дата и время возвращаются в поле Date представляет окончание работы с отчетами месяца.

Примеры

Следующий запрос и ответ пары показано, как получить отчет, содержащий введите сколько подключений на один месяц для каждого клиента, в формате JSON.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/ConnectionbyClientTypeMonthly?
    $select=Date,ClientType,Count&
    $format=Json
  {
    "d":
      {
        "results":
          [
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        ConnectionbyClientTypeMonthly(datetime'2013-07-31T00%3A00%3A00')",
                    uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        ConnectionbyClientTypeMonthly(datetime'2013-07-31T00%3A00%3A00')",
                    "type":"TenantReporting.ConnectionByClientTypeReport"
                  },
                "Date":"\/Date(1375228800000)\/",
                "ClientType":"MAPI",
                "Count":"0"
              },
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        ConnectionbyClientTypeMonthly(datetime'2013-07-31T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        ConnectionbyClientTypeMonthly(datetime'2013-07-31T00%3A00%3A00')",
                    "type":"TenantReporting.ConnectionByClientTypeReport"
                  },
                "Date":"\/Date(1375228800000)\/",
                "ClientType":"POP3",
                "Count":"0"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        ConnectionbyClientTypeMonthly(datetime'2013-07-31T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        ConnectionbyClientTypeMonthly(datetime'2013-07-31T00%3A00%3A00')",
                    "type":"TenantReporting.ConnectionByClientTypeReport"
                  },
                "Date":"\/Date(1375228800000)\/",
                "ClientType":"IMAP",
                "Count":"0"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        ConnectionbyClientTypeMonthly(datetime'2013-07-31T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        ConnectionbyClientTypeMonthly(datetime'2013-07-31T00%3A00%3A00')",
                    "type":"TenantReporting.ConnectionByClientTypeReport"
                  },
                "Date":"\/Date(1375228800000)\/",
                "ClientType":"EAS",
                "Count":"0"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        ConnectionbyClientTypeMonthly(datetime'2013-07-31T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        ConnectionbyClientTypeMonthly(datetime'2013-07-31T00%3A00%3A00')",
                    "type":"TenantReporting.ConnectionByClientTypeReport"
                  },
                "Date":"\/Date(1375228800000)\/",
                "ClientType":"OWA",
                "Count":"0"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        ConnectionbyClientTypeMonthly(datetime'2013-07-31T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        ConnectionbyClientTypeMonthly(datetime'2013-07-31T00%3A00%3A00')",
                    "type":"TenantReporting.ConnectionByClientTypeReport"
                  },
                "Date":"\/Date(1375228800000)\/",
                "ClientType":"EWS",
                "Count":"0"
              }
          ]
      }
  }

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

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

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

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

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

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

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

Отчеты о ConnectionbyClientType * возвращать те же данные в командлет Get-ConnectionByClientTypeReportWindows PowerShell. 

Разрешения

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

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

Информация, доступная через этих отчетов можно разделить на один день периодов, начиная с полуночи часовой пояс, вызывающему приложению в заголовке HTTP X-timezone .

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

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