リージョン エンドポイント

Storage Transfer Service のエージェント ベースの転送は、Cloud Storage リージョン エンドポイントをサポートしています。Cloud Storage リージョン エンドポイントが指定されている場合、エージェントを介して Cloud Storage バケットとの間で送受信されるすべてのデータ転送トラフィックは、その Google Cloud リージョン内に留まります。転送に関係する Cloud Storage バケット(ファイル システム間の転送用の中間バケットを含む)は、指定されたリージョンに存在する必要があります。そうでない場合、転送は失敗します。

リージョン エンドポイントが指定されていない場合、転送エージェントはグローバル エンドポイントに接続します。これにより、トラフィックは最適にルーティングされますが、転送中のデータのリージョン制限は保証されません。

エージェントレス転送では、リージョン エンドポイントはサポートされていません。

リージョン エンドポイントを指定する

エンドポイントは、転送エージェント レベルで指定されます。エージェントは docker コマンドを使用してインストールする必要があります。

リージョン エンドポイントを指定するには、docker run を使用して転送エージェントをインストールするときに --gcs-api-endpoint フラグを使用します。

sudo docker run --ulimit memlock=64000000 -d --rm \
--volumes-from gcloud-config \
-v HOST_DIRECTORY:CONTAINER_DIRECTORY \
gcr.io/cloud-ingest/tsop-agent:latest \
--project-id=PROJECT_ID \
--hostname=$(hostname) \
--agent-pool=POOL_NAME \
--gcs-api-endpoint=storage.LOCATION.rep.googleapis.com

このフラグは、すべての Cloud Storage シングル リージョン、US マルチリージョン、EU マルチリージョンを受け入れます。完全なリストについては、バケットのロケーションをご覧ください。

エージェント プールでのリージョン エンドポイントの整合性

転送エージェントのエージェント プールを指定する場合、Storage Transfer Service では、そのプール内のすべてのエージェントに均一なリージョン エンドポイントが適用されるわけではありません。つまり、特定のリージョン エンドポイントを持つエージェントと、同じプール内にないエージェントを誤って混在させる可能性があります。その結果、プールはグローバル エンドポイントを介してトラフィックをルーティングする可能性があります。

トラフィックが目的のリージョン内にとどまるようにするには、特定のエージェント プールに同じリージョン エンドポイントを持つエージェントのみを含めます。