directoryDefinition 资源类型

  • 项目

命名空间：microsoft.graph

重要

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

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

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

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

继承自 entity。

Methods

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

属性

属性 类型 说明
id String 目录标识符。 不可为 null。 继承自 entity。
name String 目录的名称。 在 同步架构中必须是唯一的。 不可为 null。
对象 objectDefinition 集合 目录支持的 对象的集合。
readOnly 布尔值 此对象是否为只读。
version String 指示发现的版本的只读值。 null 如果尚未发生发现，则为 。
discoveryDateTime DateTimeOffset 使用 ISO 8601 格式表示发现日期和时间，并且始终采用 UTC 时间。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。
发现能力 directoryDefinitionDiscoverabilities 指示应用支持的发现类型的只读值。 可能的值包括 None、AttributeNames、AttributeDataTypes、AttributeReadOnly、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"
}