删除 directorySetting
命名空间:microsoft.graph
重要
Microsoft Graph /beta
版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
删除目录设置。
此 API 可用于以下国家级云部署。
全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
权限
下表显示了对每种受支持的资源类型调用此 API 所需的最低特权权限。 请遵循 最佳做法 来请求最低特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。
对于除同意策略设置对象之外的所有设置
权限类型 | 最低特权权限 | 更高特权权限 |
---|---|---|
委派(工作或学校帐户) | Directory.ReadWrite.All | Policy.ReadWrite.Authorization |
委派(个人 Microsoft 帐户) | 不支持。 | 不支持。 |
应用程序 | Directory.ReadWrite.All | Policy.ReadWrite.Authorization |
对于“同意策略设置”对象
更新“同意策略设置” 目录Setting 对象需要以下权限。
权限类型 | 最低特权权限 | 更高特权权限 |
---|---|---|
委派(工作或学校帐户) | Directory.ReadWrite.All | Policy.ReadWrite.Authorization |
委派(个人 Microsoft 帐户) | 不支持。 | 不支持。 |
应用程序 | Directory.ReadWrite.All | Policy.ReadWrite.Authorization |
对于委托方案,调用用户至少需要以下Microsoft Entra角色之一。
Microsoft Entra角色 | 允许的权限 |
---|---|
已加入Microsoft Entra设备本地管理员 目录读取器 全局读取者 |
读取有关设置模板和设置的基本属性 |
组管理员 目录作者 |
管理所有组设置 |
身份验证策略管理员 | 更新 Password Rule Settings |
用户管理员 | 读取有关设置模板和设置的基本属性 更新设置 |
HTTP 请求
删除租户范围的设置。
DELETE /settings/{directorySettingId}
删除组特定的设置。
DELETE /groups/{groupId}/settings/{directorySettingId}
请求标头
名称 | 说明 |
---|---|
Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
请求正文
请勿提供此方法的请求正文。
响应
如果成功,此方法返回 204 No Content
响应代码。 它不会在响应正文中返回任何内容。
示例
请求
以下示例显示了一个请求。
DELETE https://graph.microsoft.com/beta/settings/3c105fc3-2254-4861-9e2d-d59e2126f3ef
响应
HTTP/1.1 204 No Content
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