synchronizationSchema tipo de recurso

Namespace: microsoft.graph

Define quais objetos serão sincronizados e como eles são sincronizados. O esquema de sincronização contém a maioria das informações de instalação para um trabalho de sincronização específico. Normalmente, você personaliza alguns dos mapeamentos de atributo ou adiciona um filtro de escopo para sincronizar apenas objetos que atendem a uma determinada condição.

As seções a seguir descrevem os componentes de alto nível do esquema de sincronização. Para obter mais informações, consulte Entender o mapeamento de esquemas e atributos do Microsoft Entra– Active Directory para o Microsoft Entra ID.

Definições de diretório

As definições de diretório fornecem ao mecanismo de sincronização informações sobre diretórios e seus objetos. Por exemplo, a definição de diretório informa ao mecanismo de sincronização que um diretório do Microsoft Entra tem objetos chamados usuário e grupo, quais atributos têm suporte para esses objetos e os tipos para esses atributos. Para que um determinado objeto e atributo sejam usados em regras de sincronização/mapeamentos de objetos, eles devem ser definidos como parte da definição de diretório.

Regras de sincronização

As regras de sincronização são o núcleo da configuração da sincronização. Eles definem para o mecanismo de sincronização como a sincronização deve ser executada, incluindo quais objetos devem ser sincronizados, como os objetos do diretório de origem devem ser combinados com objetos no diretório de destino e como os atributos devem ser transformados quando eles são sincronizados da origem para o diretório de destino.

Mapeamentos de objetos

Os mapeamentos de objetos são a parte principal da regra de sincronização. Cada mapeamento de objeto define como um determinado objeto deve ser sincronizado do diretório de origem para o de destino. Em particular, o mapeamento define como um objeto no diretório de origem deve ser correspondido a um objeto no diretório de destino, quais filtros de escopo (se houver) devem ser usados para decidir se um objeto deve ser provisionado e como os atributos de objeto devem ser transformados quando eles são sincronizados do diretório de origem para o diretório de destino.

Métodos

Método Tipo de retorno Descrição
Get synchronizationSchema Leia as propriedades e as relações do objeto synchronizationSchema .
Atualizar Nenhum(a) Atualize o esquema de sincronização.
Reset Nenhum Exclua o esquema personalizado, redefinindo o esquema para a configuração padrão.
Obter operadores do filtro de esquema coleção filterOperatorSchema Liste todos os operadores com suporte nos filtros de escopo.
Obter funções de esquema coleção attributeMappingFunctionSchema Liste todas as funções com suporte nas expressões de mapeamento de atributos.
Analisar expressão de mapeamento de atributos parseExpressionResponse Analise uma expressão de cadeia de caracteres em um objeto attributeMappingSource .

Propriedades

Propriedade Tipo Descrição
id Cadeia de caracteres Identificador exclusivo para o esquema.
synchronizationRules coleção synchronizationRule Uma coleção de regras de sincronização configuradas para synchronizationJob ou synchronizationTemplate.
versão Cadeia de caracteres A versão do esquema, atualizada automaticamente a cada alteração de esquema.

Relações

Relação Tipo Descrição
diretórios coleção directoryDefinition Contém a coleção de diretórios e todos os seus objetos.

Representação JSON

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

{
  "@odata.type": "#microsoft.graph.synchronizationSchema",
  "id": "String (identifier)",
  "synchronizationRules": [
    {
      "@odata.type": "microsoft.graph.synchronizationRule"
    }
  ],
  "version": "String"
}