tipo de recurso filter

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Determina qué objetos se deben aprovisionar en la aplicación. Por ejemplo, es posible que solo quiera aprovisionar usuarios que se encuentren en EE. UU. Cuando hay un filtro de ámbito, los objetos que no cumplen el filtro se omiten durante la sincronización.

El filtro forma parte de la asignación de objetos. Consta de varios conjuntos de grupos de filtros y cada grupo de filtros contiene una o varias cláusulas. Un objeto se considera en el ámbito del grupo (el grupo se evalúa como true) solo si todas las cláusulas del grupo se evalúan como true.

Un objeto se considera en el ámbito del conjunto de grupos (el conjunto de grupos se evalúa truecomo ) si alguno de los grupos del conjunto se evalúa truecomo .

Para obtener más información, consulte Aprovisionamiento de aplicaciones basadas en atributos con filtros de ámbito.

Propiedades

Propiedad	Tipo	Descripción
categoryFilterGroups	filterGroup (colección)	*Experimental* Conjunto de grupos de filtros que se usa para decidir si un objeto determinado pertenece a y se debe procesar como parte de esta asignación de objetos. Un objeto se considera en el ámbito si ANY de los grupos de la colección se evalúa truecomo .
groups	filterGroup (colección)	Conjunto de grupos de filtros que se usa para decidir si un objeto determinado está en el ámbito del aprovisionamiento. Este es el filtro que se debe usar en la mayoría de los casos. Si un objeto usado para satisfacer este filtro en un momento dado y, a continuación, el objeto o el filtro se cambiaron para que el filtro no se cumpla más tiempo, dicho objeto *se desaprovisionará". Un objeto se considera en el ámbito si ANY de los grupos de la colección se evalúa truecomo .
inputFilterGroups	filterGroup (colección)	*Experimental* Conjunto de grupos de filtros que se usa para filtrar objetos en la fase inicial de su lectura desde el directorio. Si un objeto no cumple este filtro, no se procesará más. Es importante comprender que si un objeto usado para satisfacer este filtro en un momento determinado y, a continuación, el objeto o el filtro se cambiaron para que el filtro ya no se cumpla, dicho objeto NO se desaprovisionará. Un objeto se considera en el ámbito si ANY de los grupos de la colección se evalúa truecomo .

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "categoryFilterGroups": [
    {
      "@odata.type": "microsoft.graph.filterGroup"
    }
  ],
  "groups": [
    {
      "@odata.type": "microsoft.graph.filterGroup"
    }
  ],
  "inputFilterGroups": [
    {
      "@odata.type": "microsoft.graph.filterGroup"
    }
  ]
}