更新 schemaExtension

  • 项目

命名空间：microsoft.graph

更新指定 schemaExtension 定义中的属性。 仅当扩展处于 InDevelopment 或 Available 状态时，才能对扩展进行累加更新。 这意味着无法从定义中删除自定义属性或目标资源类型，但可以添加新的自定义属性并更改扩展的说明。

此更新适用于扩展的 targetTypes 属性中包含的所有资源。 这些资源是 支持的资源类型之一。

对于委托流，只要该扩展的 owner 属性设置为已登录用户拥有的应用程序的 appId ，登录用户就可以更新架构扩展。 该应用程序可以是最初创建扩展的应用程序，也可以是登录用户拥有的其他应用程序。

所有者属性的此条件允许已登录用户通过他们不拥有的其他应用程序（如 Microsoft Graph 资源管理器）进行更新。 使用 Graph 资源管理器更新 schemaExtension 资源时，请在 PATCH 请求正文中包含 owner 属性。

此 API 可用于以下国家级云部署。

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国
✅ ✅ ✅ ✅

权限

要调用此 API，需要以下权限之一。 若要了解详细信息，包括如何选择权限的信息，请参阅权限。

权限类型 权限（从最低特权到最高特权）
委派（工作或学校帐户） Application.ReadWrite.All
委派（个人 Microsoft 帐户） 不支持。
应用程序 Application.ReadWrite.All and Directory.ReadWrite.All

HTTP 请求

PATCH /schemaExtensions/{id}

请求标头

名称 说明
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权。
Content-Type application/json. 必需。

请求正文

在请求正文中，提供应更新的相关字段的值。 请求正文中不包括的现有属性将保留其以前的值，或根据对其他属性值的更改重新计算。 为了实现最佳性能，不得添加未变化的现有值。

属性 类型 说明
说明 String 架构扩展的说明。
properties extensionSchemaProperty 集合 构成架构扩展定义的属性名称和类型的集合。 仅允许累加更改。
status String 架构扩展的生命周期状态。 创建时的初始状态为 InDevelopment。 可能的状态转换是从 InDevelopment 到 Available 和 Available 到 Deprecated。
targetTypes String collection 架构扩展适用的支持扩展的 Microsoft Graph 类型集。 仅允许累加更改。

响应

如果成功，此方法返回 204 No Content 响应代码。 尝试从你不拥有 (的应用程序运行此请求，并且未将 owner 属性设置为你拥有的应用程序的 appId ，) 将 403 Forbidden 返回响应代码。

示例

请求

以下示例显示了一个请求。 如果从你不拥有的应用程序运行请求，则必须包含 owner 属性。 在这种情况下，请将 owner 属性设置为你拥有的应用程序的 appId 。

PATCH https://graph.microsoft.com/v1.0/schemaExtensions/exto6x7sfft_courses
Content-type: application/json

{
    "owner": "ef4cb9a8-97c3-4ca7-854b-5cb5ced376fa",
    "properties": [
        {
            "name": "courseId",
            "type": "Integer"
        },
        {
            "name": "courseName",
            "type": "String"
        },
        {
            "name": "courseType",
            "type": "String"
        },
        {
            "name": "courseSupervisors",
            "type": "String"
        }
    ]
}

响应

HTTP/1.1 204 No Content

相关内容