Partilhar via


synchronizationRule resource type

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.

Define a forma como a sincronização deve ser executada para o motor de sincronização, incluindo os objetos a sincronizar e em que direção, como os objetos do diretório de origem devem ser correspondidos com objetos no diretório de destino e como os atributos devem ser transformados quando são sincronizados da origem para o diretório de destino.

Nota: As regras de sincronização definem a sincronização numa direção: do diretório de origem ao diretório de destino. Os diretórios de origem e de destino são definidos como parte das propriedades da regra.

As regras de sincronização são atualizadas como parte do esquema de sincronização.

Propriedades

Propriedade Tipo Descrição
containerFilter containerFilter Os nomes e identificadores das unidades organizacionais que estão no âmbito de uma regra de sincronização. containerFilter e groupFilter são propriedades mutuamente exclusivas que não podem ser configuradas no mesmo pedido. Atualmente, só é suportado para cenários de sincronização de cloud do Azure AD Connect.
editável Booliano true se a regra de sincronização puder ser personalizada; false se esta regra for só de leitura e não deve ser alterada.
groupFilter groupFilter Os nomes e identificadores dos grupos que estão no âmbito de uma regra de sincronização. containerFilter e groupFilter são propriedades mutuamente exclusivas que não podem ser configuradas no mesmo pedido. Atualmente, só é suportado para cenários de sincronização de cloud do Azure AD Connect.
id Cadeia de caracteres Identificador da regra de sincronização. Tem de ser um dos identificadores reconhecidos pelo motor de sincronização. Os identificadores de regras suportados podem ser encontrados no modelo de sincronização devolvido pela API.
metadados stringKeyStringValuePair collection Propriedades de extensão adicionais. A menos que seja instruído explicitamente pela equipa de suporte, os valores de metadados não devem ser alterados.
nome Cadeia de caracteres Nome legível por humanos da regra de sincronização. Não anulável.
objectMappings coleção objectMapping Coleção de mapeamentos de objetos suportados pela regra. Indica ao motor de sincronização quais os objetos que devem ser sincronizados.
prioridade Número inteiro Prioridade relativamente a outras regras na synchronizationSchema. As regras com o número de prioridade mais baixo serão processadas primeiro.
sourceDirectoryName Cadeia de caracteres Nome do diretório de origem. Tem de corresponder a uma das definições de diretório em synchronizationSchema.
targetDirectoryName Cadeia de caracteres Nome do diretório de destino. Tem de corresponder a uma das definições de diretório em synchronizationSchema.

Relações

Nenhum

Representação JSON

A representação JSON seguinte mostra o tipo de recurso.

{
  "containerFilter": {
    "@odata.type": "microsoft.graph.containerFilter"
  },
  "editable": true,
  "groupFilter": {
    "@odata.type": "microsoft.graph.groupFilter"
  },
  "id": "String",
  "metadata": [
    {
      "@odata.type": "microsoft.graph.stringKeyStringValuePair"
    }
  ],
  "name": "String",
  "objectMappings": [
    {
      "@odata.type": "microsoft.graph.objectMapping"
    }
  ],
  "priority": 1024,
  "sourceDirectoryName": "String",
  "targetDirectoryName": "String"
}