Modell in Vertex AI Model Registry kopieren

Das Training Ihrer AutoML- und benutzerdefinierten Modelle in Vertex AI auf das gewünschte Niveau erfordert Zeit und ein wenig Probieren. Wenn Sie ein leistungsstarkes Modell haben, das Sie in einem anderen Projekt oder an einem anderen Standort verwenden möchten, ist das Trainieren eines neuen Modells nicht die beste Option. Das Modelltraining ist nicht deterministisch. Daher ist es unwahrscheinlich, dass Sie mit identischen Daten ein identisches Modell erhalten. Außerdem ist das Trainieren eines Modells in jeder Region oder jedem Projekt keine narrensichere Methode, um die konsistente Modellleistung in verschiedenen Regionen aufrechtzuerhalten. Mit der Funktion zum Kopieren von Modellen in der Vertex AI Model Registry können Sie ein Modell aus der Vertex AI Model Registry an einen separaten Speicherort im selben oder in einem anderen Projekt kopieren.

Hinweis: Das Kopieren von Modellen unterstützt nicht das Kopieren von AutoML Natural Language- und BigQuery ML-Modellen.

Wenn Sie beim Kopieren eines Modells nicht die Modellversion angeben, die Sie kopieren möchten, wird die Standardmodellversion kopiert. Weitere Informationen zum Standardmodell oder zum Modellalias finden Sie unter Modellaliasse verwenden.

Beschränkungen

Wenn Sie ein Modell kopieren, werden nicht alle Modellinformationen kopiert. Folgendes wird nicht in das kopierte Modell übernommen:

• Versionsaliasse.
• Die benutzerdefinierte Modell-ID: Sie können eine neue ID angeben, sobald das Modell kopiert wurde.
• Alle vorhandenen Modellbewertungen.
• Verschlüsselungsspezifikationen. Sie müssen den Verschlüsselungsschlüssel angeben, wenn Sie das Modell für Ihre Zielregion kopieren.
• Bereitstellungen und Batch-Inferenz.

Beim projektübergreifenden Kopieren können Sie keine benutzerdefinierten Modelle kopieren, die ein Container-Image eines Drittanbieters haben.

Modelle zwischen Projekten kopieren

Vorbereitung

Wenn Sie ein Modell in ein anderes Projekt kopieren möchten, muss der Inhaber des Quellmodells dem Zielprojekt zuerst die Berechtigung zum Exportieren des Modells erteilen:

1. Wählen Sie in der Google Cloud -Console Ihr Projekt aus.
2. Rufen Sie die Seite IAM und Verwaltung auf.
3. Klicken Sie auf der Seite „IAM-Berechtigungen“ auf Zugriff erlauben. In einem Pop-up-Fenster können Sie dem Quellprojekt ein neues Hauptkonto hinzufügen.
4. Rufen Sie das produkt- und projektspezifische Dienstkonto (P4SA) service-{project_number}@gcp-sa-aiplatform.iam.gserviceaccount.com des Zielprojekts ab.
5. Fügen Sie das P4SA des Zielprojekts dem Quellprojekt als neues Hauptkonto hinzu und weisen Sie ihm die Rolle „Vertex AI Service Agent“ zu.
6. Nachdem Sie auf Speichern geklickt haben, hat der P4SA des Zielprojekts die Berechtigung, Modelle aus dem Quellprojekt zu exportieren.

Hinweis :Wenn Sie dem P4SA des Zielprojekts die Berechtigung zum Exportieren von Modellen erteilen, kann jeder Nutzer mit Zugriff zum Hochladen von Modellen im anderen Projekt den Modellexportvorgang auslösen.

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• DESTINATION_LOCATION: Region, in die Sie das Modell kopieren möchten. z. B. us-central1.
• DESTINATION_PROJECT_ID: Die Projekt-ID oder Projektnummer des Projekts, in das Sie das Modell kopieren möchten.
• SOURCE_PROJECT_ID: Ihre Projekt-ID oder Projektnummer
• SOURCE_LOCATION: Die Vertex AI-Region, aus der Sie ein Modell kopieren.
• SOURCE_MODEL_ID: Die Quelle der Modell-ID, die kopiert werden soll.
• VERSION_ID: (Optional) ID der zu kopierenden Modellversion (wenn nicht angegeben, wird die Standardversion kopiert)

HTTP-Methode und URL:

POST https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/models:copy

JSON-Text anfordern:

   {
    "sourceModel": "projects/SOURCE_PROJECT_ID/locations/SOURCE_LOCATION/models/SOURCE_MODEL_ID"
    }

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

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

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/models:copy" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

  {
    "name": "projects/PROJECT_ID/locations/LOCATION/models/MODEL_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"
      }
    }
  }

Console

Folgen Sie der Anleitung unten, um Modelle in ein anderes Projekt zu kopieren.

1. Rufen Sie in der Google Cloud Console die Seite Vertex AI Model Registry auf. Zur Vertex AI Model Registry
2. Wählen Sie in Model Registry das Menü Weitere Aktionen  für das Modell aus, das Sie kopieren möchten.
   
3. Klicken Sie auf Modell kopieren.
4. Wählen Sie entweder In ein anderes Projekt oder In eine andere Region aus.

Modell in ein anderes Projekt kopieren

1. Wählen Sie In ein anderes Projekt aus.
2. Wählen Sie die Modellversion aus, die Sie kopieren möchten.
3. Wählen Sie das Zielprojekt aus, in das Sie kopieren möchten.
4. Wählen Sie die Zielregion aus, z. B. us-central1.
5. Erweiterte Optionen: Optional können Sie die Verschlüsselungsmethode mit einem Google-owned and Google-managed encryption key oder einem Cloud KMS-Schlüssel auswählen.

Modelle zwischen Standorten kopieren

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• DESTINATION_LOCATION: Die Region, in der Sie Vertex AI verwenden. z. B. us-central1.
• SOURCE_LOCATION: Die Vertex AI-Region, aus der Sie das Modell kopieren.
• PROJECT_ID: Ihre Projekt-ID oder Projektnummer
• MODEL_ID:ID des zu kopierenden Modells.
• VERSION_ID: (Optional) ID der zu kopierenden Modellversion (wenn nicht angegeben, wird die Standardversion kopiert)

HTTP-Methode und URL:

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

JSON-Text anfordern:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

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

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/models:copy" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

  {
    "name": "projects/PROJECT_ID/locations/LOCATION/models/MODEL_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"
      }
    }
  }

Console

Beim regionenübergreifenden Kopieren können Sie ein Modell als neues Modell in die Zielregion oder als neue Version eines vorhandenen Modells in dieser Region kopieren.

Folgen Sie dieser Anleitung, um Modelle zu kopieren.

1. Rufen Sie in der Google Cloud Console die Seite Vertex AI Model Registry auf. Zu Model Registry
2. Wählen Sie in Model Registry das Menü Weitere Aktionen  für das Modell aus, das Sie kopieren möchten.
   
3. Klicken Sie auf Modell kopieren.
4. Wählen Sie entweder In ein anderes Projekt oder In eine andere Region aus.

Modell in eine andere Region kopieren

1. Wählen Sie In eine andere Region aus.
2. Wählen Sie die Modellversion aus, die Sie kopieren möchten.
3. Wählen Sie entweder Als neues Modell kopieren oder Als neue Version kopieren aus.
4. Wählen Sie die Zielregion aus.
5. Fügen Sie den Namen oder die ID des Zielmodells hinzu. Wenn Sie ein Modell zum ersten Mal kopieren, wird ihm in der neuen Region der Standardalias zugewiesen.