Informe de StaleMailboxDetail

Artículo
11/14/2016

El URI de REST de StaleMailboxDetail proporciona información detallada sobre los buzones de una organización Office 365 que no se ha tenido acceso recientemente. Use este informe en combinación con Informe de StaleMailbox para administrar buzones inactivos.

Última modificación: jueves, 17 de septiembre de 2015

Hace referencia a: Office 365

URI de REST

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

Campos

Puede especificar los siguientes campos en las opciones de consulta de ODATA2 $select y $filter . Si no hay ninguna opción de $select se proporciona, se devuelven todos los campos. Siempre se devuelven las entradas en orden cronológico, con la última entrada que se va a la más reciente.

Este informe no admite la opción $orderby .

Nombre	Tipo WCF *	Tipo EDM *	[In/Out] ** descripción	Valores de ejemplo	Agregado en la versión de servicio
Date	System.DateTime	Edm.DateTime	[In/Out] La fecha y hora de la entrada del informe. Vea la sección "Comentarios" para obtener información acerca del uso de este campo.	Fecha corta (por ejemplo, 03/10/2013) o Fecha hora con comillas (por ejemplo, "03/10/2013 4:55 PM")	2013-V1
DaysInactive	int	Edm.Int32	El número de días que el buzón ha estado inactivo el día indicado en el campo Date . Si el usuario nunca ha iniciado sesión en el buzón de, este campo indica el número de días desde que se creó el buzón de correo.	25	2013-V1
LastLogin	System.DateTime	Edm.DateTime	Fecha y hora de que último acceso al buzón. Si el buzón de correo nunca se ha tenido acceso, este campo será null explícitamente.	2012-09-27T16:44:57	2013-V1
TenantGuid	System.guid	Edm.Guid	[In/Out] El GUID de la organización de Office 365.	16a58f78-539f-47f7-b9bf-02a63867d73b	2013-V1
TenantName	string	No se especifica ninguno	[In/Out] El nombre de dominio de la organización.	example.onmicrosoft.com	2013-V1
UserName	string	No se especifica ninguno	[In/Out] El nombre para mostrar asociado con el buzón.	UserOne	2013-V1
WindowsLiveID	string	No se especifica ninguno	[In/Out] El Windows Live ID asociada con el buzón, en formato de dirección de correo electrónico SMTP.	userone@example.onmicrosoft.com	2013-V1

* El Tipo de WCF hace referencia al tipo de datos .NET Framework asignado al campo cuando se crea una referencia de servicio Windows Communication Foundation (WCF) en Visual Studio. El Tipo de EDM hace referencia a los tipos de ADO.NET Entity Data Model (EDM) devueltos en los informes con formato Atom.

** Para obtener información acerca de los indicadores de [In/Out], vea la sección "Columnas de resultados de informes y los parámetros de entrada".

Comentarios

Cada entrada en el informe incluye varios campos de metadatos. Para obtener más información, vea Metadatos comunes devueltos por el servicio web de informes de Office 365.

El período de informe de control

Con muchos de los otros informes, para controlar el período de tiempo informes, utilizando los campos StartDate y EndDate . Este informe no tiene esos campos y en su lugar utiliza un campo único Date para especificar el día único en el que a los detalles de informe sobre el buzón de correo inactivo. Si no proporciona una opción de $filter con el Date especificado, el informe usará como valor predeterminado que proporciona los anteriores 90 días para la que no hay información para cada buzón de correo inactivo. Con esa información, puede analizar las tendencias en el número de buzones inactivos.

Para recuperar detalles acerca de los buzones de correo inactivos actualmente, utilice fecha del día anterior en la opción $filter . Puesto de datos se retrasan algo del data mart, y se registran los recuentos de buzones antiguos al final del día completo, casi nunca va a haber datos disponibles para "hoy". Por ejemplo, si hoy es el 14 de febrero, podría proporcionar la opción $filter similar al siguiente.

...$filter=Date eq datetime'2013-02-13T00:00'

Para solicitar los recuentos de cada uno de los últimos 14 días (suponiendo que hoy es el 14 de febrero de 2013), use el siguiente.

...$filter=Date ge datetime'2013-02-01T00:00'

El informe de StaleMailboxDetail admite también la opción de $top . Para especificar un período de tiempo concreto, utilice ambas opciones. La acción siguiente devuelve que el buzón de correo obsoleto los recuentos de tal como se administraban durante la primera semana de enero de 2013.

