Copy Model API は、モデルを 1 つの AML AI インスタンスから別のインスタンスにコピーします。これは通常、モデルのトレーニングと評価が完了した後に、コンシューマー インスタンスからホスト インスタンスにモデルをコピーするために行われます。複数のインスタンスの当事者登録の共有もご覧ください。
AML AI モデルを別の AML AI インスタンスにコピーする
モデルをインスタンス間でコピーすると、コピーされたモデルはコピー元のモデルと同一になります。ただし、次の例外があります。
- ソースモデル フィールドは、モデルがコピーされたことを示します。モデルのコピーの
satisfiesPziフィールドとsatisfiesPzsフィールドは、新しいモデルの GPS パスを示すために、ソースモデルとは異なります。モデルのコピーのcreateTimeフィールドとupdateTimeフィールドも、ソースモデルとは異なります。 engineVersionフィールドは、宛先インスタンス内の同じエンジン バージョンのローカル参照に更新されます。
前提条件
- ユーザーは、移行元インスタンスと移行先インスタンスに対してそれぞれ
financialservices.v1models.copyFrom権限とfinancialservices.v1models.copyTo権限を持っています。これは、移行元プロジェクトと移行先プロジェクトの両方でユーザーにロールroles/financialservices.adminを付与することで実現できます。 - ソースモデルが存在する。
- 宛先インスタンスが存在する。
- コピー先モデルに使用される同じ名前のモデルが、コピー先インスタンスに存在しない。
リクエストをコピー
CopyModel リクエストに渡すコピー リクエストを作成します。
リクエストのデータを使用する前に、次のように置き換えます。
- DESTINATION_MODEL_ID: 宛先インスタンス内のモデルのユーザー定義の識別子。
- SOURCE_PROJECT: モデルのコピー元となるインスタンスを含むプロジェクト。
- SOURCE_LOCATION: ソースモデルのロケーション。
- SOURCE_INSTANCE_ID: ソースモデルを含むソース インスタンスのユーザー定義の識別子。
- SOURCE_MODEL_ID: ソースモデルのユーザー定義の識別子。
# Example request.json for copying a model:
cat > request.json << 'EOF'
{
# The resource ID of the destination model which will exist under `parent` after the copy is complete.
"model_id": "DESTINATION_MODEL_ID",
"source_model": "projects/SOURCE_PROJECT/locations/SOURCE_LOCATION/instances/SOURCE_INSTANCE_ID/models/SOURCE_MODEL_ID"
}
EOF
Financial Services API の CopyModel リクエストを呼び出します。
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://financialservices.googleapis.com/v1/projects/DESTINATION_PROJECT/locations/DESTINATION_LOCATION/instances/DESTINATION_INSTANCE_ID/models:copy"