Partager via

Rapports de CsP2PSession

  • Article

Les URI REST CsP2PSession * fournissent un résumé des statistiques sur le nombre de sessions d'égal à égal Lync Online Office 365. Il existe trois 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 et mensuelle. Par souci de simplicité, les trois rapports sont détaillées dans cette rubrique.

Dernière modification : jeudi 17 septembre 2015

S’applique à : Office 365

URI REST

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

Champs

Les champs suivants peuvent être spécifiés dans les options de requête de ODATA2 $select, $filter et $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. Consultez les sections suivantes pour plus d'informations sur les périodes de rapports.

Date, abrégé (par exemple, 03/10/2013) ou l' Heure avec les guillemets (par exemple, "03/10/2013 4:55 PM")

2013-V1

ID

long

Edm.Int64

[In/Out] Numéro d'index de l'enregistrement du rapport.

72

2013-V1

P2PApplicationSharingSessions

long

Edm.Int64

[In/Out] Nombre de sessions au cours de la période du rapport de partage d'application pair à pair (P2P).

182

2013-V1

P2PAudioSessions

long

Edm.Int64

[In/Out] Le nombre de sessions audio de P2P durant la période du rapport.

12

2013-V1

P2PFileTransferSessions

long

Edm.Int64

[In/Out] Nombre de sessions de transfert de fichiers P2P durant la période du rapport.

42

2013-V1

P2PIMSessions

long

Edm.Int64

[In/Out] Nombre de sessions de messagerie instantanée P2P durant la période du rapport.

142

2013-V1

P2PVideoSessions

long

Edm.Int64

[In/Out] Le nombre de sessions vidéos de P2P durant la période du rapport.

1562

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 l'organisation.

example.onmicrosoft.com

2013-V1

TotalP2PSessions

long

Edm.Int64

Nombre de sessions P2P de tous les types de la période de rapport.

12587

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.

Remarques

Pour être inclus dans les nombres signalés de sessions, au moins un participant doit ont participé à la session en tant que compte d'utilisateur leur organisation Office 365.

Participants à la session qui ont été participer via des appareils mobiles tels que les téléphones ou les tablettes ne sont pas inclus dans le rapport. Pour cette raison, tous les participants à une session se trouvent sur des appareils mobiles, cette session n'apparaît pas dans le rapport.

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 trois 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 (CsP2PSessionDaily)

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'inclut 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 (CsP2PSessionWeekly)

La création de rapports commence à minuit précisément (00: 00:00), au plus tôt le dimanche et se termine juste avant le samedi soir suivant à 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 (CsP2PSessionMonthly)

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.

Exemples

La paire de demande et réponse suivante montre comment récupérer un rapport d'activité des groupes par jour au format JSON. Sauts de ligne ont été ajoutés à la demande et de réponse pour plus de clarté.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsP2PSessionDaily?
  $select=Date,TotalP2PSessions,P2PIMSessions,P2PAudioSessions,P2PVideoSessions,
    P2PApplicationSharingSessions,P2PFileTransferSessions&
  $format=Json

 {
    "d":
      {
        "results":
          [
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-10T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-10T00%3A00%3A00')",
                    "type":"TenantReporting.CsP2PSessionReport"
                  },
                "Date":"\/Date(1368144000000)\/",
                "TotalP2PSessions":"23",
                "P2PIMSessions":"12",
                "P2PAudioSessions":"8",
                "P2PVideoSessions":"1",
                "P2PApplicationSharingSessions":"2",
                "P2PFileTransferSessions":"1"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-13T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-13T00%3A00%3A00')",
                    "type":"TenantReporting.CsP2PSessionReport"
                  },
                "Date":"\/Date(1368403200000)\/",
                "TotalP2PSessions":"42",
                "P2PIMSessions":"16",
                "P2PAudioSessions":"18",
                "P2PVideoSessions":"7",
                "P2PApplicationSharingSessions":"3",
                "P2PFileTransferSessions":"5"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-14T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-14T00%3A00%3A00')",
                    "type":"TenantReporting.CsP2PSessionReport"
                  },
                "Date":"\/Date(1368489600000)\/",
                "TotalP2PSessions":"38",
                "P2PIMSessions":"18",
                "P2PAudioSessions":"8",
                "P2PVideoSessions":"3",
                "P2PApplicationSharingSessions":"7",
                "P2PFileTransferSessions":"5"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-22T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-22T00%3A00%3A00')",
                    "type":"TenantReporting.CsP2PSessionReport"
                  },
                "Date":"\/Date(1369180800000)\/",
                "TotalP2PSessions":"3",
                "P2PIMSessions":"1",
                "P2PAudioSessions":"0",
                "P2PVideoSessions":"0",
                "P2PApplicationSharingSessions":"0",
                "P2PFileTransferSessions":"2"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-24T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                      CsP2PSessionDaily(datetime'2013-05-24T00%3A00%3A00')",
                    "type":"TenantReporting.CsP2PSessionReport"
                  },
                "Date":"\/Date(1369353600000)\/",
                "TotalP2PSessions":"2",
                "P2PIMSessions":"1",
                "P2PAudioSessions":"0",
                "P2PVideoSessions":"0",
                "P2PApplicationSharingSessions":"0",
                "P2PFileTransferSessions":"1"
              }
          ]
      }
  }

