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

Удаление разрешения на общий доступ для файла или папки

  • Статья

В этой статье рассказывается, как отменить доступ к ресурсу DriveItem.

Вы можете удалить только те разрешения на общий доступ, которые не были унаследованы. Свойство inheritedFrom должно иметь значение null.

Разрешения

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

Тип разрешения Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись) Files.ReadWrite, Files.ReadWrite.All, Sites.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) 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.

Пример

В этом примере показано, как удалить разрешение, идентифицированное как {perm-id} из элемента {item-id} в хранилище OneDrive текущего пользователя.

DELETE /me/drive/items/{item-id}/permissions/{perm-id}

Отклик

HTTP/1.1 204 No Content

Замечания

  • Диски, у которых для свойства driveType задано значение personal (личное хранилище OneDrive), не могут создавать и изменять разрешения в корневом ресурсе DriveItem.