Rapports de ConnectionbyClientType

Article
11/14/2016

Les URI REST ConnectionbyClientType * fournissent résumé des statistiques sur les Office 365 Exchange Online connexions établies, organisées par type d'application cliente a été utilisé. Il existe quatre rapports qui utilisent la même structure globale et diffèrent uniquement dans l'intervalle de temps pendant laquelle ils synthétisent les données : quotidienne, hebdomadaire, mensuelle et annuelle. Par souci de simplicité, les quatre rapports sont détaillées entre eux.

Dernière modification : jeudi 17 septembre 2015

S’applique à : 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]

Champs

Les champs suivants peuvent être spécifiées dans les options de requête de ODATA2 $select, $filteret $orderby . Tous les champs sont renvoyés si aucune option $select n'est fournie.

Nom	WCF Type *	Type EDM *	[In/Out] ** Description	Exemples de valeurs	Ajouté dans la version de service
Date	System.DateTime	Edm.DateTime	[In/Out] La date de fin et l'heure de la période de rapport. Pour plus d'informations sur les périodes de rapports, consultez les sections suivantes.	Date, abrégé (par exemple, 03/10/2013) ou l' Heure avec les guillemets (par exemple, "03/10/2013 4:55 PM")	2013-V1
ClientType	string	Edm.String	[In/Out] Le type d'application cliente utilisée pour accéder à Exchange Online.	Lync 2013	2013-V1
Count	long	Edm.Int64	[In/Out] Le nombre de connexions établies par le type de client au cours de la période du rapport.	72	2013-V1
TenantGuid	System.guid	Edm.Guid	[In/Out] Le GUID de l'organisation.	16a58f78-539f-47f7-b9bf-02a63867d73b	2013-V1
TenantName	string	Edm.String	[In/Out] Le nom de domaine principal de l'organisation.	example.onmicrosoft.com	2013-V1

* WCF Type fait référence au type de données .NET Framework affecté au champ lorsque vous créez une référence de Service Windows Communication Framework (WCF) dans Visual Studio. Le Type EDM fait référence aux types ADO.NET Entity Data Model (EDM) renvoyées dans les rapports au format Atom.

** [In/Out]: pour plus d'informations, consultez les paramètres d'entrée et sortie colonnes section d'état.

Notes

Chaque entrée dans le rapport comprend plusieurs champs de métadonnées. Pour plus d'informations, voir Les métadonnées renvoyées par le service web de création de rapports Office 365.

Les quatre types de rapports diffèrent uniquement dans la quantité de temps qui couvre chaque entrée de rapport. L'heure indiquée dans le champ de Date représente la fin de la période de temps. Dates et heures sont indiquées dans le fuseau horaire spécifié dans l'en-tête de X-timezone obtenir le protocole HTTPS. Si aucun fuseau horaire n'est spécifié, l'heure UTC est utilisée. Les durées indiquées sont calculés de la manière suivante.

Nom du rapport	Calcul de la période de temps
Tous les jours (ConnectionbyClientTypeDaily)	Le jour de création de rapports commence à minuit précisément (00: 00:00) et se termine juste avant minuit (23.59:59.9999...) sur ce même jour. Le dernier jour indiqué sera au dernier jour pour lequel les données sont disponibles et n'incluent pas le jour actuel. Date et heure renvoyée dans le champ Date représente la fin de la journée création de rapports.
Toutes les semaines (ConnectionbyClientTypeWeekly)	La création de rapports commence à minuit précisément (00: 00:00), au plus tôt le samedi et se termine juste avant le vendredi suivant soir à minuit (23:59:59.9999...). L'entrée dernièrement signalée est celui qui inclut le jour actuel et donc généralement étendra au-delà lorsque le rapport est demandé. Date et heure renvoyée dans le champ Date représente la fin de cette semaine de création de rapports.
Tous les mois (ConnectionbyClientTypeMonthly)	Le mois de déclaration commence à minuit précisément (00: 00:00) sur le premier jour du mois et se termine juste avant le dernier jour du calendrier de ce mois à minuit (23.59:59.9999...). L'entrée dernièrement signalée est celui qui inclut le jour actuel et donc généralement étendra au-delà lorsque le rapport est demandé. Date et heure renvoyée dans le champ Date représente la fin de ce mois de création de rapports.
Par année (ConnectionbyClientTypeYearly)	L'exercice comptable commence à minuit précisément (00: 00:00) sur le 1er janvier de cette année civile et se termine juste avant minuit (23.59:59.9999...) le 31 décembre de cette même année civile. L'entrée dernièrement signalée est celui qui inclut le jour actuel et donc généralement étendra au-delà lorsque le rapport est demandé. Date et heure renvoyée dans le champ Date représente la fin de ce mois de création de rapports.

Exemples

La paire de demande et réponse suivante montre comment récupérer un rapport qui répertorie le nombre de connexions par mois pour chaque client tapez, au format 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"
              }
          ]
      }
  }

Paramètres d'entrée et de colonnes de sortie de l'état

Les indicateurs [In/Out] dans la table champs ont les significations suivantes :

Les champs marqués [In] dans les champs de table sont principalement destinés à être utilisés dans $filter=, $orderby= et autres options de requête qui restreignent les entrées renvoie le rapport. Les champs marqués [In] dans les champs de table peut être inclus à l'option $select= et ils s'affichent dans les entrées de rapport, mais ils ne contiendront aucune donnée utile.
Les champs marqués [In/Out] dans les champs de table peut être utilisée dans les options de ($filter= et $orderby=) de restriction de l'entrée et de sélection de la colonne ($select=). Lorsque vous incluez un de ces champs dans l'option $select= , ils apparaissent dans les entrées de rapport et contient des données utiles lorsqu'elle est disponible.

Compatibilité

Les rapports de ConnectionbyClientTypeDaily, ConnectionbyClientTypeWeekly, ConnectionbyClientTypeMontly et ConnectionbyClientTypeYearly ont été introduites dans Service Office 365 version 2013-V1. Pour plus d'informations sur le contrôle de version, consultez la rubrique Contrôle de version dans le service web de création de rapports Office 365.

Applets de commande PowerShell correspondant

Les rapports ConnectionbyClientType * retourne les mêmes informations que l'applet de commande Get-ConnectionByClientTypeReportWindows PowerShell.

Autorisations

Le compte que vous accédez aux rapports du doit disposer d'autorisations d'administration dans cette organisation Office 365. Si le compte peut afficher ce rapport dans le panneau de configuration de Office 365, le compte dispose des autorisations pour récupérer les données à partir du service web REST. Ce rapport oblige l'utilisateur à affecter au rôle de destinataires en affichage seul. Dans la structure des autorisations Office 365 par défaut, les utilisateurs disposant des autorisations d'administrateur suivantes peuvent accéder à ce rapport : administrateur, administrateur général, le mot de passe et administrateur de facturation, administrateur de service, administrateur de gestion des utilisateurs.

Disponibilité, persistance et la granularité des données

Informations disponibles par le biais de ces rapports peuvent être séparées en périodes d'une journée, commençant à minuit du fuseau horaire signalé par l'application appelante dans l'en-tête de X-timezone HTTP.

Les informations de ce rapport sont disponibles pour une période d'un an, ou jusqu'à ce que l'abonnement est annulé.

Les événements peuvent être retardées par jusqu'à 24 heures avant qu'ils s'affichent dans un rapport.

Partager via