...$filter=Date ge datetime'2013-01-01T00:00'&$top=7

Ejemplos

La solicitud y respuesta siguiente demostración cómo recuperar detalles de los buzones que estaban inactivos en el 1 de enero de 2013 en formato basado en XML de Atom. Saltos de línea se agregaron a la solicitud y la respuesta para mayor claridad.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/StaleMailboxDetail?
  $select=Date,DaysInactive,LastLogin,UserName,WindowsLiveID&
  $filter=Date%20ge%20datetime'2013-01-01T00:00:00'&
  $top=1&$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/StaleMailboxDetail</id>
  <title type="text">StaleMailboxDetail</title>
  <updated>2013-02-10T03:40:33Z</updated>
  <link rel="self" title="StaleMailboxDetail" href="StaleMailboxDetail" />
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailboxDetail(datetime'2013-01-11T00%3A00%3A00')</id>
    <category term="TenantReporting.StaleMailboxDetailReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="StaleMailboxDetailReport" href="StaleMailboxDetail(datetime'2013-01-11T00%3A00%3A00')" />
    <title />
    <updated>2013-02-10T03:40:33Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-11T00:00:00</d:Date>
        <d:WindowsLiveID>userone@example.onmicrosoft.com</d:WindowsLiveID>
        <d:UserName>UserOne</d:UserName>
        <d:LastLogin m:type="Edm.DateTime" m:null="true" />
        <d:DaysInactive m:type="Edm.Int32">115</d:DaysInactive>
      </m:properties>
    </content>
  </entry>
</feed>

El ejemplo de código siguiente muestra los resultados de la misma consulta, en formato JSON.

  {
    "d":
      [
          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailboxDetail(datetime'2013-01-11T00%3A00%3A00')",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailboxDetail(datetime'2013-01-11T00%3A00%3A00')",
                "type":"TenantReporting.StaleMailboxDetailReport"
              },
            "Date":"\/Date(1357862400000)\/",
            "WindowsLiveID":"userone@example.onmicrosoft.com",
            "UserName":"UserOne",
            "LastLogin":null,
            "DaysInactive":115
          }
      ]
  }

Parámetros de entrada y salida columnas de informe

Los indicadores de [In/Out] en la tabla campos tienen los significados siguientes:

Campos marcados [In] en los campos de tabla principalmente están diseñados para su uso en $filter=, $orderby=, y otras opciones de consulta que restringir las entradas que se devuelve el informe. Los campos marcados [In] en la tabla campos pueden incluirse en la opción $select= y aparecen en las entradas de informe, pero no va a contener ningún dato útil.

Como se indicó anteriormente, este informe no es compatible con la opción $orderby .
Campos marcados [In/Out] en los campos de tabla puede utilizarse en la selección de columna ($select=) y la restricción de entrada (las opciones de$filter= . Cuando uno de estos campos se incluye en la opción $select= , aparecerán en las entradas de informe y va a contener datos útiles cuando esté disponible.

Compatibilidad

El informe de StaleMailboxDetail se introdujo en Versión 2013-V1 del servicio de Office 365. Para obtener más información sobre el control de versiones, vea Control de versiones en el servicio web de informes de Office 365.

Cmdlets de Windows PowerShell correspondientes

El informe de StaleMailboxDetail devuelve la misma información que el cmdlet de Get-StaleMailboxDetailReportWindows PowerShell.

Permisos

La cuenta que use para tener acceso a los informes debe tener permisos administrativos en la organización de Office 365. Si la cuenta puede ver este informe en el Panel de Control Office 365, la cuenta tiene permisos para recuperar los datos desde el servicio web REST. Este informe requiere que el usuario que se asignará a la función de los destinatarios con permiso de vista. En la estructura de permisos Office 365 de forma predeterminada, los usuarios con los siguientes permisos de administrador pueden tener acceso a este informe: administrador del usuario, administrador global, Administrador de contraseñas, Administrador de servicio y Administrador de facturación. Para obtener más información, vea Informe de uso del buzón de correo:.

Disponibilidad, la persistencia y la granularidad de datos

Información disponible a través de este informe se recopila una vez al día.

La información de este informe está disponible durante un período de un año, o hasta que se cancele la suscripción.

Los eventos se pueden retrasar por 24 horas antes de que aparezcan en un informe.

Share via