このページでは、クロスバケット レプリケーションを使用する方法について説明します。この方法では、Storage Transfer Service を使用して、新しいオブジェクトと更新されたオブジェクトをソースバケットから宛先バケットに非同期でコピーします。クロスバケット レプリケーションを使用する場合は、Storage Transfer Service のジョブの一種であるレプリケーション ジョブを作成して管理します。
始める前に
クロスバケット レプリケーションを使用するには、前提条件の手順を完了する必要があります。手順については、Storage Transfer Service のドキュメントの始める前にをご覧ください。
レプリケーション ジョブを作成する
Console
Google Cloud コンソールを使用してクロスバケット レプリケーション ジョブを作成すると、Storage Transfer Service サービス エージェントにソースバケットに対する storage.legacyBucketOwner ロールと宛先バケットに対する storage.legacyBucketWriter ロールが自動的に付与されます。
Google Cloud コンソールを使用する場合は、既存のバケットに対して、または新しいバケットの作成する際に、レプリケーション ジョブを作成できます。
新しいバケットのレプリケーション ジョブを作成するには、新しいバケットを作成するの手順に沿って操作します。
既存のバケットのレプリケーション ジョブを作成するには、次の操作を行います。
- Google Cloud コンソールで、Cloud Storage の [バケット] ページに移動します。
バケットのリストで、複製するオブジェクトのソースバケットの名前をクリックします。
[バケットの詳細] ページで、[構成] タブをクリックします。
[クロスバケット レプリケーション] のオプションを見つけて、 [編集] をクリックします。
表示された [クロスバケット レプリケーションの編集] ペインで、[宛先を追加] をクリックします。
[宛先の選択] セクションで宛先バケットを選択し、[次へ] をクリックします。
[レプリケーション設定を選択] セクションで、次の操作を行います。
省略可: 複製するオブジェクトをオブジェクト名の接頭辞でフィルタするには、[複製するオブジェクトを選択する] セクションで [接頭辞に基づいてオブジェクトを複製する] チェックボックスをオンにします。
接頭辞でオブジェクトを含めるには、[接頭辞を持つオブジェクトを含める] セクションに接頭辞を入力し、[ 接頭辞を追加] をクリックします。
接頭辞でオブジェクトを除外するには、[接頭辞を持つオブジェクトを除外する] セクションに接頭辞を入力し、[ 接頭辞を追加] をクリックします。
省略可: 複製されたオブジェクトのストレージ クラスを設定するには、[複製されたオブジェクトのストレージ クラスを設定する] セクションのメニューからストレージ クラスを選択します。
この手順をスキップすると、複製されたオブジェクトはデフォルトで宛先バケットのストレージ クラスを使用します。
- [保存] をクリックします。
コマンドライン
レプリケーション ジョブを作成する Google Cloud CLI の手順については、Google Cloud CLI を使用してレプリケーション ジョブを作成するをご覧ください。
REST API
JSON API
レプリケーション ジョブを作成する JSON API の手順については、JSON API を使用してレプリケーション ジョブを作成するをご覧ください。
レプリケーション ジョブのステータスを確認するには、Storage Transfer Service ログの Cloud Logging を表示します。
レプリケーション ジョブを一覧表示する
コンソール
Google Cloud コンソールを使用してレプリケーション ジョブを一覧表示することはできません。一度に 1 つのレプリケーション ジョブを表示する手順については、レプリケーション ジョブを表示するをご覧ください。
コマンドライン
レプリケーション ジョブを一覧表示する Google Cloud CLI の手順については、Google Cloud CLI を使用してレプリケーション ジョブを一覧表示するをご覧ください。
REST API
JSON API
レプリケーション ジョブを一覧表示する JSON API の手順については、JSON API を使用してレプリケーション ジョブを一覧表示するをご覧ください。
レプリケーション ジョブを表示する
コンソール
- Google Cloud コンソールで、Cloud Storage の [バケット] ページに移動します。
バケットのリストで、表示するクロスバケット レプリケーション ジョブのソースバケットの名前をクリックします。
[バケットの詳細] ページで、[構成] タブをクリックします。
[クロスバケット レプリケーション] のオプションを見つけて、 [編集] をクリックします。
[クロスバケット レプリケーションの編集] ペインが表示され、宛先バケットごとのレプリケーション ジョブが表示されます。
[バケット] ページの [レプリケーション] 列には、バケットでターボ レプリケーション ジョブとクロスバケット レプリケーション ジョブのどちらが実行されているかが示されます。[レプリケーション] 列を表示する手順については、列を表示するをご覧ください。
コマンドライン
レプリケーション ジョブを表示する Google Cloud CLI の手順については、Google Cloud CLI を使用してレプリケーション ジョブを表示するをご覧ください。
REST API
JSON API
レプリケーション ジョブを表示する方法については、JSON API を使用してレプリケーション ジョブを表示するをご覧ください。
レプリケーション ジョブを更新する
レプリケーション ジョブの次のフィールドを更新できます。
レプリケーション ジョブの説明
レプリケーション ジョブ実行の構成
Pub/Sub に公開される通知の構成
レプリケーション ジョブ オペレーションのロギング動作
レプリケーション ジョブのステータス（有効、無効、削除済み）
コンソール
Google Cloud コンソールを使用する場合、レプリケーション ジョブを更新できるのは、ジョブを一時停止または一時停止解除した場合のみです。
- Google Cloud コンソールで、Cloud Storage の [バケット] ページに移動します。
バケットのリストで、レプリケーションを一時停止または一時停止解除するソースバケットの名前をクリックします。
[バケットの詳細] ページで、[構成] タブをクリックします。
[クロスバケット レプリケーション] のオプションを見つけて、 [編集] をクリックします。
表示された [クロスバケット レプリケーションの編集] ペインで、更新するレプリケーション ジョブの横にある [一時停止] または [一時停止を解除] をクリックします。
コマンドライン
レプリケーション ジョブを更新する Google Cloud CLI の手順については、Google Cloud CLI を使用してレプリケーション ジョブを更新するをご覧ください。
REST API
JSON API
レプリケーション ジョブを更新する方法に関する JSON API の手順については、JSON API を使用してレプリケーション ジョブを更新するをご覧ください。
レプリケーション ジョブを削除する
コンソール
- Google Cloud コンソールで、Cloud Storage の [バケット] ページに移動します。
バケットのリストで、レプリケーションを停止するソースバケットの名前をクリックします。
[バケットの詳細] ページで、[構成] タブをクリックします。
[クロスバケット レプリケーション] のオプションを見つけて、 [編集] をクリックします。
表示された [クロスバケット レプリケーションの編集] ペインで、削除するレプリケーション ジョブの横にある [削除] をクリックします。
表示されるダイアログで [確認] をクリックします。
コマンドライン
レプリケーション ジョブを削除する Google Cloud CLI の手順については、Google Cloud CLI を使用してレプリケーション ジョブを削除するをご覧ください。
REST API
JSON API
レプリケーション ジョブを削除する方法に関する JSON API の手順については、JSON API を使用してレプリケーション ジョブを削除するをご覧ください。