Copia un modelo en Vertex AI Model Registry

Entrenar tus modelos de AutoML, grandes y personalizados en Vertex AI al nivel que deseas requiere tiempo y experimentación. Si tienes un modelo con buen rendimiento que te gustaría usar en otra ubicación o proyecto, el entrenamiento de un modelo nuevo no es la mejor opción. El entrenamiento de modelos no es determinista por naturaleza, por lo que es poco probable que tengas 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 de un modelo entre regiones. Con el modelo de copia de Vertex AI Model Registry, puedes copiar un modelo de Vertex AI Model Registry a una ubicación independiente en el mismo proyecto o en uno diferente.

Nota: La copia de modelo no admite la copia de modelos de AutoML Natural Language y BigQuery ML.

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

Limitaciones

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

• Alias de versiones.
• El ID de modelo personalizado: puedes especificar un ID nuevo una vez que se copia el modelo.
• Cualquier evaluación existente del modelo.
• Especificaciones de encriptación. Debes especificar uno nuevo después de copiarlo en tu región de destino.
• Implementaciones y predicciones por lotes.
• Para la copia entre proyectos, puedes copiar modelos personalizados que tengan una imagen de contenedor de terceros.

Copia modelos entre proyectos

Vista previa

Este producto o función está sujeto a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones específicas del Servicio. Los productos y las funciones que se encuentran en la fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Requisitos previos

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

1. Selecciona tu proyecto en la consola de Google Cloud.
2. Navega a la página IAM y administración.
3. En la página de permisos de IAM, haz clic en Otorgar acceso y aparecerá una ventana emergente para permitirte agregar un principal nuevo al proyecto de origen.
4. Obtén el número de proyecto numérico del proyecto de destino y la credencial P4SA del proyecto de destino
5. Agrega la credencial de la P4SA del proyecto de destino como el principal nuevo al proyecto fuente y asigna el rol de agente de servicio de Vertex AI a la P4SA del proyecto de destino.
6. Después de hacer clic en Guardar, el proyecto de destino P4SA tiene permisos para exportar modelos del proyecto de origen.

REST

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• DESTINATION_LOCATION: La región en la que deseas copiar el modelo. Por ejemplo, us-central1
• SOURCE_LOCATION: La región de Vertex AI desde la que copias un modelo.
• SOURCE_PROJECT_ID: Tu ID del proyecto o número de proyecto.
• MODEL_ID: ID del modelo que se copiará.
• SOURCE_MODEL_ID:La fuente del ID del modelo que se copiará.
• VERSION_ID: (Opcional) ID de la versión del modelo que se copiará (si no se copia 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, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, 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 supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, 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 que se muestra a continuación:

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

Usa las siguientes instrucciones para copiar un modelo en un proyecto diferente.

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

Cómo copiar el modelo a un proyecto diferente

1. Elige A otro proyecto.
2. Elige la versión del modelo que deseas copiar.
3. Elige el proyecto de destino al que deseas copiar.
4. Elige la región de destino, por ejemplo, us-central1.
5. Opciones avanzadas: Opcional para elegir el método de encriptación, con una clave de encriptación administrada por Google o una clave de Cloud KMS.

Cómo copiar modelos entre ubicaciones

REST

Antes de usar cualquiera de los datos de solicitud a continuación, haz los siguientes reemplazos:

• 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 del proyecto o número de proyecto.
• MODEL_ID: ID del modelo que se copiará.
• VERSION_ID: (Opcional) ID de la versión del modelo que se copiará (si no se copia 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, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, 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 supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, 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 que se muestra a continuación:

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

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

Usa las siguientes instrucciones para copiar modelos.

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

Cómo copiar un modelo a una región diferente

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