ファイルまたはフォルダーの共有アクセス許可を削除する
DriveItem へのアクセスを削除します。
継承されていない共有アクセス許可のみを削除することができます。
InheritedFrom プロパティは null である必要があります。
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
| アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
|---|---|
| 委任 (職場または学校のアカウント) | Files.ReadWrite、Files.ReadWrite.All、Sites.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | Files.ReadWrite、Files.ReadWrite.All |
| アプリケーション | Files.ReadWrite.All、Sites.ReadWrite.All |
HTTP 要求
DELETE /drives/{drive-id}/items/{item-id}/permissions/{perm-id}
DELETE /groups/{group-id}/drive/items/{item-id}/permissions/{perm-id}
DELETE /me/drive/items/{item-id}/permissions/{perm-id}
DELETE /sites/{site-id}/drive/items/{item-id}/permissions/{perm-id}
DELETE /users/{user-id}/drive/items/{item-id}/permissions/{perm-id}
オプションの要求ヘッダー
| 名前 | 型 | 説明 |
|---|---|---|
| if-match | string | この要求ヘッダーが含まれていて、指定された eTag (または cTag) が項目の現在のタグに一致しない場合には、412 Precondition Failed 応答が返され、項目は削除されません。 |
応答
成功した場合、このメソッドは 204 No Content 応答コードを返します。
例
この例では、現在のユーザーの OneDrive 内の項目 {item-id} から {perm-id} として識別されるアクセス許可を削除します。
DELETE /me/drive/items/{item-id}/permissions/{perm-id}
応答
HTTP/1.1 204 No Content
注釈
personal(OneDrive Personal) の driveType を持つドライブは、DriveItem のルートでの作成やアクセス許可の変更を行えません。