如何判断Microsoft Teams团队是否仍处于导入模式？

问题场景 #

我通过Microsoft Graph导入API创建了一个迁移模式的Teams团队，创建代码如下：

Team newTeam = new Team()
{
   DisplayName = "TestMigration1",
   Description= "TestMigration with Import Api",
   AdditionalData = new Dictionary<string, object>()
   {
        { "template@odata.bind", "https://graph.microsoft.com/v1.0/teamsTemplates('standard')" },
        { "@microsoft.graph.teamCreationMode", "migration" }
   },
   CreatedDateTime = new DateTime(2020, 01, 01)             
};

创建完成后重新读取该团队对象时，发现AdditionalData中并未包含@microsoft.graph.teamCreationMode字段，但我尚未发送CompleteMigration请求，确定团队仍处于迁移模式。请问该如何判断该团队是否还处于导入模式？

解决方案 #

要判断Teams团队是否仍处于迁移导入模式，不能依赖读取团队对象时的字段，而是需要调用专门的迁移状态查询API：

1. 调用迁移状态端点 #

通过Graph API的/teams/{team-id}/migration/state端点获取团队的迁移状态，返回值会明确指示当前迁移进度：

• 返回inProgress：团队仍处于迁移模式，未完成导入操作
• 返回completed：团队已退出迁移模式（已调用CompleteMigration）

2. C#代码示例 #

使用Microsoft Graph SDK调用该端点的示例代码：

// 初始化GraphServiceClient（需已完成身份验证）
var graphClient = new GraphServiceClient(authProvider);

// 替换为目标团队的ID
string teamId = "your-team-id-here";

// 获取迁移状态
var migrationState = await graphClient.Teams[teamId].Migration.State.GetAsync();

// 判断状态
if (migrationState.Value == "inProgress")
{
    // 团队仍处于迁移模式
}
else if (migrationState.Value == "completed")
{
    // 团队已退出迁移模式
}

补充说明 #

• 创建团队时设置的@microsoft.graph.teamCreationMode仅用于创建环节，读取团队信息时不会返回该字段，因此无法通过此字段判断当前模式。
• 只有调用CompleteMigration接口后，团队的迁移状态才会变为completed，同时退出迁移模式，此时无法再向团队导入历史消息。

内容的提问来源于stack exchange，提问作者CloudAnywhere