Como excluir um modelo do Vertex AI Model Registry

Saiba como excluir um modelo que você não precisa mais do Vertex AI Model Registry.

Se você quiser excluir um BigQuery ML do Registro de modelo da Vertex AI, primeiro precisa excluí-lo do BigQuery ML. Para saber mais, consulte BigQuery ML e Vertex AI Model Registry.

Se quiser excluir um modelo que está implantado em um endpoint, cancele a implantação dele primeiro. Caso contrário, não será possível excluir o modelo.

Não é possível excluir um modelo do Gemini ajustado. No entanto, enquanto estiver inativo, ele não vai gerar custos de inferência.

Excluir um modelo

Console

  1. Acesse a página Registro de modelo na seção "Vertex AI" do console Google Cloud .

    Acessar a página "Modelo de registro"

  2. Selecione Mais ações no modelo que você quer excluir.

  3. Selecione Excluir modelo. Quando você exclui o modelo, todas as versões e avaliações de modelo associadas são excluídas do seu projeto Google Cloud .

  4. Clique em excluir na tela de confirmação.

gcloud

Antes de usar os dados do comando abaixo, faça estas substituições:

  • MODEL_ID: o ID do modelo.
  • PROJECT_ID: o ID do projeto do Google Cloud .
  • LOCATION: a região do seu projeto. Por exemplo, us-central1.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud ai models delete MODEL_ID \
    --project=PROJECT_ID \
    --region=LOCATION

Windows (PowerShell)

gcloud ai models delete MODEL_ID `
    --project=PROJECT_ID `
    --region=LOCATION

Windows (cmd.exe)

gcloud ai models delete MODEL_ID ^
    --project=PROJECT_ID ^
    --region=LOCATION

API

Excluir um modelo usando o SDK Vertex AI para Python.

Python


from google.cloud import aiplatform


def delete_model_sample(model_id: str, project: str, location: str):
    """
    Delete a Model resource.
    Args:
        model_id: The ID of the model to delete. Parent resource name of the model is also accepted.
        project: The project.
        location: The region name.
    Returns
        None.
    """
    # Initialize the client.
    aiplatform.init(project=project, location=location)

    # Get the model with the ID 'model_id'. The parent_name of Model resource can be also
    # 'projects/<your-project-id>/locations/<your-region>/models/<your-model-id>'
    model = aiplatform.Model(model_name=model_id)

    # Delete the model.
    model.delete()

Excluir uma versão de modelo

Console

  1. Acesse a página Registro de modelo na seção "Vertex AI" do console Google Cloud .

    Acessar a página "Modelo de registro"

  2. Expanda o modelo para ver as versões dele. Selecione a versão que você quer excluir.

  3. Selecione Mais ações na versão do modelo. Menu .

  4. Selecione Excluir versão. Todas as avaliações de modelo associadas são excluídas quando você exclui a versão.

gcloud

Antes de usar os dados do comando abaixo, faça estas substituições:

  • MODEL_VERSION_ID: o ID da versão do modelo a ser excluída.
  • PROJECT_ID: o ID do projeto do Google Cloud .
  • LOCATION: a região do seu projeto. Por exemplo, us-central1.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud ai models delete-version MODEL_VERSION_ID \
    --project=PROJECT_ID \
    --region=LOCATION

Windows (PowerShell)

gcloud ai models delete-version MODEL_VERSION_ID `
    --project=PROJECT_ID `
    --region=LOCATION

Windows (cmd.exe)

gcloud ai models delete-version MODEL_VERSION_ID ^
    --project=PROJECT_ID ^
    --region=LOCATION

API

Python


from google.cloud import aiplatform


def delete_model_version_sample(
    model_id: str, version_id: str, project: str, location: str
):
    """
    Delete a Model version.
    Args:
        model_id: The ID of the model to delete. Parent resource name of the model is also accepted.
        version_id: The version ID or version alias of the model to delete.
        project: The project ID.
        location: The region name.
    Returns
        None.
    """
    # Initialize the client.
    aiplatform.init(project=project, location=location)

    # Initialize the Model Registry resource with the ID 'model_id'.The parent_name of Model resource can be also
    # 'projects/<your-project-id>/locations/<your-region>/models/<your-model-id>'
    model_registry = aiplatform.models.ModelRegistry(model=model_id)

    # Delete the model version with the version 'version'.
    model_registry.delete_version(version=version_id)

Excluir um modelo com o alias padrão

Console

  1. No Model Registry, selecione o nome do modelo para visualizar as versões dele.
  2. Selecione a versão pretendida e, no botão Ações, clique no botão em Excluir. Um aviso é aberto, já que você está tentando excluir a versão de alias padrão. Defina primeiro outra versão como padrão.
  3. Selecione qual versão você quer tornar padrão para o modelo no menu suspenso.
  4. Na tela de confirmação, clique em Definir e excluir.

API

Python


from typing import List

from google.cloud import aiplatform


def delete_aliases_model_version_sample(
    model_id: str,
    version_aliases: List[str],
    version_id: str,
    project: str,
    location: str,
):
    """
    Delete aliases to a model version.
    Args:
        model_id: The ID of the model.
        version_aliases: The version aliases to assign.
        version_id: The version ID of the model to assign the aliases to.
        project: The project ID.
        location: The region name.
    Returns
        None.
    """
    # Initialize the client.
    aiplatform.init(project=project, location=location)

    # Initialize the Model Registry resource with the ID 'model_id'.The parent_name of Model resource can be also
    # 'projects/<your-project-id>/locations/<your-region>/models/<your-model-id>'
    model_registry = aiplatform.models.ModelRegistry(model=model_id)

    # Remove the version aliases to the model version with the version 'version'.
    model_registry.remove_version_aliases(
        target_aliases=version_aliases, version=version_id
    )