channel: completeMigration

名前空間: microsoft.graph

既存のチャネルまたは新しい チャネル での移行を完了します。 完全な移行操作は、最初の移行プロセス用に特別に設計された移行テンプレートを使用して、最初に新しく作成された標準チャネルに制限されていました。 詳細については、「 Microsoft Graph を使用してサード パーティのプラットフォーム メッセージを Teams にインポートする」を参照してください。

新規チャネルと既存チャネルの移行を完了する場合は、次の点を考慮してください。

• 初期インポート フローの移行モードでチャネルが作成されると、チーム内のチャネルのプロパティ migrationMode が削除されずにcompletedに更新され、状態はチャットまたはチャネルに永続的にマークされます。 移行モードは、データ移行プロセス中にメッセージの送信やメンバーの追加など、特定の操作を妨げる特殊な状態です。 チームは移行モードに入ることができないので、親チームは移行モードでマークされません。子チャネル (一般、標準、プライベート、共有) のみが可能です。
• 既に移行モードになっている既存のチャネルの場合、API は、migrationMode をチーム内のチャネルのcompletedに更新することで、メッセージ移行プロセスを完了します。

既存のチャネルまたは新しいチャネルに対して 完全なMigration 要求が行われた後も、 チャネル startMigration を呼び出すことで、さらに多くのメッセージをチームにインポートできます。

この API では、次のチャネルの種類がサポートされています。

この API は、次の国内クラウド展開で使用できます。

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

HTTP 要求

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

要求ヘッダー

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは 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

関連コンテンツ

• channel: startMigration
• 古いタイムスタンプを持つメッセージをインポートします。
• チャネル移行の状態を取得します。
• chat: completeMigration
• chat: startMigration