This page explains how you can search for and manage your Vertex AI modeland dataset resources by using Data Catalog. You can access allyour managed resources across different projects using Data Catalog.

Data Catalog is a fully managed, scalable metadata management service.The service automatically catalogs the followingmetadata about Vertex AI models and datasets:

• Name and fully-qualified name of model and dataset resources,
• Location (region),
• Creation date and last modification date,
• Model Alias and Model Version ID Dataset data item count,
• Description.

Vertex AI model and dataset metadata is automatically synced toData Catalog at regular intervals, typically every few hours. You canuse Data Catalog to discover and understand your Vertex AImetadata. Use Data Catalog to aid with the following activities:

• Search for models with specific model alias, and modelname across all projects and locations that you have access to. For example, tosearch for a specific model alias usemodel_version_alias=my-model-alias.
• Search for datasets using dataset name, dataset ID across all projects andlocations that you have access to.

With Data Catalog, you can curate metadata by attaching tags toVertex AI resources. Each tag can have multiple metadata fields, andcan be based on a predefined or custom tag template.

For example, you could attach the following tag to a column that containsdeployment environment name:

deployed_to:Test

To learn more about Data Catalog seeData Catalog overview

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.create permission.Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.create permission.Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. Enable the Data Catalog API for the project.

   Enable the Data Catalog API

2. Check permissions.

   You need certain Identity and Access Management (IAM) roles and permissions to search for and attach tags to Vertex AI assets. For details, seeRequired IAM roles and permissions for Data Catalog.

Create tag templates

Tag temples are reusable structures that you can use to rapidly create new tags.Templates help you avoid duplication of work and incomplete tags. Create asmany tag templates as you need.

To learn more, seeTags and tag templates.

Attach tags to Vertex AI assets

Attaching tags to Vertex AI assets lets you do the following:

• Add business metadata to the assets.
• Search for assets by business metadata and other custom metadata.

To learn more, seeTags and tag templates.

Search for Vertex AI assets

Use the Dataplex Universal Catalog search page in the Google Cloud consoleto search for Vertex AI assets.

1. Go to the Dataplex Universal Catalog search page.

   Go to Search

2. In theFilters panel, underSystems, selectVertex AI.

   Dataplex Universal Catalog displays all known Vertex AI assets.

3. Optional: Do one of the following to narrow down the search:

   • Use the faceted search on theSearch page. Select checkboxes underData types,Projects, andTags.

   • In the search field, append a search parameter aftersystem=vertex_ai. Separate parameters with spaces.

     For example, to view only models, enter the following text in thesearch field, and then pressEnter.

     system=vertex_aitype=model

     You can also use parentheses and the logical operatorsand andor forcomplex expressions. To learn more about the expressions that you can usein the search field, seeData Catalog searchsyntax.

4. In the results table, click the name of an asset to view the metadata forthat asset.

5. Optional: Do any of the following:

   • ClickADD OVERVIEW to add a rich text description of the asset.
   • ClickATTACH TAGS to add a tag to the asset.

Required IAM roles and permissions for Data Catalog

Viewing, tagging, and searching Vertex AI resources inData Catalog have different permission requirements.

Permission to view public and private tags

To get the permissions that you need to view public and private tags onVertex AI resources, ask your administrator to grant you the followingIAM roles:

• roles/datacatalog.tagTemplateViewer
• roles/aiplatform.viewer

Permission to search Vertex AI resources

To get the permissions that you need to search Vertex AI resources inData Catalog, ask your administrator to grant you the followingIAM role:

• roles/aiplatform.user

Permission to attach tags to Vertex AI resources

To get the permissions that you need to attach tags to Vertex AIresources in Data Catalog, ask your administrator to grant youthe following IAM roles:

• roles/datacatalog.tagTemplateUser
• roles/datacatalog.tagEditor
• roles/aiplatform.admin

For more information, seePredefined roles.

What's next

• What is Data Catalog
• Roles to search Google Cloud resources