Azure Storage Mover を使用して Google Cloud Storage から Azure Blob Storage にデータを移行する

Azure Storage Mover の S3 (Simple Storage Service) ソース移行機能は、S3 互換の Google Cloud Storage (GCS) オブジェクトストアからAzure Blob Storageにデータを安全に転送します。

Azure Arcマルチクラウドコネクタを使用する AWS S3 (Amazon Simple Storage Services) の移行とは異なり、S3 互換のソース移行では簡略化されたアプローチが使用されます。ソースエンドポイント URL と HMAC (ハッシュベースのメッセージ認証コード) 資格情報をAzure Key Vaultに安全に格納する場合、マルチクラウドコネクタや自動ソース検出は必要ありません。

この記事では、GCS S3 互換ソースから Azure Blob Storage にデータを移行するように Storage Mover を構成する完全なプロセスについて説明します。このプロセスは、Azure Key Vaultへのソース資格情報の格納、ソースエンドポイントとターゲットエンドポイントの構成、移行ジョブの作成と実行で構成されます。

前提条件

開始する前に、次の要件が満たされていることを確認します。

Azure Storage Mover リソースを作成および管理するアクセス許可がある、アクティブな Azure サブスクリプション。
移行元の GCS バケットにアクセスできる Google Cloud アカウント。
宛先として使用するAzure Storage アカウント。
Azure サブスクリプションにデプロイされた Storage Mover リソース。
ソース HMAC 資格情報を安全に格納するためのAzure Key Vault。
GCS バケット用に生成された HMAC キー。 GCS の HMAC キーの生成を参照してください。
ソースデータにプライベートネットワーク経由でのみアクセスできる場合は、Azureでのプライベート接続のセットアップ。

Limits

Azure Storage Mover の S3 互換 GCS ソース移行機能には、次の制限があります。

各移行ジョブでは、5 億個のオブジェクトの転送がサポートされています。
サブスクリプションごとに最大 10 個の同時実行ジョブがサポートされます。 10 を超える実行が必要な場合は、サポート要求を作成します。
S3 互換ソースへの HTTPS アクセスのみがサポートされています。
S3 互換ソースは、AWS Signature Version 4 (SigV4) スタイルの認証をサポートしている必要があります。

知っておくべきこと

移行を開始する前に、GCS S3 と互換性のあるソース移行に固有の次の考慮事項を確認してください。

認証方法

GCS S3 互換アクセスでは、GCS サービスアカウントまたはユーザーアカウントに関連付けられている HMAC キー (アクセスキー ID とシークレットキー) が使用されます。これらのキーを使用すると、GCS は AWS Signature Version 4 認証プロセスを使用して標準の S3 API 要求に応答できます。

GCS の HMAC キーを生成する

S3 互換インターフェイスを使用して GCS バケットにアクセスするには、Google Cloud コンソールで HMAC キーを生成する必要があります。

Google Cloud コンソールに移動します。
Cloud Storage>Settings>Interoperability タブに移動します。
まだ行っていない場合は、[ 相互運用性アクセス用に既定のプロジェクトを設定する] を選択します。
[ サービスアカウントのアクセスキー ] セクションで、使用するサービスアカウントを選択し、[ キーの作成] を選択します。
アクセスキーとシークレットキーの値をメモします。これらの値は、次の手順で必要になります。

Important

これらのキーを安全に格納します。シークレットキーは 1 回だけ表示されます。キーは初期作成時にのみ表示され、後で取得することはできません。
ジョブの完了と最適なセキュリティを確保するために、HMAC 資格情報の有効期間が 1 週間以上であることを確認します。

ソース資格情報をAzure Key Vaultに格納する

GCS バケットの HMAC キーを生成した後、Storage Mover サービスによる安全なアクセスのために、シークレットとしてAzure Key Vaultに格納します。

Azure Portal
Azure CLI

