teamworkSectionItem: move

Пространство имен: 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-запрос

POST /users/{user-id}/teamwork/sections/{teamworkSection-id}/items/{teamworkSectionItem-id}/move

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

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

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

В тексте запроса укажите представление параметров в формате JSON.

В следующей таблице перечислены параметры, необходимые при вызове этого действия.

Параметр Тип Описание
targetSectionId String Идентификатор раздела, в который перемещается элемент. Обязательно.

Отклик

В случае успешного 200 OK выполнения это действие возвращает код ответа и teamworkSectionItem в тексте ответа, представляющего элемент в целевом разделе.

Примечание.

Ответ содержит обновленное значение @odata.etag . Используйте это значение в качестве заголовка If-Match для всех последующих операций изменения.

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

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

Примеры

Запрос

В следующем примере показан запрос на перемещение чата из раздела "Избранное" в раздел "Project Alpha".

POST https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/a1b2c3d4-e5f6-7890-abcd-ef1234567890/items/19:d5b2c3a4-e6f7-8901-abcd-ef3456789012@thread.v2/move
Content-type: application/json
If-Match: "1742515200"

{
  "targetSectionId": "c3d4e5f6-a7b8-9012-cdef-123456789012"
}

Отклик

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

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-type: application/json

{
  "@odata.type": "#microsoft.graph.teamworkSectionItem",
  "@odata.etag": "\"1742515210\"",
  "id": "19:d5b2c3a4-e6f7-8901-abcd-ef3456789012@thread.v2",
  "itemType": "chat",
  "createdDateTime": "2026-03-08T10:30:00Z",
  "lastModifiedDateTime": null
}