命名空间:microsoft.graph
从指定的资源实例中删除开放扩展(openTypeExtension 对象)。
有关支持打开扩展的资源列表,请参阅“ 权限 ”部分中的表。
此 API 可用于以下国家级云部署。
| 全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
权限
根据要从中删除扩展的资源以及委派的权限类型或请求的应用程序) (,下表中指定的权限是调用此 API 所需的最低权限。 若要了解其他信息, 在 特权权限之前要特别小心,在"权限" 中搜索。
| 支持的资源 | 委派(工作或学校帐户) | 委派(个人 Microsoft 帐户) | 应用程序 |
|---|---|---|---|
| 设备 | Directory.AccessAsUser.All | 不支持 | Device.ReadWrite.All |
| 事件 | Calendars.ReadWrite | Calendars.ReadWrite | Calendars.ReadWrite |
| 组 | Group.ReadWrite.All | 不支持 | Group.ReadWrite.All |
| 组事件 | Group.ReadWrite.All | 不支持 | 不支持 |
| 组帖子 | Group.ReadWrite.All | 不支持 | Group.ReadWrite.All |
| 邮件 | Mail.ReadWrite | Mail.ReadWrite | Mail.ReadWrite |
| 注释 | ShortNotes.ReadWrite | ShortNotes.ReadWrite | ShortNotes.ReadWrite.All |
| 组织 | Organization.ReadWrite.All | 不支持 | Organization.ReadWrite.All |
| 个人联系人 | Contacts.ReadWrite | Contacts.ReadWrite | Contacts.ReadWrite |
| todoTask | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |
| todoTasklist | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |
| 用户 | User.ReadWrite | 不支持 | User.ReadWrite.All |
HTTP 请求
在请求中,标识资源实例,使用资源实例的 extensions 导航属性标识扩展插件,然后对此扩展插件实例执行 DELETE。
DELETE /devices/{Id}/extensions/{extensionId}
DELETE /users/{id|userPrincipalName}/events/{id}/extensions/{extensionId}
DELETE /groups/{id}/extensions/{extensionId}
DELETE /groups/{id}/events/{id}/extensions/{extensionId}
DELETE /groups/{id}/threads/{id}/posts/{id}/extensions/{extensionId}
DELETE /users/{id|userPrincipalName}/messages/{id}/extensions/{extensionId}
DELETE /users/{userId|userPrincipalName}/notes/{noteId}/extensions/{extensionId}
DELETE /organization/{Id}/extensions/{extensionId}
DELETE /users/{id|userPrincipalName}/contacts/{id}/extensions/{extensionId}
DELETE /users/{id|userPrincipalName}/extensions/{extensionId}
DELETE /me/todo/lists/{todoTaskListId}/extensions/{extensionId}
DELETE /me/todo/lists/{todoTaskListId}/tasks/{taskId}/extensions/{extensionId}
DELETE /users/{userId}/todo/lists/{todoTaskListId}/extensions/{extensionId}
DELETE /users/{userId}/todo/lists/{todoTaskListId}/tasks/{taskId}/extensions/{extensionId}
DELETE /users/{id|userPrincipalName}/extensions/{extensionId}
DELETE /me/extensions/{extensionId}
注意: 前面的语法显示了一些识别资源实例的常见方法,以便从中删除扩展。 可以用来标识这些资源实例的所有其他语法均支持以类似的方式从中删除开放扩展。
路径参数
| 参数 | 类型 | 说明 |
|---|---|---|
| extensionId | String | 这可以是扩展名,它是扩展的唯一文本标识符,也可以是连接扩展类型和唯一文本标识符的完全限定名称。 创建扩展时,在 id 属性中返回完全限定的名称。 必需。 |
| id | String | 实例在相应集合中的唯一标识符。 必需。 |
请求标头
| 名称 | 值 |
|---|---|
| Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
请求正文
请勿提供此方法的请求正文。
响应
如果成功,此方法返回 204 No Content 响应代码。 它不会返回响应正文中的任何内容。
示例
请求
第一个示例按其名称引用扩展并删除指定邮件中的扩展。
DELETE https://graph.microsoft.com/v1.0/me/messages/AAMkAGE1M2IyNGNmLTI5MTktNDUyZi1iOTVl===/extensions/Com.Contoso.Referral
第二个示例删除指定组事件中的扩展。
DELETE https://graph.microsoft.com/v1.0/groups/f5480dfd-7d77-4d0b-ba2e-3391953cc74a/events/AAMkADVlN17IsAAA=/extensions/Com.Contoso.Referral
响应
以下示例显示了相应的响应。
HTTP/1.1 204 No Content