Administra plantillas de entorno de ejecución

En esta página, se describe cómo administrar una plantilla de entorno de ejecución de Colab Enterprise, incluidas las siguientes tareas:

  • Edita una plantilla de entorno de ejecución.
  • Borra una plantilla de entorno de ejecución.

Roles obligatorios

Para obtener los permisos que necesitas para administrar una plantilla de entorno de ejecución de Colab Enterprise, pídele a tu administrador que te otorgue el rol de administrador de Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin) de IAM en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Edita una plantilla de entorno de ejecución

Puedes realizar cambios en algunas de las especificaciones de tu plantilla de entorno de ejecución, incluida la versión de Python y la configuración de la clave de encriptación. Cualquier cambio que se haga en la plantilla del entorno de ejecución solo se aplicará a los entornos de ejecución recién creados a partir de esta plantilla.

Para editar una plantilla de entorno de ejecución, puedes usar la Google Cloud consola o la API de REST.

Console

Para editar una plantilla de entorno de ejecución, haz lo siguiente:

  1. En la Google Cloud consola, ve a la página Plantillas de entorno de ejecución de Colab Enterprise.

    Ir a Plantillas de entorno de ejecución

  2. En el menú Región, selecciona la región que contiene tu plantilla de entorno de ejecución.

  3. En la columna ID, haz clic en el número de ID de la plantilla de entorno de ejecución que deseas editar.

  4. Haz clic en  Editar.

  5. En el panel Editar plantilla de entorno de ejecución, realiza cambios en la plantilla de entorno de ejecución.

  6. Haz clic en Actualizar.

REST

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

  • REGION: la región en la que se encuentra tu plantilla de entorno de ejecución
  • PROJECT_ID: ID del proyecto
  • NOTEBOOK_RUNTIME_TEMPLATE_ID: el ID de tu plantilla de entorno de ejecución
  • RELEASE_NAME: el nombre de la versión de la imagen que deseas usar Por ejemplo, py311 es el nombre de la versión de la imagen de Python 3.11 Para configurar la imagen en Latest, deja RELEASE_NAME vacío.

Método HTTP y URL: 

PATCH https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name

Cuerpo JSON de la solicitud: 

{
  softwareConfig: {
    colabImage: {
      releaseName: "RELEASE_NAME"
    }
  }
}

Para enviar tu solicitud, elige una de estas opciones:

curl

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

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name"

PowerShell

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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name" | Select-Object -Expand Content
Si se ejecuta correctamente, el cuerpo de la respuesta contiene una instancia de operación.

Para obtener información sobre los parámetros de consulta disponibles, consulta la notebookRuntimeTemplates.patch API de REST documentación.

Borra una plantilla de entorno de ejecución

Para borrar una plantilla de entorno de ejecución, puedes usar la Google Cloud consola, gcloud CLI o la API de REST.

Console

Para borrar una plantilla de entorno de ejecución, haz lo siguiente:

  1. En la Google Cloud consola, ve a la página Plantillas de entorno de ejecución de Colab Enterprise.

    Ir a Plantillas de entorno de ejecución

  2. En el menú Región, selecciona la región que contiene tu plantilla de entorno de ejecución.

  3. Selecciona la plantilla de entorno de ejecución que deseas borrar.

  4. Haz clic en  Borrar.

  5. Haz clic en Confirmar.

gcloud

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

  • RUNTIME_ID: el ID de tu entorno de ejecución
  • PROJECT_ID: ID del proyecto
  • REGION: la región en la que se encuentra tu entorno de ejecución

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud colab runtimes delete RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

gcloud colab runtimes delete RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

gcloud colab runtimes delete RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

Si deseas obtener más información sobre el comando para borrar una plantilla de entorno de ejecución desde la línea de comandos, consulta la documentación de gcloud CLI.

REST

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

  • REGION: la región en la que se encuentra tu entorno de ejecución
  • PROJECT_ID: ID del proyecto
  • RUNTIME_ID: el ID de tu entorno de ejecución

Método HTTP y URL: 

DELETE https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el siguiente comando: 

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID"

PowerShell

Ejecuta el siguiente comando: 

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

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID" | Select-Object -Expand Content
Si se ejecuta correctamente, el cuerpo de la respuesta contiene una instancia de operación.

Para obtener más información, consulta la documentación de la API de REST de notebookRuntimeTemplates.delete.

¿Qué sigue?