Azure ポータルを使用して、Storage Mover リソースと同じサブスクリプション内にあるAzure Key Vaultに移動します。
左側のナビゲーションで、[ オブジェクト] メニューを展開し、[シークレット] を選択 します。次に、[ 生成/インポート] を選択します。
アクセスキーのシークレットを作成します。
- 名前: わかりやすい名前を指定します (例: gcs-access-key)。
- シークレット値: 前のセクションの HMAC アクセスキーの値を貼り付けます。
- を選択してを作成します。
秘密鍵の 2 つ目の シークレットを作成します。
- 名前: わかりやすい名前を指定します (例: gcs-secret-key)。
- シークレット値: 前のセクションの HMAC 秘密鍵の値を貼り付けます。
- を選択してを作成します。
各シークレットの完全な シークレット識別子 URI をメモします。ソースエンドポイントを作成するときは、これらの識別子が必要です。

GCS HMACアクセスキーとシークレットキーを保存するために az keyvault secret set を使用します:

az keyvault secret set --vault-name "my-gcs-key-vault" --name "gcs-access-key" --value "<gcs-hmac-access-key>" --query id --output tsv

az keyvault secret set --vault-name "my-gcs-key-vault" --name "gcs-secret-key" --value "<gcs-hmac-secret-key>" --query id --output tsv

各コマンドは、ソースエンドポイントを作成する際に使われるバージョン管理された秘密識別子を返します。

Note

最適なセキュリティを確保するために、HMAC シークレットを含むKey Vaultのパブリックアクセスを無効にし、信頼されたサービスとして Storage Mover を追加することをお勧めします。

詳細については、「Azure portalを使用してKey Vaultからシークレットを設定して取得する」を参照してください。

ソースエンドポイントとターゲットエンドポイントを構成する

Azure Key Vault内に HMAC 資格情報を格納したら、次の手順として、移行のソースエンドポイントとターゲットエンドポイントを作成します。

Azure Storage Mover サービスのコンテキストでは、エンドポイントは、ソースまたはターゲットの場所とその他の関連情報へのパスを含むリソースです。 Storage Mover ジョブ定義では、エンドポイントを使用してコピー操作のソースとターゲットの場所を定義します。

GCS S3 と互換性のあるソースエンドポイントを構成する

ソースエンドポイントは、データの移行元の場所を識別します。ソースエンドポイントは、移行プロジェクト内で指定されたデータの配信元を定義するために使用されます。

次の手順では、ソースエンドポイントを作成するプロセスについて説明します。

Azure Portal
Azure CLI

Azure portal内の Storage Mover インスタンスに移動します。
左側のナビゲーション内の [リソース管理 ] グループで、[ ストレージエンドポイント] を選択します。 [ ソースエンドポイント ] タブを選択し、[ エンドポイントの作成 ] を選択して [ ソースエンドポイントの作成 ] ウィンドウを開きます。
[ソースエンドポイントの作成] ウィンドウで、次の 操作を行 います。
- [移行の種類] として [マルチクラウド移行] を選択します。
- ソースの種類として GCS オブジェクトストレージ - S3 を選択します。
- ソース URL: GCS バケットへの完全な HTTPS URL を S3 互換形式で入力します。オブジェクトのサブセットのみを移行するには、 https://storage.googleapis.com/<bucket-name>/ または https://storage.googleapis.com/<bucket-name>/<prefix>/ の形式を使用します。
- Access Key Vault シークレット URI: HMAC アクセスキーを含むシークレットの完全な URI を入力します
- シークレット Key Vault シークレット URI: HMAC シークレットキーを含むシークレットの完全な URI を入力します
- 必要に応じて、エンドポイントの説明を指定します。
選択内容が正しいことを確認し、[ 作成 ] を選択してエンドポイントを作成します。

Note

ソースエンドポイントが作成されると、システム割り当てマネージド ID が自動的にプロビジョニングされます。この ID では、移行中に HMAC 資格情報を取得するために、Azure Key Vaultに対する Key Vault Secrets User Role-Based Access Control (RBAC) ロールアクセスが必要です。ポータルは、このロールを自動的に割り当てようとします。アクセス許可が不十分なため割り当てが失敗した場合は、手動で割り当てるか、Azure管理者に連絡してロールを手動で付与してください。

az storage-mover endpoint create-for-s3-with-hmacを使ってGCSのソースエンドポイントを作成します:

