Поделиться через

Удаление вложения

  • Статья

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Удалите вложение из события пользовательского календаря, сообщения, задачи Outlook или публикации.

Предостережение

Задачи Outlook устарели и не возвращают данные 10 августа 2022 г. Обновите существующие приложения, использующие эту функцию, с задачами Outlook.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ✅ ✅ ✅

Разрешения

В зависимости от ресурса (событие, сообщение, outlookTask или post), к которому присоединено вложение, и типа разрешения (делегированного или приложения), разрешение, указанное в следующей таблице, является наименее привилегированным, необходимым для вызова этого API. Чтобы получить дополнительные сведения, в том числе о соблюдении осторожности перед выбором разрешений с повышенными привилегиями, найдите следующие разрешения в разделе Разрешения.

Поддерживаемый ресурс Делегированное (рабочая или учебная учетная запись) Делегированное (личная учетная запись Майкрософт) Для приложений
event Calendars.ReadWrite Calendars.ReadWrite Calendars.ReadWrite
message Mail.ReadWrite Mail.ReadWrite Mail.ReadWrite
outlookTask Tasks.ReadWrite Tasks.ReadWrite Не поддерживается
post Group.ReadWrite.All Не поддерживается Не поддерживается

HTTP-запрос

Вложения события в календаре по умолчанию для пользователя.

DELETE /me/events/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/events/{id}/attachments/{id}

DELETE /me/calendar/events/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/calendar/events/{id}/attachments/{id}

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

DELETE /me/calendars/{id}/events/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/calendars/{id}/events/{id}/attachments/{id}

Вложения для события в календаре , принадлежащего пользователю по умолчанию calendarGroup.

DELETE /me/calendars/{id}/events/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/calendars/{id}/events/{id}/attachments/{id}

Вложения для события в календаре , принадлежащего группе calendarGroup пользователя.

DELETE /me/calendarGroups/{id}/calendars/{id}/events/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{id}/attachments/{id}

Вложения сообщения в почтовом ящике пользователя.

DELETE /me/messages/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/messages/{id}/attachments/{id}

Вложения сообщения в папке mailFolder верхнего уровня в почтовом ящике пользователя.

DELETE /me/mailFolders/{id}/messages/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}/attachments/{id}

Вложения для сообщения , содержащегося в дочерней папке mailFolder в почтовом ящике пользователя. В следующем примере показан один уровень вложенности, но сообщение может находиться в дочернем элементе дочернего элемента и т. д.

DELETE /me/mailFolders/{id}/childFolders/{id}/.../messages/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/mailFolders/{id}/childFolders/{id}/messages/{id}/attachments/{id}

Вложения для задачи Outlook.

DELETE /me/outlook/tasks/{id}/attachments/{id}
DELETE /users/{id}/outlook/tasks/{id}/attachments/{id}

Вложения для записи в потоке , принадлежав к беседе группы.

DELETE /groups/{id}/threads/{id}/posts/{id}/attachments/{id}
DELETE /groups/{id}/conversations/{id}/threads/{id}/posts/{id}/attachments/{id}

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

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

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

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

Отклик

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

Пример

Запрос

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

DELETE https://graph.microsoft.com/beta/me/events/{id}/attachments/{id}

Отклик

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

HTTP/1.1 204 No Content