添付ファイルを削除する

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

ユーザーの予定表 イベント、 メッセージ、 メモ、 Outlook タスク、 または投稿から添付ファイルを削除します。

注意

Outlook タスクは非推奨となり、2022 年 8 月 10 日にデータの返品を停止しました。 Outlook タスクでこの機能を使用する既存のアプリを更新します。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国
✅ ✅ ✅ ✅

アクセス許可

添付ファイルが添付されているリソース (イベント、メッセージ、メモ、outlookTask、または投稿) と、要求されたアクセス許可の種類 (委任またはアプリケーション) に応じて、次の表で指定されたアクセス許可が、この API を呼び出すために必要な最小限の特権になります。 より多くの特権アクセス許可を選択する前に注意することを含め、詳細については、[アクセス許可] で次のアクセス許可を検索してください。

サポートされているリソース 委任 (職場または学校のアカウント) 委任 (個人用 Microsoft アカウント) アプリケーション
イベント Calendars.ReadWrite Calendars.ReadWrite Calendars.ReadWrite
メッセージ Mail.ReadWrite Mail.ReadWrite Mail.ReadWrite
注記 ShortNotes.ReadWrite ShortNotes.ReadWrite ShortNotes.ReadWrite.All
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 の子フォルダーに含まれているメッセージの添付ファイル。 次の例は 1 つの入れ子レベルを示していますが、メッセージは子の子に配置されるなどです。

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

ユーザーのメールボックス内の メモ の添付ファイル。

DELETE /me/notes/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/notes/{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}

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは 204 No Content 応答コードを返します。 応答本文では何も返されません。

例

例 1: イベントの添付ファイルを削除する

次の例は、 イベントの添付ファイルを削除する方法を示しています。

要求

次の例は要求を示しています。

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

応答

次の例は応答を示しています。

HTTP/1.1 204 No Content

例 2: メモの添付ファイルを削除する

次の例は、 メモの添付ファイルを削除する方法を示しています。

要求

次の例は要求を示しています。

DELETE https://graph.microsoft.com/beta/me/notes/AAMkAGI2THVSAAA=/attachments/AAMkAGI2attach2

応答

次の例は応答を示しています。

HTTP/1.1 204 No Content
  • Last updated on