az storage-mover endpoint create-for-s3-with-hmac --resource-group "c2c-migration-rg" --storage-mover-name "myStorageMover" --endpoint-name "my-gcs-endpoint" --source-uri "https://storage.googleapis.com/my-gcs-bucket/" --source-type GCS --access-key-uri "https://my-gcs-key-vault.vault.azure.net/secrets/gcs-access-key/<secret-version>" --secret-key-uri "https://my-gcs-key-vault.vault.azure.net/secrets/gcs-secret-key/<secret-version>" --endpoint-kind Source --description "GCS source endpoint"

このコマンドは、システムが自動的にソースエンドポイントに管理IDを割り当てます。

バケットからプレフィックスのみを移行するには、 https://storage.googleapis.com/my-gcs-bucket/my-prefix/ をソースURIとして使用してください。

左側のナビゲーション内の [リソース管理 ] グループで、[ ストレージエンドポイント] を選択します。 [ ターゲットエンドポイント ] タブを選択し、[ エンドポイントの追加 ] を選択して [ ターゲットエンドポイントの作成 ] ウィンドウを開きます。
[ターゲットエンドポイントの作成] ウィンドウで、次の 操作を行 います。
- それぞれのドロップダウンリストから サブスクリプション と ストレージアカウント を選択します。
- [ターゲットの種類] フィールドから BLOB コンテナーを選択します。
- ドロップダウンリストから、移行先の BLOB コンテナー を選択します。
- 必要に応じて、エンドポイントの説明を指定します。
選択内容が正しいことを確認し、[ 作成 ] を選択してエンドポイントを作成します。

az storage-mover endpoint create-for-storage-containerを使ってターゲットエンドポイントを作成してください:

az storage-mover endpoint create-for-storage-container --resource-group "c2c-migration-rg" --storage-mover-name "myStorageMover" --endpoint-name "my-blob-endpoint" --container-name "migration-container" --storage-account-id "/subscriptions/<subscription-id>/resourceGroups/c2c-migration-rg/providers/Microsoft.Storage/storageAccounts/mystorageaccount" --endpoint-kind Target --description "Azure Blob Storage target endpoint"

RBAC ロールを割り当てる

Azure Portal
Azure CLI

Azure ポータルを使用してエンドポイントを作成すると、必要な RBAC ロールがシステム割り当てマネージド ID に自動的に割り当てられます。

エンドポイント	役割	ターゲットリソース
ソースエンドポイント	Key Vault 秘密ユーザー	お客様の Azure Key Vault
ターゲットエンドポイント	Storage Blob データ共同作成者	お使いの Azure Blob コンテナー

自動割り当てが失敗した場合 (アクセス許可が不十分な場合など)、これらのロールを手動で割り当てるか、Azure管理者に問い合わせる必要があります。

ソースエンドポイント作成コマンドは自動的にシステム割り当ての管理IDを割り当てます。プリンシパル ID の取得:

az storage-mover endpoint identity show --resource-group "c2c-migration-rg" --storage-mover-name "myStorageMover" --endpoint-name "my-gcs-endpoint" --query principalId --output tsv

Key Vault SecretsのユーザーロールをKey Vaultに割り当てる:

az role assignment create --assignee-object-id "<source-endpoint-principal-id>" --assignee-principal-type ServicePrincipal --role "Key Vault Secrets User" --scope "/subscriptions/<subscription-id>/resourceGroups/c2c-migration-rg/providers/Microsoft.KeyVault/vaults/my-gcs-key-vault"

ターゲットエンドポイントの管理型アイデンティティを取得する:

az storage-mover endpoint show --resource-group "c2c-migration-rg" --storage-mover-name "myStorageMover" --name "my-blob-endpoint" --query identity.principalId --output tsv

ターゲットコンテナに Storage Blob Data Contributor の役割を割り当てます:

az role assignment create --assignee-object-id "<target-endpoint-principal-id>" --assignee-principal-type ServicePrincipal --role "Storage Blob Data Contributor" --scope "/subscriptions/<subscription-id>/resourceGroups/c2c-migration-rg/providers/Microsoft.Storage/storageAccounts/mystorageaccount/blobServices/default/containers/migration-container"

移行プロジェクトとジョブ定義を作成する

