删除 mailboxItem

命名空间：microsoft.graph

使用 disposalType 查询参数指定是软删除还是硬删除项目。

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

权限

为此 API 选择标记为最低特权的权限。只有在应用需要它时，才使用更高的特权权限。有关委派权限和应用程序权限的详细信息，请参阅权限类型。要了解有关这些权限的详细信息，请参阅权限参考。

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

HTTP 请求

DELETE /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}/items/{mailboxItemId}?disposalType={disposalType}

查询参数

在请求 URL 中，提供以下必需的查询参数。

参数	类型	说明
disposalType	String	必填。要执行的删除操作的类型。可能的值为： `softDelete`， `hardDelete`。用于 `softDelete` 遵循 Exchange 软删除语义，或 `hardDelete` 永久删除项。

请求标头

名称	说明
Authorization	必需。详细了解身份验证和授权。

请求正文

请勿提供此方法的请求正文。

响应

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

注意

使用 hardDelete时，仅当客户数据不受法定保留、保留策略、审核、合规性或系统项限制保护时，Exchange 服务才会永久删除该项。否则，请求将失败并显示 403 Forbidden 错误。

示例

示例 1：软删除邮箱项

以下示例演示如何使用软删除文件夹 disposalType=softDelete中的邮箱项。

请求

以下示例显示了一个请求。

HTTP
JavaScript

DELETE https://graph.microsoft.com/v1.0/admin/exchange/mailboxes/MBX:e0648f21@aab09c93/folders/inbox/items/AAMkADk0MzI?disposalType=softDelete


const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/admin/exchange/mailboxes/MBX:e0648f21@aab09c93/folders/inbox/items/AAMkADk0MzI?disposalType=softDelete')
	.delete();

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

响应

以下示例显示了相应的响应。

HTTP/1.1 204 No Content

示例 2：硬删除邮箱项

下面的示例演示如何使用硬删除可恢复邮件 disposalType=hardDelete中符合条件的邮箱项。

请求