Copiar un modelo en el registro de modelos de Vertex AI

Entrenar tus modelos de AutoML, modelos grandes y modelos personalizados en Vertex AI hasta el nivel que quieras requiere tiempo y experimentación. Si tienes un modelo con buen rendimiento que quieres usar en otro proyecto u otra ubicación, entrenar un modelo nuevo no es la mejor opción. El entrenamiento de modelos no es determinista, por lo que es poco probable que obtengas un modelo idéntico a partir de datos idénticos. Además, entrenar un modelo en cada región o proyecto no es una forma infalible de mantener la coherencia del comportamiento del modelo en todas las regiones. Con la función de copia de modelos del registro de modelos de Vertex AI, puedes copiar un modelo del registro de modelos de Vertex AI en otra ubicación del mismo proyecto o en otro proyecto.

Nota: La función de copia de modelos no admite la copia de modelos de AutoML Natural Language ni de BigQuery ML.

Cuando se copia un modelo, si no se especifica la versión que se quiere copiar, se copia la versión predeterminada. Para obtener más información sobre el modelo predeterminado o el alias del modelo, consulta Cómo usar los alias de modelo.

Limitaciones

Cuando copias un modelo, no se copia toda la información del modelo. El modelo copiado no conservará lo siguiente:

• Alias de versión.
• ID del modelo personalizado. Puedes especificar un nuevo ID una vez que se haya copiado el modelo.
• Cualquier evaluación de modelo que ya exista.
• Especificaciones de cifrado. Debes especificar la clave de cifrado al copiar el modelo en tu región de destino.
• Despliegues e inferencias por lotes.

En las copias entre proyectos, no puedes copiar modelos personalizados que tengan una imagen de contenedor de terceros.

Copiar modelos entre proyectos

Requisitos previos

Para copiar un modelo entre proyectos, el propietario del modelo de origen debe conceder primero el permiso de exportación del modelo al proyecto de destino:

1. Selecciona tu proyecto en la Google Cloud consola.
2. Ve a la página IAM y administración.
3. En la página de permisos de gestión de identidades y accesos, haz clic en Conceder acceso. Aparecerá una ventana emergente que te permitirá añadir un nuevo principal al proyecto de origen.
4. Obtén la cuenta de servicio por producto y por proyecto (P4SA) service-{project_number}@gcp-sa-aiplatform.iam.gserviceaccount.com del proyecto de destino.
5. Añade la P4SA del proyecto de destino como un nuevo principal al proyecto de origen y asígnale el rol Agente de servicio de Vertex AI.
6. Después de hacer clic en Guardar, el proyecto de destino de la SA de P4 tendrá permisos para exportar modelos del proyecto de origen.

Nota: Si se concede el permiso de exportación de modelos al proyecto de destino P4SA, cualquier usuario con acceso de subida de modelos en el otro proyecto podrá activar el proceso de exportación de modelos.

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• DESTINATION_LOCATION: la región a la que quieres copiar el modelo. Por ejemplo, us-central1
• DESTINATION_PROJECT_ID: el ID o el número del proyecto en el que quieras copiar el modelo.
• SOURCE_PROJECT_ID: tu ID o número de proyecto.
• SOURCE_LOCATION: la región de Vertex AI desde la que copias un modelo.
• SOURCE_MODEL_ID: la fuente del ID del modelo que se va a copiar.
• VERSION_ID: (Opcional) ID de la versión del modelo que se va a copiar. Si no se proporciona, se copiará la versión predeterminada.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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)

Nota: El siguiente comando presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$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

Deberías recibir una respuesta JSON similar a la siguiente:

  {
    "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"
      }
    }
  }

Consola

Sigue estas instrucciones para copiar modelos en otro proyecto.

1. En la Google Cloud consola, ve a la página Registro de modelos de Vertex AI. Ir al registro de modelos de Vertex AI
2. En el registro de modelos, seleccione el menú Más acciones del modelo que quiera copiar.
   
3. Haga clic en Copiar modelo.
4. Elige A otro proyecto o A otra región.

Copiar un modelo en otro proyecto

1. Elige A otro proyecto.
2. Elige la versión del modelo que quieras copiar.
3. Elige el proyecto de destino en el que quieras copiarlo.
4. Elige la región de destino (por ejemplo, us-central1).
5. Opciones avanzadas: puedes elegir el método de cifrado mediante una Google-owned and Google-managed encryption key o una clave de Cloud KMS.

Copiar modelos entre ubicaciones

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• DESTINATION_LOCATION: la región en la que usas Vertex AI. Por ejemplo, us-central1
• SOURCE_LOCATION: la región de Vertex AI desde la que copiarás el modelo.
• PROJECT_ID: tu ID o número de proyecto.
• MODEL_ID:ID del modelo que se va a copiar.
• VERSION_ID: (Opcional) ID de la versión del modelo que se va a copiar. Si no se proporciona, se copiará la versión predeterminada.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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)

Nota: El siguiente comando presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$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

Deberías recibir una respuesta JSON similar a la siguiente:

  {
    "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"
      }
    }
  }

Consola

Con una copia entre regiones, puedes copiar un modelo como un modelo nuevo en la región de destino o como una versión nueva de un modelo que ya tengas en esa región.

Sigue estas instrucciones para copiar modelos.

1. En la Google Cloud consola, ve a la página Registro de modelos de Vertex AI. Ir a Registro de modelos
2. En el registro de modelos, seleccione el menú Más acciones del modelo que quiera copiar.
   
3. Haz clic en Copiar modelo.
4. Elige A otro proyecto o A otra región.

Copiar un modelo en otra región

1. Elige A otra región.
2. Elige la versión del modelo que quieras copiar.
3. Selecciona Copiar como modelo nuevo o Copiar como versión nueva.
4. Elige la región de destino.
5. Añade el nombre o el ID del modelo de destino. Si copias un modelo por primera vez, se le asignará el alias predeterminado en la nueva región.