schemaExtension 资源类型(架构扩展)

命名空间:microsoft.graph

可以通过架构扩展定义架构来扩展强类型的自定义数据并将其添加到资源类型。自定义数据在扩展资源上作为复杂类型显示。

以下资源类型支持架构扩展:

请参阅架构扩展示例了解如何将自定义数据添加到组。

方法

方法 返回类型 说明
Create schemaExtension 创建架构扩展定义。
List schemaExtension 列出可用的 schemaExtension 定义及其属性。
Get schemaExtension 读取特定的 schemaExtension 定义的属性。
Update schemaExtension 更新 schemaExtension 定义。
Delete 删除 schemaExtension 定义。

属性

属性 类型 说明
说明 String 架构扩展的说明。支持$filtereq)。
id String 架构扩展定义的唯一标识符。
你可以使用下面两种方法之一分配值:
  • 连接已验证域名与架构扩展名称,形成此格式的唯一字符串:{domainName}_{schemaName}。例如 contoso_mySchema
  • 提供一个架构名称,并让 Microsoft Graph 使用此格式的架构名称完成 id 分配:ext{8-random-alphanumeric-chars}_{schema-name}。例如 extkvbmkofy_mySchema
此属性创建后无法更改。支持 $filtereq)。
所有者 String 属于架构扩展的所有者的应用程序的 appId。 可在创建时提供此属性以设置所有者。 如果未提供,则会将调用应用程序的 appId 设置为所有者。 在任一情况下,已登录用户均必须是应用程序的所有者。 因此,如果使用 Graph 浏览器新建一个架构扩展定义,则 必须 提供 owner 属性(以此为例)。 设置后,此属性为只读,且无法更改。 支持 $filtereq)。
properties extensionSchemaProperty 集合 构成架构扩展定义的属性名称和类型的集合。
status String 架构扩展的生命周期状态。 可能的状态为 InDevelopmentAvailableDeprecated。 创建后将自动设置为 InDevelopment架构扩展将提供关于可能的状态转换和行为的详细信息。 支持 $filtereq)。
targetTypes String collection 架构扩展适用的支持扩展的 Microsoft Graph 类型集。 从 联系人设备事件邮件组织帖子用户 中选择。

JSON 表示形式

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

{
  "description": "String",
  "id": "String (identifier)",
  "owner": "String",
  "properties": [{"@odata.type": "microsoft.graph.extensionSchemaProperty"}],
  "status": "String",
  "targetTypes": ["String"]
}