Relatório de MailFilterList

O URI do REST MailFilterList fornece os valores de cadeia de caracteres permitidos em outros relatórios Office 365. Itens são agrupados por valores SelectTarget . Valores de cada grupo destinam-se a ser usado em Opções de consulta $filter .

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

Aplica-se a: Office 365

URI DO REST

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

Campos

Os campos a seguir podem ser especificados em Opções de consulta ODATA2 $select, $filter e $orderby . Todos os campos são retornados se nenhuma opção $select for fornecida.

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

* * [/ Saída]: ver os parâmetros de entrada e saída seção de colunas do relatório.

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.

Se você estiver criando uma interface de usuário com base nos valores retornados por este relatório, use o campo Display na interface do usuário e use o campo Value em Opções de consulta $filter para esses relatórios. Seu aplicativo não deve presumir que Display e Value sempre será o mesmo.

Categorias de SelectionTarget

O relatório de MailFilterList apresenta as cadeias de caracteres para uso na criação $filter opções de consulta para outros relatórios. Para esses relatórios, você pode especificar quais entradas o sistema irá retornar especificando os valores a serem comparadas com a campos do relatório. Por exemplo, em um relatório de MailDetailMailware , você pode especificar que o relatório retornar somente as entradas de onde a mensagem foi enviada para a caixa de correio de quarentena, usando $filter=Action eq ‘Quarantine’. O valor de Quarantine deve ser selecionado da lista de possíveis ActionsValues retornado por MailFilterList, para garantir correspondências ocorram corretamente. A tabela abaixo lista as categorias definidas por valores SelectionTarget e seus campos correspondentes nos outros relatórios. Lista de valores associados a cada categoria de SelectionTarget pode variar por domínio, configuração e assinatura. Por exemplo, os valores de DlpPolicy retornados incluirá as políticas criadas pelo administrador.

As seções a seguir fornecem detalhes sobre MailFilterList entradas de relatório com os valores de indicado SelectionTarget .

Valores de 'Ações' eq SelectionTarget

entradas de MailFilterList cuja $filter=SelectionTarget eq ’Actions’ indicam que ação automática ou administrativa foi realizada na mensagem de spam. Se nenhuma ação tiver sido executada, o campo será null. A tabela a seguir lista as outras ações disponíveis. Lembre-se de que estas ações normalmente exigem algumas configurações administrativas. Por exemplo, quando uma mensagem de spam indica que um destinatário Cco foi adicionado, o administrador Office 365 deve ter configurado esse endereço e outras configurações. Seu aplicativo pode obter a lista das seguintes ações obtendo um relatório de MailFilterList usando a opção de consulta $filter=SelectionTarget eq 'Actions' . Para obter mais informações, consulte o tópico Relatório de MailFilterList .

Valores de 'DlpPolicy' eq SelectionTarget

Os campos Display e Value das entradas tendo $filter=SelectionTarget eq ’DlpPolicy’ são definidos pelo administrador quando eles configuram as políticas de prevenção (DLP) Office 365 perda de dados. O administrador define nomeadas diretivas que são aplicadas à medida que as mensagens são processadas pelo sistema de email. Políticas de DLP são recipientes para regras DLP. A relação categoria/sub-category entre políticas e regras é explicada no final desta seção. Lista de valores DlpPolicy basicamente é controlada pelo administrador. Exemplos de política Display valores são: Company Sensitive Data, Financial Data Detectione HIPAA Detection.

Valores de 'DlpRule' eq SelectionTarget

Os campos Display e Value de entradas usando $filter=SelectionTarget eq ’DlpRule’ são definidos pelo administrador quando eles configurar as regras de política DLP Office 365. Regras DLP detectam alguma condição na mensagem e executar alguma ação em resposta, como as mensagens são processadas pelo sistema de email. entradas de DlpRule nos resultados do relatório MailFilterList são vinculadas a suas entradas de DlpPolicy que contêm pelos valores de campo ParentTarget e ParentValue . A relação categoria/sub-category entre políticas e regras é explicada no final desta seção. Lista de valores DlpRule basicamente é controlada pelo administrador. Exemplo dos valores de Display regra são: PII Detection, PCI DSS Detection Rule 1e Financial Data Detection Rule 1.

