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 Modell mit guter Leistung 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 es nicht immer möglich, durch das Training eines Modells in jeder Region oder jedem Projekt für ein konsistentes Modellverhalten in allen Regionen zu sorgen. Mit der Funktion „Modell kopieren“ in der Vertex AI Model Registry können Sie ein Modell aus der Vertex AI Model Registry an einen separaten Speicherort im selben Projekt oder in ein anderes 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 kopiert werden soll, wird die Standardversion des Modells kopiert. Weitere Informationen zu Standardmodellen oder Modellaliassen finden Sie unter Modellaliasse verwenden.

Beschränkungen

Beim Kopieren eines Modells 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.
• Vorhandene Modellbewertungen
• Spezifikationen für die Verschlüsselung Sie müssen beim Kopieren eine neue für die Zielregion angeben.
• Bereitstellungen und Batchvorhersagen
• Für das projektübergreifende Kopieren können Sie benutzerdefinierte Modelle mit einem Container-Image eines Drittanbieters kopieren.

Modelle zwischen Projekten kopieren

Vorschau

Dieses Produkt oder diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Funktionen sind unverändert verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Vorbereitung

Damit ein Modell projektübergreifend kopiert werden kann, muss der Inhaber des Quellmodells zuerst die Exportberechtigung für das Modell für das Zielprojekt 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 gewähren. Daraufhin wird ein Pop-up-Fenster angezeigt, in dem Sie dem Quellprojekt ein neues Hauptkonto hinzufügen können.
4. Rufen Sie die numerische Projektnummer des Zielprojekts und die P4SA-Anmeldedaten des Zielprojekts ab.
5. Fügen Sie dem Quellprojekt die P4SA-Anmeldedaten des Zielprojekts als neues Hauptkonto hinzu und weisen Sie dem Zielprojekt P4SA die Rolle des Vertex AI-Dienst-Agents zu.
6. Nachdem Sie auf Speichern geklickt haben, hat das Zielprojekt-P4SA Berechtigungen zum Exportieren von Modellen aus dem Quellprojekt.

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• DESTINATION_LOCATION: Region, in die Sie das Modell kopieren möchten. z. B. us-central1.
• SOURCE_LOCATION: Die Vertex AI-Region, aus der Sie ein Modell kopieren.
• SOURCE_PROJECT_ID: Ihre Projekt-ID oder Projektnummer
• MODEL_ID: ID des zu kopierenden Modells.
• SOURCE_MODEL_ID:Die Quelle der zu kopierenden Modell-ID.
• 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 dieser Anleitung, um ein Modell 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, um die Verschlüsselungsmethode mit einem von Google verwalteten Verschlüsselungsschlüssel oder einem Cloud KMS-Schlüssel auszuwä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 möchten.
• 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

Mit einer regionenübergreifenden Kopie können Sie ein Modell als neues Modell in der Zielregion oder als neue Version eines vorhandenen Modells in dieser Region kopieren.

Folgen Sie der Anleitung unten, 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 Modell-ID des Zielmodells hinzu. Wenn Sie ein Modell zum ersten Mal kopieren, wird ihm in der neuen Region der Standardalias zugewiesen.