Vertex AI Model Registry でモデルをリージョン間でコピーする

Vertex AI で AutoML モデルとカスタムモデルを目的のレベルまでトレーニングするには、時間とテストが必要です。使用したい良好なパフォーマンスのモデルが別の場所にある場合は、新しいモデルのトレーニングはおすすめしません。モデルのトレーニングは本質的に非決定的であるため、最終的に同じデータから同じモデルが完成する可能性は低くなります。また、リージョン間でモデルの動作の整合性を維持する確実な方法は、各リージョンでモデルをトレーニングする方法ではありません。そこで役立つのがモデルのコピー機能です。Vertex AI Model Registry のモデルのコピー機能を使用すると、同じプロジェクトの別のリージョンに Vertex AI Model Registry からモデルを簡単にコピーできます。

モデルをコピーするときに、コピーするモデルのバージョンを指定しないと、デフォルトのモデル バージョンがコピーされます。モデルのデフォルトまたはモデル エイリアスの詳細については、モデル エイリアスの使用方法をご覧ください。

制限事項

モデルをコピーしても、すべてのモデル情報がコピーされるわけではありません。コピーされたモデルでは以下のものは保持されません。

  • バージョンのエイリアス。
  • カスタムモデル ID。モデルのコピー後に新しい ID を指定できます。
  • 既存のモデル評価。
  • 暗号化仕様。コピー時にターゲット リージョン用の新しい仕様を指定する必要があります。
  • デプロイとバッチ予測。

コンソールを使用してロケーション間で AutoML モデルとカスタムモデルをコピーする

コンソール

モデルは、ターゲット リージョン内の新しいモデルとしてコピーできます。また、そのリージョンにある既存のモデルの新しいバージョンとしてコピーすることもできます。

ロケーション間でモデルをコピーするには、次の操作を行います。

  1. Google Cloud コンソールで、[モデル] ページに移動します。<a{: class="button button-primary" l10n-attrs-original-order="href,target,class,track-name,track-type" l10n-encrypted-href="eE471CdLRMtrJ6UgOX6O4ltigmNHgUGOXn/QVSGplOheMVJU/yDyZ/OoAbOtzTXtQQdc2CaGxVtVGC/5S+Yj6A==" target="console" track-name="consoleLink" track-type="tasks" }="">[モデル] に移動 </a{:>
  2. Model Registry で「その他の操作」メニュー を選択します。
  3. [別のリージョンにコピー] をクリックします。
  4. [モデルのコピー] パネルで、コピーするモデルのバージョンを選択し、コピー先のリージョンを選択します。モデルを初めてコピーする場合、新しいリージョンでデフォルトのエイリアスが割り当てられます。

プログラムを使用してロケーション間で AutoML モデルとカスタムモデルをコピーする

HTTP

モデルリソースのコピーメソッドを使用してモデルをコピーするには、次のコードサンプルを使用します。リクエストのデータを使用する前に、次のように置き換えます。

  • LOCATION: Vertex AI を使用するリージョン。
  • SOURCE_LOCATION: モデルのコピー元の Vertex AI リージョン。
  • PROJECT_ID: プロジェクト ID またはプロジェクト番号。
  • MODEL_ID: コピーするモデルの ID。
  • VERSION_ID: (省略可)コピーするモデル バージョンの ID(指定しない場合、デフォルト バージョンがコピーされます)。

HTTP メソッドと URL:

POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/models:copy

JSON 本文のリクエスト:

"sourceModel": projects/PROJECT_ID/locations/SOURCE_LOCATION/models/MODEL_ID[@VERSION_ID]

curl:


curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/models:copy"

レスポンス

{
  "name": "projects/PROJECT_ID/locations/LOCATION/models/MODEL_COPY_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CopyModelOperationMetadata",
    "genericMetadata": {
      "createTime": "2022-07-01T00:10:55.621355Z",
      "updateTime": "2022-07-01T00:10:55.621355Z"
    }
  }
}