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


channel: completeMigration

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

Важно!

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

Завершите миграцию на существующие или новые каналы. Операции полной миграции изначально ограничивались только что созданными стандартными каналами с помощью шаблонов миграции, специально разработанных для начального процесса миграции. Дополнительные сведения см. в статье Импорт сообщений сторонних платформ в Teams с помощью Microsoft Graph.

При завершении миграции для новых и существующих каналов учитывайте следующие моменты.

  • Когда канал создается в режиме миграции для первоначального потока импорта, свойство migrationMode для канала в команде обновляется до completed , а не удаляется, а состояние постоянно помечается для чатов или каналов. Режим миграции — это специальное состояние, которое предотвращает выполнение определенных операций, таких как отправка сообщений и добавление членов, в процессе переноса данных. Родительская команда не помечается режимом миграции, так как команды не могут переходить в режим миграции; могут быть доступны только их дочерние каналы (общий, стандартный, частный и общий).
  • Для существующих каналов, которые уже находятся в режиме миграции, API завершает процесс миграции сообщений путем обновления migrationMode на completed для канала в команде.

После выполнения запроса completeMigration для существующих или новых каналов вы по-прежнему можете импортировать дополнительные сообщения в команду, вызвав канал startMigration.

Этот API поддерживает следующие типы каналов.

Entities Подтип Поддержка режима миграции Примечания
Каналы Standard, частный, общий Новые и существующие Каналы должны быть созданы или уже находятся в режиме миграции.

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

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

Разрешения

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

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

HTTP-запрос

POST /teams/{team-id}/channels/{channel-id}/completeMigration

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

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

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

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

Отклик

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

Примеры

Пример 1. Завершение миграции, когда канал находится в режиме миграции

В следующем примере показано, как завершить миграцию, когда канал находится в режиме миграции.

Запрос

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

POST https://graph.microsoft.com/beta/teams/57fb72d0-d811-46f4-8947-305e6072eaa5/channels/19:4b6bed8d24574f6a9e436813cb2617d8@thread.tacv2/completeMigration

Отклик

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

HTTP/1.1 204 No Content

Пример 2. Завершение миграции, когда канал не в режиме миграции

В следующем примере показано, как завершить миграцию, если канал не в режиме миграции. Этот запрос завершается сбоем с ответом 400 Bad Request .

Запрос

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

POST https://graph.microsoft.com/beta/teams/57fb72d0-d811-46f4-8947-305e6072eaa5/channels/19:4b6bed8d24574f6a9e436813cb2617d8@thread.tacv2/completeMigration

Отклик

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

HTTP/1.1 400 Bad Request