Valores de 'Domínio' eq SelectionTarget

Os campos Display e Value de entradas usando $filter=SelectionTarget eq ’Domain’ indicam os nomes de domínio associados à organização. Office 365 suporta as organizações que usam vários domínios autoritativos e associados e o Reporting web service pode filtrar os dados de relatório por domínio para relatórios que incluem o campo Domain .

Valores de 'EventTypes' eq SelectionTarget

entradas de MailFilterList cuja $filter=SelectionTarget eq ’EventType’ indicam que tipo de verificação foi executado na mensagem. A tabela a seguir lista os outros tipos de eventos disponíveis. Lembre-se de que esses eventos podem exigir algumas configuração administrativa e podem variar por opções de assinatura da organização. Seu aplicativo pode obter a lista desses tipos de evento obtendo um relatório de MailFilterList usando a opção de consulta $filter=SelectionTarget eq 'EventTypes' . Para obter mais informações, consulte o tópico Relatório de MailFilterList .

Valores de 'TransportRule' eq SelectionTarget

Os campos Display e Value de entradas usando $filter=SelectionTarget eq ’TransportRule’ são definidos pelo administrador quando eles configurar as regras de política DLP Office 365. Regras DLP detectam alguma condição na mensagem e executar alguma ação em resposta, como as mensagens são processadas pelo sistema de email. Entradas de DlpRule nos resultados do relatório MailFilterList são vinculadas a suas entradas de DlpPolicy que contêm pelos valores de campo ParentTarget e ParentValue . A categoria / relacionamento subcategoria entre políticas e regras é explicado posteriormente neste tópico. Lista de valores DlpRule basicamente é controlada pelo administrador. Exemplo de valores de exibição de regra são: PII Detection, PCI DSS Detection Rule 1e Financial Data Detection Rule 1.

Noções básicas sobre os campos ParentTarget e ParentValue

As entradas de DLP formam uma relação categoria/sub-category entre as entradas de MailFilterList onde SelectionTarget é DlpPolicy ou DlpRule. O diagrama a seguir ilustra um relacionamento de exemplo consiste em duas políticas e regras de quatro. PolicyOne usa regra-A e B de regra e usos PolicyTwo regra-C, regra B e regra-D. Como os dois diferentes políticas incluem regra B, os resultados MailFilterList incluem duas entradas para a regra-B, diferenciado por seus valores de campo ParentValue , que correspondem aos campos deValueDlpPolicycorrespondente.

Figura 1. Diagrama de duas políticas e regras de quatro.

Exemplos

