Method: projects.locations.models.listVersions

Lists versions of the specified model.

HTTP request

GET https://{service-endpoint}/v1beta1/{name}:listVersions

Where {service-endpoint} is one of the supported service endpoints.

Path parameters

Parameters
name

string

Required. The name of the model to list versions for.

Query parameters

Parameters
pageSize

integer

The standard list page size.
pageToken

string

The standard list page token. Typically obtained via nextPageToken of the previous models.listVersions call.
filter

string

An expression for filtering the results of the request. For field names both snake_case and camelCase are supported.

  • labels supports general map functions that is:
    • labels.key=value - key:value equality
    • `labels.key:* or labels:key - key existence
    • A key including a space must be quoted. labels."a key".

Some examples:

  • labels.myKey="myValue"
readMask

string (FieldMask format)

Mask specifying which fields to read.

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".
orderBy

string

A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields:

  • createTime
  • updateTime

Example: updateTime asc, createTime desc.

Request body

The request body must be empty.

Response body

Response message for ModelService.ListModelVersions

If successful, the response body contains data with the following structure:

JSON representation 
{
  "models": [
    {
      object (Model)
    }
  ],
  "nextPageToken": string
}
Fields
models[]

object (Model)

List of Model versions in the requested page. In the returned Model name field, version ID instead of regvision tag will be included.
nextPageToken

string

A token to retrieve the next page of results. Pass to ListModelVersionsRequest.page_token to obtain that page.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the name resource:

  • aiplatform.models.get

For more information, see the IAM documentation.