La paire de demande et réponse suivante montre comment récupérer le nombre de sessions ayant eu lieu chaque jour entre 20 mai et 25 mai. Cette requête demande les informations au format Atom. Sauts de ligne ont été ajoutés à la demande et de réponse pour plus de clarté.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsP2PSessionDaily?
  $select=Date,TotalP2PSessions,P2PIMSessions,P2PAudioSessions,
    P2PVideoSessions,P2PApplicationSharingSessions,
    P2PFileTransferSessions&
  $filter=Date%20ge%20datetime'2013-05-20T00:00:00'%20and%20Date%20lt%20datetime'2013-05-26T00:00:00'&
  $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/CsP2PSessionDaily</id>
  <title type="text">CsP2PSessionDaily</title>
  <updated>2013-06-25T20:36:14Z</updated>
  <link rel="self" title="CsP2PSessionDaily" href="CsP2PSessionDaily" />
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
      CsP2PSessionDaily(datetime'2013-05-22T00%3A00%3A00')</id>
    <category term="TenantReporting.CsP2PSessionReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-06-25T20:36:14Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-22T00:00:00</d:Date>
        <d:TotalP2PSessions m:type="Edm.Int64">3</d:TotalP2PSessions>
        <d:P2PIMSessions m:type="Edm.Int64">1</d:P2PIMSessions>
        <d:P2PAudioSessions m:type="Edm.Int64">0</d:P2PAudioSessions>
        <d:P2PVideoSessions m:type="Edm.Int64">0</d:P2PVideoSessions>
        <d:P2PApplicationSharingSessions m:type="Edm.Int64">0</d:P2PApplicationSharingSessions>
        <d:P2PFileTransferSessions m:type="Edm.Int64">2</d:P2PFileTransferSessions>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
      CsP2PSessionDaily(datetime'2013-05-24T00%3A00%3A00')</id>
    <category term="TenantReporting.CsP2PSessionReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-06-25T20:36:14Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-24T00:00:00</d:Date>
        <d:TotalP2PSessions m:type="Edm.Int64">2</d:TotalP2PSessions>
        <d:P2PIMSessions m:type="Edm.Int64">1</d:P2PIMSessions>
        <d:P2PAudioSessions m:type="Edm.Int64">0</d:P2PAudioSessions>
        <d:P2PVideoSessions m:type="Edm.Int64">0</d:P2PVideoSessions>
        <d:P2PApplicationSharingSessions m:type="Edm.Int64">0</d:P2PApplicationSharingSessions>
        <d:P2PFileTransferSessions m:type="Edm.Int64">1</d:P2PFileTransferSessions>
      </m:properties>
    </content>
  </entry>
</feed>

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 CsP2PSessionDaily, CsP2PSessionWeekly et CsP2PSessionMonthly 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 CsP2PSession * retourne les mêmes informations que l'applet de commande Get-CsP2PSessionReportWindows PowerShell. 

Autorisations

Le compte que vous accédez aux rapports du doit disposer d'autorisations d'administration dans cette organisation Office 365. Si le rapport est présent dans le document de description de service et le document $metadata renvoyé à l'utilisateur, ils disposent des autorisations nécessaires 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.