O seguinte par de solicitação e resposta demonstra como recuperar um relatório de MailFilterList de filtragem de email Actions. Para manter a clareza, quebras de linha foram adicionadas à solicitação e alguns resultados Atom XML foram removidos dos resultados.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailFilterList?
    $select=Display,Domain,Organization,ParentTarget,ParentValue,SelectionTarget&
    $filter=SelectionTarget%20eq%20'Actions'&
    $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/MailFilterList</id>
  <title type="text">MailFilterList</title>
  <updated>2013-02-08T02:32:05Z</updated>
  <link rel="self" title="MailFilterList" href="MailFilterList" />
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailFilterList('Actions')</id>
    <category term="TenantReporting.MailFilterListReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailFilterListReport" href="MailFilterList('Actions')" />
    <title />
    <updated>2013-02-08T02:32:05Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Organization>example.onmicrosoft.com</d:Organization>
        <d:SelectionTarget>Actions</d:SelectionTarget>
        <d:Display>AddBccRecipient</d:Display>
        <d:ParentTarget m:null="true" />
        <d:ParentValue m:null="true" />
        <d:Domain m:null="true" />
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailFilterList('Actions')</id>
    <category term="TenantReporting.MailFilterListReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailFilterListReport" href="MailFilterList('Actions')" />
    <title />
    <updated>2013-02-08T02:32:05Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Organization>example.onmicrosoft.com</d:Organization>
        <d:SelectionTarget>Actions</d:SelectionTarget>
        <d:Display>AddCcRecipient</d:Display>
        <d:ParentTarget m:null="true" />
        <d:ParentValue m:null="true" />
        <d:Domain m:null="true" />
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailFilterList('Actions')</id>
    <category term="TenantReporting.MailFilterListReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailFilterListReport" href="MailFilterList('Actions')" />
    <title />
    <updated>2013-02-08T02:32:05Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Organization>example.onmicrosoft.com</d:Organization>
        <d:SelectionTarget>Actions</d:SelectionTarget>
        <d:Display>AddManagerAsRecipient</d:Display>
        <d:ParentTarget m:null="true" />
        <d:ParentValue m:null="true" />
        <d:Domain m:null="true" />
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailFilterList('Actions')</id>
    <category term="TenantReporting.MailFilterListReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailFilterListReport" href="MailFilterList('Actions')" />
    <title />
    <updated>2013-02-08T02:32:05Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Organization>example.onmicrosoft.com</d:Organization>
        <d:SelectionTarget>Actions</d:SelectionTarget>
        <d:Display>AddToRecipient</d:Display>
        <d:ParentTarget m:null="true" />
        <d:ParentValue m:null="true" />
        <d:Domain m:null="true" />
      </m:properties>
    </content>
  </entry>

  [[ lines removed for clarity ]]

  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailFilterList('Actions')</id>
    <category term="TenantReporting.MailFilterListReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailFilterListReport" href="MailFilterList('Actions')" />
    <title />
    <updated>2013-02-08T02:32:05Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Organization>example.onmicrosoft.com</d:Organization>
        <d:SelectionTarget>Actions</d:SelectionTarget>
        <d:Display>SetSpamConfidenceLevel</d:Display>
        <d:ParentTarget m:null="true" />
        <d:ParentValue m:null="true" />
        <d:Domain m:null="true" />
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailFilterList('Actions')</id>
    <category term="TenantReporting.MailFilterListReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailFilterListReport" href="MailFilterList('Actions')" />
    <title />
    <updated>2013-02-08T02:32:05Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Organization>example.onmicrosoft.com</d:Organization>
        <d:SelectionTarget>Actions</d:SelectionTarget>
        <d:Display>StopRuleProcessing</d:Display>
        <d:ParentTarget m:null="true" />
        <d:ParentValue m:null="true" />
        <d:Domain m:null="true" />
      </m:properties>
    </content>
  </entry>
</feed>

A solicitação de relatório de MailFilterList e a resposta a seguir recupera o campo Display para todos os domínios associada à organização Office 365, no formato JSON. Para manter a clareza, as quebras de linha foram adicionadas à solicitação.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailFilterList?
    $select=Display&
    $filter=SelectionTarget%20eq%20'Domain'&
    $format=Json

  {
    "d":
      {
        "results":
          [
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailFilterList('Domain')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailFilterList('Domain')",
                    "type":"TenantReporting.MailFilterListReport"
                  },
                "Display":"example.onmicrosoft.com"
              }
          ]
      } 
  }

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 restringem quais entradas retorna o relatório. Campos marcados [In] em campos de tabela pode ser incluído a 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 em Opções de ($filter= e $orderby=) de restrição de entrada e de seleção de coluna ($select=). Quando você inclui um desses campos na opção $select= , eles aparecerão nas entradas de relatório e irá conter dados úteis quando ele estiver disponível.

Compatibilidade

O relatório de MailFilterList 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 PowerShell correspondentes

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

Permissões

A conta que você acessar os relatórios do deve ter permissões administrativas nessa organização Office 365. Se a conta pode exibir este relatório no painel de controle Office 365, 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 de destinatários de 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.

Disponibilidade, persistência e granularidade de dados

As informações para este relatório não são baseado em tempo. Partes dos dados retornados por este relatório são dependentes de como o administrador configurou os serviços de Office 365. Este relatório está disponível, desde que a assinatura não tenha expirado.