Delete mailboxItem

Пространство имен: microsoft.graph

Удаление элемента mailboxItem из папки mailboxFolder в почтовом ящике.

Используйте параметр запроса disposalType , чтобы указать, следует ли использовать обратимое или жесткое удаление элемента.

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более высокий уровень привилегий или разрешений, только если это требуется вашему приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в статье Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения	Разрешения с наименьшим объемом привилегий	Разрешения с более высоким уровнем привилегий
Делегированные (рабочая или учебная учетная запись)	MailboxItem.ReadWrite	Недоступно.
Делегированные (личная учетная запись Майкрософт)	Не поддерживается.	Не поддерживается.
Приложение	MailboxItem.ReadWrite.All	Недоступно.

HTTP-запрос

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

Параметры запроса

В URL-адресе запроса укажите следующий обязательный параметр запроса.

Параметр	Тип	Описание
Тип удаления	String	Обязательный. Тип выполняемой операции удаления. Возможные значения: softDelete, hardDelete. Используется softDelete для соблюдения семантики мягкого удаления Exchange или hardDelete для окончательного удаления элемента.

Заголовки запросов

Имя	Описание
Авторизация	Обязательно. Дополнительные сведения об аутентификации и авторизации.

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 204 No Content.

Примечание.

При использовании hardDelete, служба Exchange окончательно удаляет элемент только в том случае, если это данные клиента, которые не защищены политикой удержания, политикой хранения, аудитом, соответствием требованиям или ограничением для системных элементов. В противном случае запрос завершается ошибкой 403 Forbidden .

Примеры

Пример 1. Обратимое удаление элемента почтового ящика

В следующем примере показано, как мягко удалить элемент почтового ящика в папке с помощью disposalType=softDelete.

Запрос

Ниже показан пример запроса.

HTTP

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

JavaScript

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.

Запрос

Ниже показан пример запроса.

HTTP

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

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

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

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Отклик

Ниже приводится пример отклика.

HTTP/1.1 204 No Content