SharePoint Migration API の概要

SharePoint Migration API は、コンテンツを大規模に SharePoint にインポートします。 コンテンツとマニフェスト パッケージをキュー内のジョブとして処理します。 API では、プロセスの状態とログが提供されるため、各移行ジョブの進行状況を簡単に監視できます。

Migration API を使用して、ファイル共有、SharePoint Server、およびその他のクラウドベースのサービスからコンテンツを移行します。

新機能

2024 年 7 月

SAS トークンに spr=https フィールドを追加することで、SharePoint が提供する Azure Blob Storage コンテナーへの HTTPS 接続の適用を開始しました。 この適用は、2024 年 7 月 21 日に完全に有効です。 詳細については、「 SharePoint Migration API で Azure Blob Storage コンテナーと Azure キューを使用 する」を参照してください。

2024 年 4 月

JobEnd イベントに新しいフィールドを追加し、ファイルに対してインポートされた数とバイト数を示しました。 詳細については、「 Azure Queue の移行イベント 」を参照してください。

2024 年 1 月

明確で正しいエラーが発生するように、このドキュメントを再フォーマットしました。

移行手順の概要

3 つの手順で移行ジョブを開始します。 このセクションの各手順のガイダンスを確認します。

宛先コンテナーとキューをプロビジョニングする

ProvisionMigrationContainersメソッドを使用してコンテナーをプロビジョニングします。 詳細については、「 移行 API で Azure Blob Storage コンテナーと Azure キューを使用 する」を参照してください。 必要に応じて、独自のコンテナーとキューを使用することもできます。

コンテンツを準備する

定義された形式でコンテンツをパッケージ化し、コンテンツ パッケージとして Azure Blob Storage コンテナーにアップロードします。

[コンテンツ パッケージ] をオンにして、詳細な要件を確認します。

マニフェスト ファイルを作成する

内容に基づいて、XML 形式のマニフェスト ファイルを作成し、マニフェスト パッケージとして Azure Blob Storage コンテナーにアップロードします。

マニフェスト ファイルを確認して、詳細な要件を確認します。

移行 API を使用して移行を開始し、状態を取得する

CreateMigrationJob メソッドは、処理のためにキューに入れる移行ジョブを作成します。 移行 API はキューを管理し、状態とログを返します。 CreateMigrationEncryptedメソッドを使用して、暗号化されたコンテンツを移行します。 詳細については、「 SharePoint Migration API リファレンス」 を参照してください。

新しい移行ジョブを作成すると、Migration API はジョブ ID を返します。 必要に応じて、 GetMigrationJobStatus メソッドを使用して、Azure Queue が指定された状態でインポートの状態を追跡します。

移行 API は、マニフェスト コンテナーにログを生成します。 移行結果のログ エントリを確認します。

ベスト プラクティス

アプリ ベース認証を使用する

移行では、エンド ユーザーが生成したトラフィックとは異なる方法で SharePoint バックエンドへのワークロードが生成されます。 エラスティック機能を使用してリソースを適切に割り当てるには、移行ソリューションでアプリベースの認証のみを使用します。

移行ソリューションではユーザー モードを使用しないでください。 ユーザー モードで移行を実行すると、調整が増加し、パフォーマンスが低下します。

アプリ ID を登録する方法とアプリ ベースの認証を実装する方法の詳細については、アプリ ID と Microsoft Graph 認証ガイダンスを登録する方法に関するページを参照してください。

Microsoft Entra ID のアクセス許可

Microsoft Entra ID には、委任されたアクセス許可とアプリケーションのアクセス許可の 2 種類のアクセス許可が用意されています。 詳細については、 Azure Active Directory v1.0 エンドポイントの [アクセス許可と同意] を確認してください。

SharePoint と OneDrive の移行シナリオの場合は、Microsoft Entra ID のアクセス許可の仕様に従ってください。

サインインしているエンド ユーザーとプレゼンスに依存する移行ツールの場合は、委任されたアクセス許可を使用します。

バックグラウンド サービスとして実行されるアプリケーションなど、サインインしているユーザーが存在せずに実行されるサービス ベースの移行ツールの場合は、アプリケーションのアクセス許可を使用します。

アプリ ID

1 つのアプリ ID を共有して、作成された複数の移行ソリューションをカバーすることも、各製品の個別のアプリ ID を作成することもできます。 アプリ ID を登録してください。 アプリ ID の共有は、パフォーマンスや調整には影響しません。

移行先の SharePoint サイトのアクティブ化を解除する

移行の問題を回避するには、移行が完了するまでユーザーのターゲット サイトを非アクティブ化します。 ソースはアクティブなままで、読み取りと書き込みを許可して生産性を維持できます。 移行完了後にユーザーを新しい SharePoint 移行先サイトに切り替えます。

パフォーマンス

移行 API は、事前構成済みのワークロード管理設定を使用してキュー メカニズムを介してジョブを処理します。 移行 API は、サービス レベル アグリーメント (SLA) または保証されたパフォーマンスなしで、ベスト エフォートベースでジョブを処理します。

移行のパフォーマンスを最適化する

移行プロジェクトに最適なパフォーマンスを確保するには、特に大規模な移行を処理する場合は慎重に計画することが重要です。 期間を見積もり、パフォーマンスを最適化する方法の詳細については、 パフォーマンス ガイドを参照してください。

調整メッセージが表示される

すべての Microsoft 365 ユーザーに優れたユーザー エクスペリエンスを確保するために、SharePoint では調整を使用して SharePoint インフラストラクチャを保護します。 調整ガイダンスに従って調整 されないようにします。

特別記事

ファイルとフォルダーの共有イベントの移行

ファイルとフォルダーを使用して共有 イベント メタデータを移行する手順については、イベントの共有に関する記事を参照してください。

Web パーツ

SharePoint 移行ツール (SPMT) の Web パーツ シリアライザー DLL を使用して、Web パーツを SharePoint に移行します。 手順については、「 Web パーツの移行 」を参照してください。