Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
    • Yandex Cloud Partner program
  • Blog
  • Pricing
  • Documentation
© 2025 Direct Cursus Technology L.L.C.
Yandex Foundation Models
    • Overview
    • API authentication
        • Overview
          • Overview
          • Describe
          • Validate
          • Create
          • Update
          • Delete
          • List
          • ListUploadFormats
          • ListUploadSchemas
          • GetUploadDraftUrl
          • GetDownloadUrls
          • StartMultipartUploadDraft
          • FinishMultipartUploadDraft
          • ListTypes
          • GetPreview
          • ListOperationsIds
  • Yandex Cloud ML SDK
  • Compatibility with OpenAI
  • Access management
  • Pricing policy
  • Public materials
  • Release notes

In this article:

  • gRPC request
  • ListDatasetsRequest
  • ListDatasetsResponse
  • DatasetInfo
  • ValidationError
  1. API references
  2. Dataset API
  3. gRPC
  4. Dataset
  5. List

Foundation Models Dataset Service API, gRPC: DatasetService.List

Written by
Yandex Cloud
Improved by
Tania L.
Updated at April 24, 2025
  • gRPC request
  • ListDatasetsRequest
  • ListDatasetsResponse
  • DatasetInfo
  • ValidationError

Lists datasets in specified folder.

gRPC requestgRPC request

rpc List (ListDatasetsRequest) returns (ListDatasetsResponse)

ListDatasetsRequestListDatasetsRequest

{
  "folder_id": "string",
  "status": [
    "Status"
  ],
  "dataset_name_pattern": "string",
  "task_type_filter": [
    "string"
  ],
  "page_size": "int64",
  "page_token": "string",
  "dataset_ids": [
    "string"
  ]
}

Field

Description

folder_id

string

Required field. Folder ID of the datasets to list.

status[]

enum Status

Statuses of the datasets to list. Optional.

  • STATUS_UNSPECIFIED
  • DRAFT
  • VALIDATING
  • READY
  • INVALID
  • DELETING

dataset_name_pattern

string

Name substring of the datasets to list. Optional.

task_type_filter[]

string

Task types of the datasets to list. Optional.

page_size

int64

The maximum number of results per page to return. If the number of available
results is larger than page_size,
the service returns a ListDatasetsResponse.next_page_token
that can be used to get the next page of results in subsequent list requests. Default value: 100.

page_token

string

Page token. To get the next page of results, set page_token to the
ListDatasetsResponse.next_page_token returned by a previous list request.

dataset_ids[]

string

Dataset Id of the datasets to list. Optional.

ListDatasetsResponseListDatasetsResponse

{
  "datasets": [
    {
      "dataset_id": "string",
      "folder_id": "string",
      "name": "string",
      "description": "string",
      "metadata": "string",
      "status": "Status",
      "task_type": "string",
      "created_at": "google.protobuf.Timestamp",
      "updated_at": "google.protobuf.Timestamp",
      "rows": "int64",
      "size_bytes": "int64",
      "created_by_id": "string",
      "labels": "map<string, string>",
      "created_by": "string",
      "updated_by": "string",
      "validation_error": [
        {
          "error": "string",
          "error_description": "string",
          "row_numbers": [
            "int64"
          ]
        }
      ],
      "allow_data_log": "bool"
    }
  ],
  "next_page_token": "string"
}

Field

Description

datasets[]

DatasetInfo

Information about listed datasets.

next_page_token

string

next_page_token token allows you to get the next page of results for list requests.
If the number of results is larger than ListDatasetsRequest.page_size, use
the next_page_token as the value for the ListDatasetsRequest.page_token query parameter
in the next list request. Each subsequent list request will have its own
next_page_token to continue paging through the results.

DatasetInfoDatasetInfo

Information about the dataset.

Field

Description

dataset_id

string

ID of the dataset.

folder_id

string

Folder ID of the dataset.

name

string

Name of the dataset.

description

string

Description of the dataset.

metadata

string

Metadata of the dataset.

status

enum Status

Status of the dataset.

  • STATUS_UNSPECIFIED
  • DRAFT
  • VALIDATING
  • READY
  • INVALID
  • DELETING

task_type

string

Task type of the dataset.

created_at

google.protobuf.Timestamp

Create dataset timestamp.

updated_at

google.protobuf.Timestamp

Update dataset timestamp.

rows

int64

Number of rows in the dataset.

size_bytes

int64

Size of the dataset.

created_by_id

string

Deprecated. Use created_by instead

labels

object (map<string, string>)

Labels of the dataset

created_by

string

User ID of the dataset's creator.

updated_by

string

User ID of the dataset's last updater.

validation_error[]

ValidationError

allow_data_log

bool

Allow to use the dataset to improve the models quality. Default false.

ValidationErrorValidationError

Information about dataset validation error.

Field

Description

error

string

Name of the validation error.

error_description

string

Description of the validation error.

row_numbers[]

int64

Row numbers in which the error occurred.

Was the article helpful?

Previous
Delete
Next
ListUploadFormats
© 2025 Direct Cursus Technology L.L.C.