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


driveItem: discardCheckout

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

Важно!

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

Удалите проверка из элемента driveItem. Это действие освобождает ресурс driveItem , который был извлечен ранее. Все изменения, внесенные в элемент во время его извлечении, удаляются.

Тот же пользователь, который выполнил извлечение, должен отменить его. Другой альтернативой является использование разрешений приложений.

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

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

Разрешения

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

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) Files.ReadWrite Files.ReadWrite.All, Sites.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Files.ReadWrite Files.ReadWrite.All
Приложение Files.ReadWrite.All Sites.ReadWrite.All

Примечание.

SharePoint Embedded требует разрешения на FileStorageContainer.Selected доступ к содержимому контейнера. Это разрешение отличается от указанных ранее. В дополнение к разрешениям Microsoft Graph приложение должно иметь необходимые разрешения типа контейнера для вызова этого API. Дополнительные сведения см. в статье Проверка подлинности и авторизация SharePoint Embedded.

HTTP-запрос

POST /drives/{driveId}/items/{itemId}/discardCheckout
POST /groups/{groupId}/drive/items/{itemId}/discardCheckout
POST /me/drive/items/{item-id}/discardCheckout
POST /sites/{siteId}/drive/items/{itemId}/discardCheckout
POST /users/{userId}/drive/items/{itemId}/discardCheckout

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

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

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

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

Отклик

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

Ответы с ошибками

Запрос возвращает, 400 Bad Request если файл не извлечен. Запросы, выполненные с делегированным доступом, возвращаются 423 Locked , если файл извлечен другим пользователем. Запросы, выполненные с доступом к приложению, могут отменить любую проверку.

Дополнительные сведения о том, как возвращаются ошибки, см. в разделе Ответы на ошибки.

Примеры

Запрос

В следующем примере показан запрос на отмену оформления заказа для файла, определяемого с помощью {item-id}.

POST https://graph.microsoft.com/beta/drives/{drive-id}/items/{item-id}/discardCheckout

Отклик

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

HTTP/1.1 204 No content