移行のソースエンドポイントとターゲットエンドポイントを定義した後、次の手順は Storage Mover 移行プロジェクトとジョブ定義を作成することです。

移行プロジェクトを使用すると、大規模な移行をより小さく管理しやすい単位に整理できます。ジョブ定義は、特定のコピー操作セットのリソースと移行オプションを記述します。これらのリソースには、たとえば、ソースエンドポイントとターゲットエンドポイント、適用する移行設定が含まれます。

このセクションの手順に従って、移行プロジェクトを作成し、移行ジョブを実行します。

プロジェクトの作成

Azure Portal
Azure CLI

Storage Mover インスタンスの [移行の計画と実行] の下にある [プロジェクト] セクションに移動し、[プロジェクト] タブで [プロジェクトの作成] を選択します。
次のフィールドの値を指定します。
- 名前: 移行プロジェクトのわかりやすい名前。
- プロジェクトの説明: プロジェクトの便利な説明。
[作成] を選択してプロジェクトを作成します。

az storage-mover project createを使って移行プロジェクトを作成する:

az storage-mover project create --resource-group "c2c-migration-rg" --storage-mover-name "myStorageMover" --name "my-migration-project" --description "GCS to Azure migration"

ジョブ定義を作成する

Azure Portal
Azure CLI

表示されたプロジェクトを選択し、[ ジョブの作成] を選択します。ジョブ作成ウィザードには、[基本]、[スケジュール]、[設定]、[確認] の 4 つのタブがあります。

[基本] タブ

次のフィールドの値を指定します。

フィールド	価値
移行の種類	[マルチクラウド移行] を選択する
ソースの種類	GCS オブジェクトストレージの選択 - S3 (プレビュー)
S3 バケットの種類	[パブリック] または [プライベート] を選択する (プレビュー)
名前	ジョブに付けるわかりやすい名前
Description	(省略可能)ジョブの説明 (最大 1,024 文字)

[ ソース ] セクションで、次の手順を実行します。
- [ソースエンドポイント]: [ ソースエンドポイントの追加] を選択して新しいエンドポイントを作成するか、既存の GCS S3 互換のソースエンドポイントを選択します。
- ソースサブパス: (省略可能) バケットの一部のみを移行するサブフォルダーパスを指定します。空欄のままにすると、ジョブはバケットのルートから開始されます。
- 表示されている 完全なパス が正しいことを確認します。
[ターゲット] セクションで、次の手順を実行します。
- ターゲットエンドポイント: [ターゲットエンドポイントの追加] を選択して新しいエンドポイントを作成するか、既存のAzure Blob Storageターゲットエンドポイントを選択します。
- ターゲットサブパス: (省略可能) ターゲットサブフォルダーを指定します。空のままにすると、すべてのコンテンツがコンテナールートに移行されます。一意のサブパスによって新しいサブフォルダーが作成されます。
S3 バケットの種類に [ プライベート ] を選択した場合は、[ プライベート接続 ] セクションが表示されます。
- 承認されたプライベート接続をこのジョブに関連付けるには、[ 追加] を 選択します。
- 承認済み状態の接続のみを追加できます。
- 負荷分散のために複数のプライベート接続を関連付けることができます。
Note

プライベートバケットにはプライベート接続が必要です。プライベートバケットの種類でジョブを開始するには、少なくとも 1 つの承認済みプライベート接続が必要です。セットアップ手順については、 GCS のプライベートネットワーク接続を参照してください。
[次へ] を選択して続行します。

スケジュールタブ

移行を実行するタイミングを選択します。

オプション	説明
スケジュールなし	移行を手動で開始する
1 回限りスケジュール	特定の時刻に 1 回移行を実行する
定期的なスケジュール	毎日、毎週、または毎月のスケジュールで移行を実行する

Important

現在、スケジュール設定は GCS オブジェクトストレージ - S3 ソースの種類では使用できません。ジョブは手動でのみ実行できます。 [スケジュールなし] を選択し、[次へ] を選択して続行します。

設定タブ

ドロップダウンリストから目的の コピーモード を選択します。

