tipo de recurso filter

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor de versão.

Determina quais objetos devem ser provisionados para o aplicativo. Por exemplo, talvez você queira provisionar apenas usuários localizados nos EUA. Quando um filtro de scoping estiver presente, os objetos que não satisfazem o filtro serão ignorados durante a sincronização.

O filtro faz parte do mapeamento de objetos. Ele consiste em vários conjuntos de grupos de filtros, e cada grupo de filtros contém uma ou mais cláusulas. Um objeto é considerado no escopo do grupo (o grupo é avaliado para ) somente se todas as cláusulas do grupo true são avaliadas para true .

Um objeto é considerado no escopo do conjunto de grupos (o conjunto de grupos é avaliado como ) se qualquer um dos grupos no conjunto true for avaliado como true .

Para obter mais informações, consulte Provisionamento de aplicativo baseado em atributo com filtros de scoping

Propriedades

Propriedade	Tipo	Descrição
categoryFilterGroups	coleção filterGroup	*Experimental* Conjunto de grupos de filtros usado para decidir se determinado objeto pertence e deve ser processado como parte desse mapeamento de objeto. Um objeto será considerado no escopo se QUALQUER um true dos grupos na coleção for avaliado como.
grupos	coleção filterGroup	Conjunto de grupos de filtros usado para decidir se determinado objeto está no escopo do provisionamento. Este é o filtro que deve ser usado na maioria dos casos. Se um objeto usado para satisfazer esse filtro em um dado momento e, em seguida, o objeto ou o filtro foi alterado para que o filtro não seja mais satisfeito, esse objeto *será des-provisionado". Um objeto será considerado no escopo se QUALQUER um true dos grupos na coleção for avaliado como.
inputFilterGroups	coleção filterGroup	*Experimental* Filter group set used to filter out objects at the early stage of reading them from the directory. Se um objeto não satisfaça esse filtro, ele não será processado ainda mais. É importante entender que, se um objeto usado para satisfazer esse filtro em um determinado momento e, em seguida, o objeto ou o filtro foi alterado para que o filtro não seja mais satisfeito, esse objeto NÃO será des provisionado. Um objeto será considerado no escopo se QUALQUER um true dos grupos na coleção for avaliado como.

Representação JSON

Veja a seguir uma representação JSON do recurso.

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