Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Пространство имен: 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