directoryDefinition resource type
Namespace: microsoft.graph
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.
- Configure synchronization with custom attributes
- Configure synchronization with directory extension attributes.
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",
"name": "String",
"objects": [
{
"@odata.type": "microsoft.graph.objectDefinition"
}
],
"version": "String"
}
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應