Relatórios de ConnectionbyClientTypeDetail *
Os URIs de REST ConnectionbyClientTypeDetail * fornecem estatísticas detalhadas sobre o Office 365 Exchange Online conexões estabelecidas, incluindo o nome de usuário e que tipo de aplicativo cliente foi usado. Existem quatro relatórios que usam a mesma estrutura geral e diferem somente o intervalo de tempo durante os quais eles resumem os dados: diária, semanal, mensal e anual. Para manter a simplicidade, os quatro relatórios são detalhados juntos.
Última alteração: quarta-feira, 21 de setembro de 2016
Aplica-se a: Office 365
URIs REST
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/ConnectionbyClientTypeDetailDaily[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/ConnectionbyClientTypeDetailWeekly[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/ConnectionbyClientTypeDetailMonthly[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/ConnectionbyClientTypeDetailYearly[?ODATA options]
Campos
Os campos a seguir podem ser especificados em Opções de consulta ODATA2 $select, $filtere $orderby . Todos os campos são retornados se nenhuma opção $select for fornecida.
Nome |
Tipo WCF * |
Tipo EDM * |
[Em/fora] * * descrição |
Valores de exemplo |
Adicionado ao serviço versão |
|---|---|---|---|---|---|
ClientType |
Cadeia de caracteres |
Edm.String |
[/ Saída] O tipo de aplicativo do cliente usado para acessar o Exchange Online. |
Outlook 2013 |
2013-V1 |
Count |
longo |
Edm.Int64 |
[/ Saída] O número de conexões estabelecidas com o tipo de cliente durante o período do relatório. |
72 |
2013-V1 |
Date |
System.DateTime |
Edm.DateTime |
[/ Saída] A data de término e a hora do período do relatório. Consulte as seções a seguir para obter mais informações sobre períodos de relatório. |
Data curta (por exemplo, 03/10/2013) ou Data hora com aspas (por exemplo, "03/10/2013 4:55 PM") |
2013-V1 |
TenantGuid |
System.guid |
Edm.Guid |
[/ Saída] O GUID da organização. |
16a58f78-539f-47f7-b9bf-02a63867d73b |
2013-V1 |
TenantName |
Cadeia de caracteres |
Edm.String |
[/ Saída] O nome da organização. |
example.onmicrosoft.com |
2013-V1 |
UserName |
cadeia de caracteres |
Edm.String |
[/ Saída] O nome de exibição do usuário |
User One |
2013-V1 |
WindowsLiveID |
cadeia de caracteres |
Edm.String |
[/ Saída] O nome da conta Windows Live ID, na forma de um endereço de email. |
user@example.com |
2013-V1 |
* Tipo de WCF se refere ao tipo de dados .NET Framework atribuído ao campo quando você cria uma referência de serviço de comunicações Framework WCF (Windows) no Visual Studio. O tipo de EDM refere-se para os tipos de modelo de dados de entidade ADO.NET (EDM) retornados nos relatórios Atom formatada.
* * [/ Saída]: para obter mais informações, consulte os parâmetros de entrada e saída seção de colunas do relatório.
Comentários
Cada entrada no relatório inclui vários campos de metadados. Para obter mais informações, consulte Metadados comum retornados pelo serviço web de relatório do Office 365.
Os quatro tipos de relatório diferem na quantidade de tempo que cobre cada entrada do relatório. No momento relatadas no campo Date representa o fim do período de tempo. Datas e horas são relatadas no fuso horário especificado no cabeçalho X-timezone obter HTTPS. Se nenhum fuso horário é especificado, o horário UTC é usado. As durações de tempo relatados são calculadas da seguinte maneira:
Nome do relatório |
Cálculo de período de tempo |
|---|---|
Diário (ConnectionbyClientTypeDetailDaily) |
O relatório dia começa em precisamente meia-noite (00: 00:00) e termina antes de meia-noite (23.59:59.9999 …) no mesmo dia. O último dia relatado será o último dia completo para o qual os dados estão disponíveis e não incluirá o dia atual. A data e hora retornados no campo Date representa o fim desse dia de relatórios. |
Semanal (ConnectionbyClientTypeDetailWeekly) |
Relatórios semana começa em precisamente meia-noite (00: 00:00), antecipado no sábado e termina antes de meia-noite (23:59:59.9999 …) a seguir noite de sexta-feira. A entrada relatada mais recentemente é o que inclui o dia atual e, portanto, normalmente se estenderá além quando o relatório é solicitado. A data e hora retornados no campo Date representa o fim naquela semana de relatórios. |
Mensal (ConnectionbyClientTypeDetailMonthly) |
O relatório mês começa em precisamente meia-noite (00: 00:00) no primeiro dia do mês e extremidades antes de meia-noite (23.59:59.9999 …) no último dia naquele mês do calendário. A entrada relatada mais recentemente é o que inclui o dia atual e, portanto, normalmente se estenderá além quando o relatório é solicitado. A data e hora retornados no campo Date representa o fim naquele mês do relatório. |
Anual (ConnectionbyClientTypeDetailYearly) |
Relatórios ano inicia à precisamente meia-noite (00: 00:00) em 1 de janeiro de que ano civil e termina antes de meia-noite (23.59:59.9999 …) em 31 de dezembro desse mesmo ano civil. A entrada relatada mais recentemente é o que inclui o dia atual e, portanto, normalmente se estenderá além quando o relatório é solicitado. A data e hora retornados no campo Date representa o fim naquele mês do relatório. |
Exemplos
Em breve...
Parâmetros de entrada e relatar colunas de saída
Os indicadores de [/ saída] na tabela campos têm os significados a seguintes:
Campos marcados [In] nos campos de tabela destinam-se principalmente para uso em $filter=, $orderby= e outras opções de consulta que restringem quais entradas retorna o relatório. Campos marcados [In] em campos de tabela pode ser incluído a opção $select= e eles serão exibidos nas entradas de relatório, mas que não irão conter nenhum dado útil.
Campos marcados [/ saída] nos campos de tabela pode ser usada em Opções de ($filter= e $orderby=) de restrição de entrada e de seleção de coluna ($select=). Quando você inclui um desses campos na opção $select= , eles aparecerão nas entradas de relatório e irá conter dados úteis quando ele estiver disponível.
Compatibilidade
Os relatórios de ConnectionByClientTypeDetailDaily, ConnectionByClientTypeDetailWeekly, ConnectionByClientTypeDetailMonthly e ConnectionByClientTypeDetailAYearly foram introduzidos no Office 365 service version 2013-V1. Para obter mais informações sobre o controle de versão, consulte Controle de versão no serviço da web de relatório do Office 365.
Cmdlets do PowerShell correspondentes
Os relatórios ConnectionByClientTypeDetail * retornam as mesmas informações que o cmdlet Get-ConnectionByClientTypeDetailReportWindows PowerShell.
Permissões
A conta que você acessar os relatórios do deve ter permissões administrativas na organização que Office 365. Se a conta pode exibir este relatório no painel de controle Office 365, a conta tem permissões para recuperar os dados do serviço web REST. Este relatório requer que o usuário a ser atribuído à função de destinatários de somente para exibição. Na estrutura de permissões de Office 365 padrão, os usuários com as seguintes permissões de administrador podem acessar este relatório: administrador de gerenciamento de usuário, administrador global, administrador de senha, administrador de serviço e administrador de faturamento.
Disponibilidade, persistência e granularidade de dados
Informações disponíveis por meio desses relatórios podem ser separadas em períodos de um dia, começando à meia-noite do fuso horário relatado pelo aplicativo de chamada no cabeçalho HTTP X-timezone .
As informações de um diariamente, semanalmente ou mensalmente relatório está disponível por um período de 90 dias. Relatório anual está disponível por um período de um ano ou até que a assinatura será cancelada.
Eventos podem ser atrasados por até 24 horas antes que eles aparecem em um relatório.