Relatório de StaleMailboxDetail

Artigo
11/14/2016

O URI do REST StaleMailboxDetail fornece informações detalhadas sobre caixas de correio em uma organização Office 365 que não foram acessados recentemente. Use este relatório em combinação com Relatório de StaleMailbox para gerenciar caixas de correio inativas.

Última alteração: quinta-feira, 17 de setembro de 2015

Aplica-se a: Office 365

URIs REST

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

Campos

Você pode especificar os campos a seguir nas opções de consulta de ODATA2 $select e $filter . Todos os campos são retornados se nenhuma opção $select for fornecida. Entradas sempre são retornadas em ordem cronológica, com a última entrada sendo mais recente.

Este relatório não oferece suporte a opção $orderby .

Nome	Tipo WCF *	Tipo EDM *	[Em/fora] * * descrição	Valores de exemplo	Adicionado ao serviço versão
Date	System.DateTime	Edm.DateTime	[/ Saída] A data e hora da entrada do relatório. Consulte a seção "Comentários" para obter informações sobre como usar este campo.	Data curta (por exemplo, 03/10/2013) ou Data hora com aspas (por exemplo, "03/10/2013 4:55 PM")	2013-V1
DaysInactive	int	Edm.Int32	O número de dias em que a caixa de correio foi inativa no dia indicado no campo Date . Se o usuário nunca tiver conectado à caixa de correio, este campo indica quantos dias desde que a caixa de correio foi criada.	25	2013-V1
LastLogin	System.DateTime	Edm.DateTime	A data e hora que a caixa de correio foi acessado pela última vez. Se a caixa de correio nunca foi acessada, esse campo será explicitamente nulo.	2012-09-27T16:44:57	2013-V1
TenantGuid	System.guid	Edm.Guid	[/ Saída] O GUID da organização Office 365.	16a58f78-539f-47f7-b9bf-02a63867d73b	2013-V1
TenantName	Cadeia de caracteres	Nenhum especificado	[/ Saída] O nome de domínio da organização.	example.onmicrosoft.com	2013-V1
UserName	Cadeia de caracteres	Nenhum especificado	[/ Saída] O nome de exibição associado a caixa de correio.	UserOne	2013-V1
WindowsLiveID	Cadeia de caracteres	Nenhum especificado	[/ Saída] O Windows Live ID associado à caixa de correio, no formato de endereço de email SMTP.	userone@example.onmicrosoft.com	2013-V1

* O Tipo de WCF refere-se ao tipo de dados .NET Framework atribuído ao campo quando você cria um Windows Communication Foundation (WCF) referência de serviço 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.

* * Para obter informações sobre os indicadores de [/ saída], consulte a seção "Colunas de saída de relatório e de parâmetros de entrada".

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.

Controlando o período do relatório

Com muitos outros relatórios, você pode controlar o período de tempo de relatórios usando os campos StartDate e EndDate . Este relatório não tem aos campos e, em vez disso, usa um campo único Date para especificar o único dia em que para detalhes sobre a caixa de correio inativa. Se você não fornecer uma opção de $filter com o Date especificado, o relatório será o padrão para fornecer os 90 dias anteriores para os quais há informações, para cada caixa de correio inativa. Com essa informação, você pode analisar as tendências no número de caixas de correio inativas.

Para recuperar os detalhes sobre as caixas de correio inativas no momento, use a data de ontem na opção $filter . Como dados relativamente foi adiados para o DataMart, e as contagens de caixa de correio obsoletos são registradas no final do dia completo, quase nunca haverá dados disponíveis para "hoje". Por exemplo, se hoje for 14 de fevereiro, seria fornecer a opção $filter semelhante ao seguinte.

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

Para solicitar as contagens de cada um dos últimos 14 dias (supondo que hoje é de 14 de fevereiro de 2013), use o seguinte.

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

O relatório de StaleMailboxDetail oferece suporte a opção $top também. Para especificar um período de tempo específico, use as duas opções. O exemplo a seguir retorna que a caixa de correio obsoleta contagens como estavam durante a primeira semana de janeiro de 2013.

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

Exemplos

A solicitação e a resposta a seguir demonstram como recuperar os detalhes das caixas de correio que foram inativas em 1º de janeiro de 2013, no formato baseado em XML Atom. Quebras de linha foram adicionadas para a solicitação e a resposta para manter a clareza.

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>

O exemplo de código a seguir mostra os resultados da mesma consulta, no 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 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 restringir quais entradas retorna o relatório. Campos marcados [In] na tabela campos podem ser incluídos na opção $select= e eles serão exibidos nas entradas de relatório, mas que não irão conter nenhum dado útil.

Conforme observado anteriormente, este relatório não oferece suporte a opção $orderby .
Campos marcados [/ saída] nos campos de tabela pode ser usada nas seleção de coluna ($select=) e restrição de entrada ($filter= opções. Quando você inclui um desses campos na opção $select= , ele aparecerá nas entradas de relatório e irá conter dados úteis quando ele estiver disponível.

Compatibilidade

O relatório de StaleMailboxDetail foi introduzido 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 Windows PowerShell correspondentes

O relatório de StaleMailboxDetail retorna as mesmas informações que o cmdlet Get-StaleMailboxDetailReportWindows PowerShell.

Permissões

A conta usada para acessar os relatórios deve ter permissões administrativas na organização Office 365. Se a conta pode exibir este relatório no Office 365 painel de controle, 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 destinatários 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. Para obter mais informações, consulte Relatório de uso de caixa postal:.

Disponibilidade, persistência e granularidade de dados

São coletadas informações disponíveis por meio deste relatório uma vez por dia.

As informações para esse relatório estão disponíveis 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.

Compartilhar via