更新 administrativeUnit

命名空间:microsoft.graph

更新 administrativeUnit 对象的属性。

权限

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

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

若要更新管理单元,必须为调用主体分配以下 Azure AD 角色之一:

  • 特权角色管理员
  • 全局管理员

HTTP 请求

PATCH /directory/administrativeUnits/{id}

请求标头

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

请求正文

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

属性 类型 说明
说明 string 管理单元的说明。
displayName string 管理单元的显示名称。

由于 administrativeUnit 资源支持 扩展,因此可以使用该 PATCH 操作在现有 administrativeUnit 实例的扩展的自定义属性中添加、更新或删除自己的特定于应用的数据。

响应

如果成功,此方法返回 204 No Content 响应代码。

示例

请求

PATCH https://graph.microsoft.com/v1.0/directory/administrativeUnits/4d7ea995-bc0f-45c0-8c3e-132e93bf95f8
Content-type: application/json

{
    "displayName": "Greater Seattle District Technical Schools"
}

响应

HTTP/1.1 204 No Content

另请参阅