コピーモード	Behavior
ターゲットにコンテンツをマージ	ファイルは、ソースに存在しない場合でも、ターゲットに保持されます。名前とパスが一致するファイルは、ソースと一致するように更新されます。コピー間でフォルダー名を変更すると、ターゲット内のコンテンツが重複する可能性があります。
ソースをターゲットにミラーリング	ターゲットをソースの正確なレプリカにします。ソースから削除されたオブジェクトもターゲットから削除されます。

データがどのようにマップされているかを理解するには、「 移行の結果 」セクションを確認します。

結果	説明
ディレクトリ構造	ターゲットでは、"仮想" フォルダーがサポートされています。ファイル名の前にソースパスが付加され、フラットなリストに配置されます。空のフォルダーは空の BLOB として表され、フォルダーメタデータはカスタムメタデータに保持されます。
タイムスタンプを作成する	カスタム BLOB メタデータとして保持されます。 BLOB ネイティブタイムスタンプには、ファイルが移行された時刻が反映されます。
タイムスタンプの変更	カスタム BLOB メタデータとして保持されます。この種類の BLOB ネイティブタイムスタンプは存在しません。
変更されたタイムスタンプ	カスタム BLOB メタデータとして保持されます。 BLOB ネイティブタイムスタンプには、ファイルが移行された時刻が反映されます。
最後にアクセスされたタイムスタンプ	ソースに存在する場合は、カスタム BLOB メタデータとして保持されます。この種類の BLOB ネイティブタイムスタンプはありません。
その他のメタデータ	ターゲット BLOB のカスタムメタデータに保持されます。格納できるメタデータは 4 KiB のみです。 4 KiB を超えるメタデータは移行されません。
クラウド移行プロトコル	Blob REST API

[次へ] を選択して続行します。

校閲タブ

構成の概要を確認します。

基本: ジョブ名、移行の種類
ソース: ソースの種類、バケット名を含むソース URL、クラウド名 (GCS)、ソースサブパス
ターゲット: ストレージアカウント、Azure BLOB コンテナー、ターゲットサブパス
スケジュール: 移行の頻度
設定: コピーモード

すべての設定が正しい場合は、[ 作成 ] を選択してジョブをデプロイします。 [ 前へ ] を選択して変更を加えます。

az storage-mover job-definition createを使ってクラウド間のジョブ定義を作成しましょう:

az storage-mover job-definition create --resource-group "c2c-migration-rg" --storage-mover-name "myStorageMover" --project-name "my-migration-project" --job-definition-name "my-job-definition" --job-type CloudToCloud --copy-mode Additive --source-name "my-gcs-endpoint" --target-name "my-blob-endpoint" --source-subpath "/" --target-subpath "/" --description "GCS to Azure Blob Storage"

プライベートGCSソースの場合は、コマンドに --connections "/subscriptions/<subscription-id>/resourceGroups/c2c-migration-rg/providers/Microsoft.StorageMover/storageMovers/myStorageMover/connections/private-connection" を追加します。

移行ジョブを実行する

ジョブを開始する

Azure Portal
Azure CLI

[ プロジェクト ] タブに移動します。新しく作成したジョブが、プロジェクトの下の一覧に表示されます。
ジョブ定義を選択すると、[ プロパティ ] タブにその詳細が表示されます。
[ジョブの開始] ボタンを選択します。
[ ジョブの開始 ] ウィンドウで、ジョブの詳細を確認し、[ 開始 ] を選択して移行を開始します。

ジョブはバックグラウンドで実行されます。その進行状況は、[ 移行の概要 ] タブで監視できます。

az storage-mover job-definition start-jobを使って移行を開始してください:

az storage-mover job-definition start-job --resource-group "c2c-migration-rg" --storage-mover-name "myStorageMover" --project-name "my-migration-project" --job-definition-name "my-job-definition"

コマンド出力にはジョブランリソースIDとジョブラン名が含まれます。

移行の進行状況を監視する

Storage Mover を使用してデータを移行するときは、コピー操作で潜在的な問題を監視する必要があります。移行中に実行される操作に関連するデータは、[移行の概要 ] タブに表示されます。このデータを使用すると、現在の状態と、進行状況、速度、推定完了時間などの重要な情報を提供することで、移行の進行状況を追跡できます。

