Edit

directoryDefinition resource type

  • Article

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Provides the synchronization engine information about a directory and its objects. This resource tells the synchronization engine, for example, that the directory has objects named user and group, which attributes are supported for those objects, and the types for those attributes. In order for the object and attribute to participate in synchronization rules and object mappings, they must be defined as part of the directory definition.

In general, the default synchronization schema provided as part of the synchronization template defines the most commonly used objects and attributes for that directory. However, if the directory supports the addition of custom attributes, you might want to expand the default definition with your own custom objects or attributes. For more information, see the following articles.

Directory definitions are updated as part of the synchronization schema.

Inherits from entity.

Methods

Method Return Type Description
Discover directoryDefinition directoryDefinition Discover the schema and supported properties of the directory.

Properties

Property Type Description
id String Directory identifier. Not nullable. Inherited from entity.
name String Name of the directory. Must be unique within the synchronization schema. Not nullable.
objects objectDefinition collection Collection of objects supported by the directory.
readOnly Boolean Whether this object is read-only.
version String Read only value that indicates version discovered. null if discovery hasn't yet occurred.
discoveryDateTime DateTimeOffset Represents the discovery date and time using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
discoverabilities directoryDefinitionDiscoverabilities Read-only value indicating what type of discovery the app supports. The possible values are: None, AttributeNames, AttributeDataTypes, AttributeReadOnly, ReferenceAttributes, UnknownFutureValue. This is a multi-valued object.

JSON representation

The following JSON representation shows the resource type.

{
  "discoverabilities": "String",
  "discoveryDateTime": "DateTimeOffset",
  "id": "String",
  "metadata": [
    {
      "@odata.type": "microsoft.graph.stringKeyStringValuePair"
    }
  ],
  "name": "String",
  "objects": [
    {
      "@odata.type": "microsoft.graph.objectDefinition"
    }
  ],
  "version": "String"
}