通道：completeMigration

命名空间：microsoft.graph

在现有通道或新通道上完成迁移。最初，完整的迁移操作仅限于使用专为初始迁移过程设计的迁移模板的新创建的标准通道。有关详细信息，请参阅使用 Microsoft Graph 将第三方平台消息导入 Teams。

为新通道和现有通道完成迁移时，请考虑以下几点：

在初始导入流迁移模式下创建通道时，团队中频道的属性 migrationMode 将更新为 completed 而不是被删除，并且状态将永久标记为聊天或频道。迁移模式是在数据迁移过程中阻止某些操作（例如发送消息和添加成员）的特殊状态。父团队未使用迁移模式进行标记，因为团队无法进入迁移模式;只有其子频道 (常规频道、标准频道、专用频道和共享) 。
对于已处于迁移模式 的现有 通道，API 通过将 migrationMode 更新为 completed 团队中的频道来完成消息迁移过程。
调用 completeMigration 的应用程序必须是在目标通道上调用 startMigration 来启动迁移会话的同一应用程序。这是允许在迁移会话期间调用导入消息的同一应用程序。
调用 completeMigration 会删除 Teams 客户端用户可见的导入模式横幅，使频道再次完全可用。

为现有频道或新频道发出 completeMigration 请求后，仍可以通过调用 channel：startMigration 将更多消息导入团队。

此 API 支持以下通道类型。

实体	子类型	迁移模式支持	注释
频道	Standard、专用、共享	新增和现有	通道必须创建或已处于迁移模式。

此 API 可用于以下国家级云部署。

全局服务	美国政府 L4	美国政府 L5 (DOD)	由世纪互联运营的中国
✅	✅	✅	✅

权限

为此 API 选择标记为最低特权的权限。只有在应用需要它时，才使用更高的特权权限。有关委派权限和应用程序权限的详细信息，请参阅权限类型。要了解有关这些权限的详细信息，请参阅权限参考。

权限类型	最低特权权限	更高特权权限
委派（工作或学校帐户）	不支持。	不支持。
委派（个人 Microsoft 帐户）	不支持。	不支持。
应用程序	Teamwork.Migrate.All	不可用。

HTTP 请求

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

请求标头

标头	值
Authorization	持有者 {token}。必填。详细了解身份验证和授权。

请求正文

请勿提供此方法的请求正文。

响应

如果成功，此方法返回 204 No Content 响应代码。它不会在响应正文中返回任何内容。

示例

示例 1：当通道处于迁移模式时完成迁移

以下示例演示如何在通道处于迁移模式时完成迁移。

请求

以下示例显示了一个请求。

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


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Teams["{team-id}"].Channels["{channel-id}"].CompleteMigration.PostAsync();



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Teams().ByTeamId("team-id").Channels().ByChannelId("channel-id").CompleteMigration().Post(context.Background(), nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

graphClient.teams().byTeamId("{team-id}").channels().byChannelId("{channel-id}").completeMigration().post();


const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/teams/57fb72d0-d811-46f4-8947-305e6072eaa5/channels/19:4b6bed8d24574f6a9e436813cb2617d8@thread.tacv2/completeMigration')
	.post();


<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$graphServiceClient->teams()->byTeamId('team-id')->channels()->byChannelId('channel-id')->completeMigration()->post()->wait();


Import-Module Microsoft.Graph.Teams

Complete-MgTeamChannelMigration -TeamId $teamId -ChannelId $channelId


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

await graph_client.teams.by_team_id('team-id').channels.by_channel_id('channel-id').complete_migration.post()

响应

以下示例显示了相应的响应。

HTTP/1.1 204 No Content

示例 2：当通道不处于迁移模式时完成迁移

以下示例演示如何在通道不处于迁移模式时完成迁移。此请求失败并出现 400 Bad Request 响应。

请求

以下示例显示了一个请求。

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


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Teams["{team-id}"].Channels["{channel-id}"].CompleteMigration.PostAsync();



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Teams().ByTeamId("team-id").Channels().ByChannelId("channel-id").CompleteMigration().Post(context.Background(), nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

graphClient.teams().byTeamId("{team-id}").channels().byChannelId("{channel-id}").completeMigration().post();


const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/teams/57fb72d0-d811-46f4-8947-305e6072eaa5/channels/19:4b6bed8d24574f6a9e436813cb2617d8@thread.tacv2/completeMigration')
	.post();


<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$graphServiceClient->teams()->byTeamId('team-id')->channels()->byChannelId('channel-id')->completeMigration()->post()->wait();


Import-Module Microsoft.Graph.Teams

Complete-MgTeamChannelMigration -TeamId $teamId -ChannelId $channelId


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

await graph_client.teams.by_team_id('team-id').channels.by_channel_id('channel-id').complete_migration.post()

响应

以下示例显示了相应的响应。

HTTP/1.1 400 Bad Request

反馈

此页面是否有帮助？

上次更新时间为 2026-05-22