directoryDefinition 资源类型

命名空间：microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

提供有关目录及其对象的同步引擎信息。 例如，此资源告知同步引擎，该目录具有名为 user 和 group 的对象，这些对象支持哪些属性以及这些属性的类型。 为了使对象和属性参与同步规则和对象映射，必须将它们定义为目录定义的一部分。

通常，作为同步模板的一部分提供的默认同步架构将定义该目录最常用的对象和属性。 但是，如果目录支持添加自定义属性，您可能需要使用自己的自定义对象或属性扩展默认定义。 有关详细信息，请参阅使用自定义属性配置同步和配置与目录扩展属性的同步。

目录定义更新为同步架构的 一部分。

Methods

方法	返回类型	说明
发现 directoryDefinition	directoryDefinition	发现目录的架构和支持的属性。

属性

属性	类型	说明
id	String	目录标识符。 不可为 null。
metadata	metadataEntry 集合	其他扩展属性。 除非明确提到，否则不应更改元数据值。
name	String	目录的名称。 在同步架构中 必须是唯一的。 不可为 null。
对象	objectDefinition 集合	目录支持的对象集合。
version	String	只读值，指示发现的版本。 null 如果尚未发现。
discoveryDateTime	DateTimeOffset	表示使用 ISO 8601 格式的发现日期和时间，并且始终采用 UTC 时间。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。
discoverabilities	directoryDefinitionDiscoverabilities	只读值，指示应用支持哪种类型的发现。 可取值为：AttributeDataTypes、AttributeNames、AttributeReadOnly、None、ReferenceAttributes、UnknownFutureValue。

JSON 表示形式

下面是资源的 JSON 表示形式。

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