Informe de MailFilterList

El URI de REST de MailFilterList proporciona los valores de cadena permitidos en otros informes de Office 365. Los elementos se agrupan por los valores de SelectTarget . Los valores de todos los grupos están diseñados para usarse en las opciones de consulta de $filter .

Ú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/MailFilterList[?ODATA options]

Campos

Los siguientes campos pueden especificarse en las opciones de consulta de ODATA2 $select, $filter y $orderby . Si no hay ninguna opción de $select se proporciona, se devuelven todos los campos.

* Tipo WCF hace referencia al tipo de datos .NET Framework asignado al campo cuando se crea una referencia de servicio de Windows Communications Framework (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.

** [In/Out]: ver los parámetros de entrada y notificar la sección de columnas de salida.

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.

Si va a crear una interfaz de usuario basada en los valores devueltos por este informe, utilice el campo Display en la interfaz de usuario y usar el campo Value en $filter las opciones de consulta para los informes. La aplicación no debe suponer que Display y Value siempre será el mismo.

SelectionTarget categorías

El informe de MailFilterList proporciona cadenas para su uso en la creación de $filter opciones de consulta para otros informes. Para los informes, puede especificar las entradas que se devolverá el sistema mediante la especificación de valores para hacer coincidir con los campos de informe. Por ejemplo, en un informe de MailDetailMailware , puede especificar que el informe de devolver sólo las entradas que se envió el mensaje en el buzón de cuarentena, mediante el uso de $filter=Action eq ‘Quarantine’. El valor de Quarantine debe seleccionarse en la lista de posibles ActionsValues devuelto por MailFilterList, para asegurarse de coincidencias se realiza correctamente. En la tabla siguiente se enumera las categorías definidas por los valores de SelectionTarget y sus correspondientes a los campos de los otros informes. La lista de valores asociados con cada categoría de SelectionTarget puede variar por dominio, la suscripción y la configuración. Por ejemplo, los valores de DlpPolicy devueltos incluirá las directivas creadas por el administrador.

Las siguientes secciones proporcionan detalles sobre MailFilterList entradas de informe con los valores de indicado SelectionTarget .

Valores de SelectionTarget eq 'Acciones'

entradas de MailFilterList que tienen $filter=SelectionTarget eq ’Actions’ indican qué acción automática o administrativo se ha realizado en el mensaje de spam. Si no se ha realizado ninguna acción, el campo será null. En la siguiente tabla se enumera las otras acciones disponibles. Recuerde que estas acciones a menudo requieren una configuración administrativa. Por ejemplo, cuando un mensaje de spam indica que se ha agregado un destinatario CCO, el Administrador de Office 365 debe haya configurado esa dirección y otras opciones de configuración. La aplicación puede obtener la lista de estas acciones mediante la obtención de un informe de MailFilterList mediante la opción de consulta $filter=SelectionTarget eq 'Actions' . Para obtener más información, vea el tema de Informe de MailFilterList .

Valores de SelectionTarget eq 'DlpPolicy'

Los campos Display y Value de entradas que tengan $filter=SelectionTarget eq ’DlpPolicy’ se establecen por el administrador cuando configuran las directivas de prevención (DLP) de pérdida de datos de Office 365. El administrador define las directivas con nombre que se han aplicado como se procesan los mensajes a través del sistema de correo electrónico. Las directivas DLP son contenedores para las reglas DLP. La relación categoría/sub-category entre las directivas y reglas se explica al final de esta sección. La lista de valores de DlpPolicy está controlada finalmente por el administrador. Ejemplos de valores de directiva Display son: Company Sensitive Data, Financial Data Detectiony HIPAA Detection.

Valores de SelectionTarget eq 'DlpRule'

Los campos Display y Value de entradas con $filter=SelectionTarget eq ’DlpRule’ se establecen por el administrador cuando configuran las reglas de directivas DLP Office 365. Reglas DLP detectan alguna condición en el mensaje y realizar alguna acción en respuesta, como los mensajes se procesan a través del sistema de correo electrónico. entradas de DlpRule en los resultados del informe MailFilterList están vinculadas a sus que contiene entradas de DlpPolicy por los valores de campo ParentTarget y ParentValue . La relación categoría/sub-category entre las directivas y reglas se explica al final de esta sección. La lista de valores de DlpRule está controlada finalmente por el administrador. Ejemplo de regla Display valores son: PII Detection, PCI DSS Detection Rule 1y Financial Data Detection Rule 1.

Valores de SelectionTarget eq 'Dominio'

Los campos Display y Value de entradas con $filter=SelectionTarget eq ’Domain’ indican los nombres de dominio asociados con la organización. Office 365 admite las organizaciones con varios dominios autoritativos y asociados y, a continuación, el Servicio Web de informes puede filtrar los datos de informe por dominio para los informes que incluyen el campo Domain .

SelectionTarget eq 'Debe establecer' valores

entradas de MailFilterList que tienen $filter=SelectionTarget eq ’EventType’ indican qué tipo de detección que se llevó a cabo en el mensaje. En la siguiente tabla se enumera los otros tipos de eventos disponibles. Recuerde que requieran la parte de la configuración administrativa estos eventos y pueden variar según las opciones de suscripción de la organización. La aplicación puede obtener la lista de estos tipos de eventos mediante la obtención de un informe de MailFilterList mediante la opción de consulta $filter=SelectionTarget eq 'EventTypes' . Para obtener más información, vea el tema de Informe de MailFilterList .

Valores de SelectionTarget eq 'TransportRule'

Los campos Display y Value de entradas con $filter=SelectionTarget eq ’TransportRule’ se establecen por el administrador cuando configuran las reglas de directivas DLP Office 365. Reglas DLP detectan alguna condición en el mensaje y realizar alguna acción en respuesta, como los mensajes se procesan a través del sistema de correo electrónico. Entradas de DlpRule en los resultados del informe MailFilterList están vinculadas a sus que contiene entradas de DlpPolicy por los valores de campo ParentTarget y ParentValue . La categoría / relación de subcategoría entre las directivas y reglas se explica más adelante en este tema. La lista de valores de DlpRule está controlada finalmente por el administrador. Ejemplo de valores de presentación de la regla son: PII Detection, PCI DSS Detection Rule 1y Financial Data Detection Rule 1.

Descripción de los campos ParentTarget y ParentValue

Las entradas de DLP forman una relación categoría/sub-category entre las entradas de MailFilterList donde SelectionTarget es DlpPolicy o DlpRule. El siguiente diagrama muestra una relación de ejemplo que consta de dos directivas y reglas de cuatro. PolicyOne utiliza regla-A y B de la regla y PolicyTwo usa regla-C, B de regla y regla-D. Debido a que dos directivas distintas incluyen regla B, los resultados de MailFilterList incluyen dos entradas para la regla-B, diferenciado por sus valores de campo ParentValue , que coinciden con los campos deValueDlpPolicycorrespondiente.

En la figura 1. Diagrama de las directivas de dos y cuatro reglas.

Ejemplos

El par de solicitud y respuesta siguiente muestra cómo recuperar un informe de MailFilterList de filtrado de correo electrónico Actions. Para mayor claridad, saltos de línea se han agregado a la solicitud y se quitaron algunos resultados Atom XML de los 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>

La solicitud de informe de MailFilterList y la respuesta siguiente recupera el campo Display para todos los dominios asociado con la organización de Office 365, en formato JSON. Para mayor claridad, saltos de línea se han agregado a la solicitud.

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 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 restringen las entradas que se devuelve el informe. Campos marcados [In] en los campos de tabla puede ser incluyen la opción $select= y aparecen en las entradas de informe, pero no va a contener ningún dato útil.

• Campos marcados [In/Out] en los campos de tabla puede utilizarse en Opciones de ($filter= y $orderby=) de la restricción de entrada y de selección de columna ($select=). 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 MailFilterList 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 PowerShell correspondientes

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

Permisos

La cuenta de tener acceso a los informes de debe tener permisos administrativos en esa organización Office 365. Si la cuenta puede ver este informe en el panel de control de 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.

Disponibilidad, la persistencia y la granularidad de datos

La información de este informe no está basado en el tiempo. Partes de los datos devueltos por este informe dependen de cómo el administrador haya configurado los servicios de Office 365. Este informe está disponible siempre que la suscripción no ha caducado.