Method: projects.locations.datasets.list

Lists Datasets in a Location.

HTTP request

GET https://{service-endpoint}/v1beta1/{parent}/datasets

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

Path parameters

Parameters
parent

string

Required. The name of the Dataset's parent resource. Format: projects/{project}/locations/{location}

Query parameters

Parameters
filter

string

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

  • displayName: supports = and !=
  • metadataSchemaUri: supports = and !=
  • 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:

  • displayName="myDisplayName"
  • labels.myKey="myValue"
pageSize

integer

The standard list page size.

pageToken

string

The standard list page token.

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:

  • displayName
  • createTime
  • updateTime

Request body

The request body must be empty.

Response body

Response message for DatasetService.ListDatasets.

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

JSON representation
{
  "datasets": [
    {
      object (Dataset)
    }
  ],
  "nextPageToken": string
}
Fields
datasets[]

object (Dataset)

A list of Datasets that matches the specified filter in the request.

nextPageToken

string

The standard List next-page token.

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 parent resource:

  • aiplatform.datasets.list

For more information, see the IAM documentation.