Удаление teamworkSection

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

Важно!

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

Удаление определяемого пользователем раздела из командной работы пользователя. Определенные системой разделы не могут быть удалены.

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

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

Разрешения

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

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

HTTP-запрос

DELETE /users/{user-id}/teamwork/sections/{teamworkSection-id}

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

Заголовок Значение
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
If-Match Значение заметки @microsoft.graph.sectionsVersion , возвращаемой при перечислении разделов, или значение @odata.etag из любого ранее полученного раздела. Требуется для управления оптимистическим параллелизмом.

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

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

Отклик

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

Возможны следующие ошибки.

Код ответа Сообщение
403 Forbidden Этот раздел создан системой и не может быть изменен. Определенные системой разделы не могут быть удалены.
404 Not Found Указанный раздел не найден.
412 Precondition Failed Значение If-Match заголовка не соответствует текущей версии иерархии разделов. Снова выведите список разделов , чтобы получить текущую заметку @microsoft.graph.sectionsVersion и повторите попытку.
428 Precondition Required Для If-Match этой операции требуется заголовок.

Примеры

Запрос

Ниже показан пример запроса.

DELETE https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/a1b2c3d4-e5f6-7890-abcd-ef1234567890
If-Match: "1742515200"

Отклик

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

HTTP/1.1 204 No Content