tipo de recurso de filtro

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 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 escopo está presente, objetos que não atendem ao filtro sã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 como true) somente se todas as cláusulas do grupo forem avaliadas como true.

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

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

Propriedades

Propriedade	Tipo	Descrição
categoryFilterGroups	coleção filterGroup	*Experimental* Conjunto de grupo 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 ANY dos grupos da coleção for avaliado como true.
grupos	coleção filterGroup	Conjunto de grupo de filtros usado para decidir se determinado objeto está no escopo do provisionamento. Esse é o filtro que deve ser usado na maioria dos casos. Se um objeto usado para atender a esse filtro em um determinado momento e, em seguida, o objeto ou o filtro foi alterado para que o filtro não fique satisfeito por mais tempo, esse objeto *será despro provisionado". Um objeto será considerado no escopo se ANY dos grupos da coleção for avaliado como true.
inputFilterGroups	coleção filterGroup	*Experimental* Conjunto de grupos de filtro usado para filtrar objetos no estágio inicial da leitura do diretório. Se um objeto não atender a esse filtro, ele não será processado mais adiante. Importante entender é que, se um objeto usado para satisfazer esse filtro em 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á despro provisionado. Um objeto será considerado no escopo se ANY dos grupos da coleção for avaliado como true.

Representação JSON

A representação JSON a seguir mostra o tipo de recurso.

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