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

Excluir um modelo

Console

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

    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 associadas são excluídas do seu Google Cloud projeto.

  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 doprojeto.
  • LOCATION: a região do seu projeto. Por exemplo, us-central1. Se a região no URL do endpoint de API estiver em conflito com o local no caminho do recurso, o local no caminho será ignorado.

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

Exclua um modelo usando o SDK da 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 do modelo na seção "Vertex AI" do Google Cloud console.

    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 doprojeto.
  • LOCATION: a região do seu projeto. Por exemplo, us-central1. Se a região no URL do endpoint de API estiver em conflito com o local no caminho do recurso, o local no caminho será ignorado.

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 desejada e, no botão Ações , clique 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

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
    )