Relatório de StaleMailbox

  • Artigo

O URI do REST StaleMailbox fornece estatísticas de resumo sobre o número de Office 365 caixas de correio de organização que não foram acessadas recentemente. Use este relatório em combinação com Relatório de StaleMailboxDetail 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/StaleMailbox[?ODATA options]

Campos

Os campos a seguir podem ser especificados em Opções de consulta 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 o último sendo de entrada para o dia 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

ActiveMailboxes

Long

Edm.Int64

[/ Saída] O número de caixas de correio Office 365 ativas no momento do relatório.

265

2013-V1

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

InactiveMailboxes31To60Days

Longo

Edm.Int64

[/ Saída] O número de caixas de correio de Office 365 que não foram acessados nos últimos 31 a 60 dias.

234

2013-V1

InactiveMailboxes61To90Days

Long

Edm.Int64

[/ Saída] O número de caixas de correio de Office 365 que não foram acessados nos últimos 61 a 90 dias.

22

2013-V1

InactiveMailboxes91To1460Days

Long

Edm.Int64

[/ Saída] O número de caixas de correio de Office 365 que não foram acessados nos últimos 91 para 1460 dias (4 anos).

4

2013-V1

TenantGuid

System.guid

Edm.Guid

[/ Saída] O GUID da organização.

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

* 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 no qual você deseja relatar quantas caixas de correio foram inativas. Se você não fornecer uma opção de $filter com o Date especificado, o relatório será o padrão para fornecer os últimos 90 dias para os quais há informações. Com essa informação, você pode analisar as tendências no número de caixas de correio inativas.

Para recuperar a contagem atual das caixas de correio inativas, 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 quando o dia completo tiver passado, 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 StaleMailbox 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 a contagem de caixas de correio obsoletas existente durante os primeiros três dias de janeiro de 2013. Quebras de linha foram adicionadas para a solicitação e a resposta para manter a clareza.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/StaleMailbox?
  $select=Date,InactiveMailboxes31To60Days,InactiveMailboxes61To90Days,InactiveMailboxes91To1460Days&
  $filter=Date%20ge%20datetime'2013-01-01T00:00:00'&
  $top=7&
  $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/StaleMailbox</id>
  <title type="text">StaleMailbox</title>
  <updated>2013-02-10T02:55:21Z</updated>
  <link rel="self" title="StaleMailbox" href="StaleMailbox" />
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailbox(datetime'2013-01-01T00%3A00%3A00')</id>
    <category term="TenantReporting.StaleMailboxReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="StaleMailboxReport" href="StaleMailbox(datetime'2013-01-01T00%3A00%3A00')" />
    <title />
    <updated>2013-02-10T02:55:21Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-01T00:00:00</d:Date>
        <d:InactiveMailboxes31To60Days m:type="Edm.Int64">0</d:InactiveMailboxes31To60Days>
        <d:InactiveMailboxes61To90Days m:type="Edm.Int64">0</d:InactiveMailboxes61To90Days>
        <d:InactiveMailboxes91To1460Days m:type="Edm.Int64">2</d:InactiveMailboxes91To1460Days>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailbox(datetime'2013-01-02T00%3A00%3A00')</id>
    <category term="TenantReporting.StaleMailboxReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="StaleMailboxReport" href="StaleMailbox(datetime'2013-01-02T00%3A00%3A00')" />
    <title />
    <updated>2013-02-10T02:55:21Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-02T00:00:00</d:Date>
        <d:InactiveMailboxes31To60Days m:type="Edm.Int64">0</d:InactiveMailboxes31To60Days>
        <d:InactiveMailboxes61To90Days m:type="Edm.Int64">0</d:InactiveMailboxes61To90Days>
        <d:InactiveMailboxes91To1460Days m:type="Edm.Int64">2</d:InactiveMailboxes91To1460Days>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailbox(datetime'2013-01-03T00%3A00%3A00')</id>
    <category term="TenantReporting.StaleMailboxReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="StaleMailboxReport" href="StaleMailbox(datetime'2013-01-03T00%3A00%3A00')" />
    <title />
    <updated>2013-02-10T02:55:21Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-03T00:00:00</d:Date>
        <d:InactiveMailboxes31To60Days m:type="Edm.Int64">0</d:InactiveMailboxes31To60Days>
        <d:InactiveMailboxes61To90Days m:type="Edm.Int64">0</d:InactiveMailboxes61To90Days>
        <d:InactiveMailboxes91To1460Days m:type="Edm.Int64">2</d:InactiveMailboxes91To1460Days>
      </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/StaleMailbox(datetime'2013-01-01T00%3A00%3A00')",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailbox(datetime'2013-01-01T00%3A00%3A00')",
                "type":"TenantReporting.StaleMailboxReport"
              },
            "Date":"\/Date(1356998400000)\/",
            "InactiveMailboxes31To60Days":"0",
            "InactiveMailboxes61To90Days":"0",
            "InactiveMailboxes91To1460Days":"2"
          },
          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailbox(datetime'2013-01-02T00%3A00%3A00')",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailbox(datetime'2013-01-02T00%3A00%3A00')",
                "type":"TenantReporting.StaleMailboxReport"
              },
            "Date":"\/Date(1357084800000)\/",
            "InactiveMailboxes31To60Days":"0",
            "InactiveMailboxes61To90Days":"0",
            "InactiveMailboxes91To1460Days":"2"
          },
          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailbox(datetime'2013-01-03T00%3A00%3A00')",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailbox(datetime'2013-01-03T00%3A00%3A00')",
                "type":"TenantReporting.StaleMailboxReport"
              },
            "Date":"\/Date(1357171200000)\/",
            "InactiveMailboxes31To60Days":"0",
            "InactiveMailboxes61To90Days":"0",
            "InactiveMailboxes91To1460Days":"2"
          }
      ]
  }

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.

  • Campos marcados [/ saída] nos campos de tabela pode ser usada nas opções de restrição ($filter=) de entrada e seleção de coluna ($select=). 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.

    Conforme observado anteriormente, este relatório não oferece suporte a opção $orderby .

Compatibilidade

O relatório de StaleMailbox 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 StaleMailbox retorna as mesmas informações que o cmdlet Get-StaleMailboxReportWindows 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.