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 Training 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 Training eines Modells in jeder Region oder jedem Projekt keine narrensichere Methode, um die regionsübergreifende Konsistenz des Modellverhaltens aufrechtzuerhalten. Mit der Funktion „Modell kopieren“ von Vertex AI Model Registry können Sie ein Modell aus der Vertex AI Model Registry an einen separaten Standort im selben Projekt oder in ein anderes Projekt kopieren.

**Hinweis**: Mit der Funktion „Modell kopieren“ können keine AutoML Natural Language und BigQuery ML-Modelle kopiert werden.

Wenn Sie beim Kopieren eines Modells die zu kopierende Modellversion nicht angeben, wird die Standardmodellversion kopiert. Weitere Informationen zur Standardmodellversion oder zum Modellalias finden Sie unter Modellaliasse verwenden.

Beschränkungen

Wenn Sie ein Modell kopieren, werden nicht alle Modellinformationen kopiert. Das kopierte Modell behält Folgendes nicht bei:

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

Bei projektübergreifenden Kopien können Sie keine benutzerdefinierten Modelle mit einem Container-Image eines Drittanbieters kopieren.

Modelle zwischen Projekten kopieren

Vorbereitung

Wenn Sie ein Modell projektübergreifend kopieren möchten, muss der Inhaber des Quellmodells dem Zielprojekt zuerst die Berechtigung zum Exportieren des Modells gewähren:

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. Ein Pop-up-Fenster wird angezeigt, in dem Sie dem Quellprojekt ein neues Hauptkonto hinzufügen können.
4. Rufen Sie das P4SA (Per-Product-Per-Project Service Account) service-{project_number}@gcp-sa-aiplatform.iam.gserviceaccount.com des Zielprojekts ab.
5. Fügen Sie das P4SA des Zielprojekts als neues Hauptkonto zum Quellprojekt hinzu und weisen Sie ihm die Rolle Vertex AI-Dienst-Agent zu.
6. Nachdem Sie auf Speichern geklickt haben, hat das P4SA des Zielprojekts die Berechtigung , Modelle aus dem Quellprojekt zu exportieren.

Hinweis: Wenn Sie dem P4SA des Zielprojekts die Berechtigung zum Exportieren des Modells gewähren, kann jeder Nutzer mit Zugriff auf das Hochladen von Modellen im anderen Projekt den Exportprozess für das Modell 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, in die 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 ID des Quellmodells, das 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 in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in 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 in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. 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 dieser Anleitung, 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 auswählen, indem Sie einen Google-owned and Google-managed encryption key oder einen Cloud KMS-Schlüssel verwenden.

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:Die 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 in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in 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 in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. 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

Bei einer regionsübergreifenden Kopie 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.