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 você quiser excluir um modelo implantado em um endpoint, primeiro cancele a implantação dele. Caso contrário, não será possível excluir o modelo.

Um modelo ajustado do Gemini não pode ser excluído. No entanto, enquanto estiver inativo, ele não vai gerar custos de inferência.

Excluir um modelo

Console

  1. Acesse a página Registro do modelo na seção "Vertex AI" do Console do 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 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 Google Cloud ID do projeto.
  • 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.

SDK da Vertex AI para 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 do modelo na seção "Vertex AI" do Console do 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 Google Cloud ID do projeto.
  • 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

SDK da Vertex AI para 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 em 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 na lista suspensa.
  4. Na tela de confirmação, clique em Definir e excluir.

API

SDK da Vertex AI para 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
    )