Partager via

Rapports de MailboxActivity

  • Article

Les URI REST MailboxActivity * fournissent un résumé des statistiques sur la création de boîtes aux lettres Office 365 organisation et la suppression. 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 dans cette rubrique.

Dernière modification : jeudi 17 septembre 2015

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

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. Voir ci-dessous 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

AccountCreated

long

Edm.Int64

[In/Out] Le nombre de boîtes aux lettres Office 365 créées pendant cette période.

265

2013-V1

AccountDeleted

long

Edm.Int64

[In/Out] Le nombre de boîtes aux lettres Office 365 supprimé au cours de cette période de temps.

72

2013-V1

TenantGuid

System.guid

Edm.Guid

[In/Out] Le GUID de l'organisation.

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

2013-V1

TenantName

string

Aucun n'est spécifié

[In/Out] Le nom de domaine de votre organisation.

example.onmicrosoft.com

2013-V1

TotalNumberOfActiveMailboxes

long

Edm.Int64

[In/Out] Nombre total de boîtes aux lettres qui étaient actives au cours de la période de rapport.

1242

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]: consultez les paramètres d'entrée et sortie colonnes section d'état.

Remarques

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 (GroupActivityDaily)

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 (GroupActivityWeekly)

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 (GroupActivityMonthly)

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 (GroupActivityYearly)

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 d'activité de la boîte aux lettres par mois au format 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"
              }
            
          ]
        
      }
    
  }

La paire de demande et réponse suivante montre comment récupérer le nombre total de boîtes aux lettres actives chaque jour, des quatre jours précédents, dans l'ordre inverse-chronologique. Cette requête demande le décompte Date et TotalNumberOfActiveMailboxes et 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/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>

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 MailboxActivityDaily, MailboxActivityWeekly, MailboxActivityMonthly et MailboxActivityYearly 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 MailboxActivity * retourne les mêmes informations que l'applet de commande Get-MailboxActivityReportWindows 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.