構成すると、Azure Storage Mover はコピーログとジョブ実行ログも提供します。これらのログを使用すると、ジョブの実行と個々のファイルの移行結果をトレースできます。

Azure Portal
Azure CLI

[ 移行ジョブ ] タブに移動します。
ジョブを選択して、進行状況、速度、推定完了時間を表示します。
[ ログ] を選択して、エラーまたは警告を確認します。
移行が完了したら、Azure Blob Storageのデータを確認します。

az storage-mover job-run show を使用して、ジョブの実行を確認します。

az storage-mover job-run show --resource-group "c2c-migration-rg" --storage-mover-name "myStorageMover" --project-name "my-migration-project" --job-definition-name "my-job-definition" --name "<job-run-name>" --query "{name:name,status:status}" --output table

ジョブ定義の az storage-mover job-run list を使ってすべての実行をリストアップしてください。

az storage-mover job-run list --resource-group "c2c-migration-rg" --storage-mover-name "myStorageMover" --project-name "my-migration-project" --job-definition-name "my-job-definition" --output table

Storage Mover コピーとジョブログの詳細については、 Azure Storage Mover のコピーとジョブログを有効にする方法に関する記事を参照してください。

移行後の検証

移行後のデータ検証により、データが正確であることと、GCS から Azure Blob Storage への転送が完了することが保証されます。この検証プロセスでは、移行されたデータをソースの同じデータと比較して、データの整合性を検証します。

手動検証を完了し、未使用の GCS リソースをクリーンアップするには、次の手順に従います。

ソースとターゲットの比較: GCS バケットとAzure BLOB コンテナーの間でオブジェクト数と合計データサイズを比較して、予期されるすべてのオブジェクトが転送されることを確認します。
スポットチェックデータの整合性: ソースとターゲットの両方からオブジェクトの代表的なサンプルをダウンロードし、チェックサムを比較します。
増分同期を有効にする（必要に応じて）: GCS バケットと Azure Blob コンテナーの同期を一定期間にわたって維持する必要がある場合は、ジョブが定期的に実行されるようにスケジュールします。
ソースの使用停止: 移行が完全に完了して検証された後、GCS バケットと HMAC キーを削除します。不要になったら、対応するシークレットをAzure Key Vaultから削除します。

トラブルシューティングとサポート

移行中に問題が発生した場合は、次の手順を実行してトラブルシューティングを開始します。

問題点	Resolution
移行ジョブが失敗しました	詳細なエラーメッセージについては、コピーログとジョブログを確認してください。一般的な原因には、無効な資格情報やネットワーク接続の問題が含まれます。
認証エラー	Azure Key Vaultに格納されている HMAC アクセスキーと秘密鍵が正しく、有効期限が切れていないことを確認します。ソースエンドポイントのマネージド ID に、ご利用の Key Vault への Key Vault Secrets User アクセス権が付与されていることを確認します。
ターゲットのアクセス許可エラー	ターゲットエンドポイントのマネージド ID に、ターゲット Blob コンテナーに対する Storage Blob Data Contributor ロールが割り当てられていることを確認します。
データ転送が遅い	ネットワーク帯域幅が十分であることを確認します。 GCS では、S3 と互換性のある API 要求に対するレート制限が実装される場合があります。スロットリングが発生した場合は、同時実行ジョブ数を減らすことを検討してください。
同期後にオブジェクトが見つからない	GCS タイムスタンプの第 2 レベルの粒度により、前回の同期と同じ秒内に変更されたオブジェクトは、次のジョブが実行されるまで検出されない可能性があります。待機してから、追加同期を実行します。
ターゲット内の予期しないオブジェクト	GCS ディレクトリプレースホルダーオブジェクト ( `/` で終わる 0 バイトオブジェクト) は自動的にスキップされ、ターゲットには表示されません。予期しないオブジェクトが存在する場合は、コピーログで詳細を確認してください。
ソース URL が拒否されました	ソース URL で HTTPS が使用され、クエリパラメーター、フラグメント、または IP アドレスが含まれていないことを確認し、有効な完全修飾ドメイン名を指していることを確認します。

問題を解決できない場合は、Azure サポート要求を作成します。

次の記事は、Storage Mover サービスについて理解を深めるのに役立ちます。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-08-16