リストからアイテムを削除する
list からアイテムを削除します。
アクセス許可
アイテムを削除するには、削除するアイテムへの書き込みアクセス権がユーザーに付与されている必要があります。
この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
| アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
|---|---|
| 委任 (職場または学校のアカウント) | Sites.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 |
| アプリケーション | Sites.ReadWrite.All |
HTTP 要求
DELETE /sites/{site-id}/lists/{list-id}/items/{item-id}
オプションの要求ヘッダー
| 名前 | 値 | 説明 |
|---|---|---|
| if-match | etag | この要求ヘッダーが含まれていて、指定された eTag がアイテムの現在のタグに一致しない場合には、412 Precondition Failed 応答が返され、アイテムは削除されません。 |
要求本文
このメソッドには、要求本文を指定しません。
例
DELETE /sites/{site-id}/lists/{list-id}/items/{item-id}
応答
成功した場合、この呼び出しはリソースが削除され返すものがなかったことを示す 204 No Content 応答を返します。
HTTP/1.1 204 No Content