更新 schemaExtension

命名空间:microsoft.graph

更新指定 schemaExtension 的定义中的属性

这意味着无法从定义中删除自定义属性或目标资源类型,但可以添加新的自定义属性并更改扩展的说明。

只有当扩展位于"开发中"或"可用"状态时,才能对 扩展进行附加****更新。

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

对于委派流,登录用户可以更新架构扩展,只要该扩展的所有者属性设置为已登录用户拥有的应用程序的 appId。 该应用程序可以是最初创建扩展的应用程序,或者是登录用户拥有的一些其他应用程序。

owner 属性 此条件允许登录用户通过他们并不拥有的其他应用程序(如 Microsoft Graph Explorer)进行更新。 使用 Graph Explorer 更新 schemaExtension 资源时,请包含PATCH 请求正文中的 owner 属性。 有关详细信息,请参阅 Microsoft Graph已知问题中的扩展Graph。

权限

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

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

HTTP 请求

PATCH /schemaExtensions/{id}

可选的请求标头

名称 说明
Authorization Bearer {token}。必需。
Content-Type application/json

请求正文

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

属性 类型 说明
说明 String 架构扩展的说明。
properties extensionSchemaProperty 集合 构成架构扩展定义的属性名称和类型的集合。 只允许进行增量更改。
status String 架构扩展的生命周期状态。 创建时的初始状态为 InDevelopment。 可能的状态转换从"开发 中"转换为**"可用**"和 " 可用"到"已弃用"。
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

另请参阅