> Discover all available pages from the documentation index: https://mastra.zisheng.pro/llms.txt

# dataset.listVersions()

**添加于：** `@mastra/core@1.4.0`

以分页方式列出数据集的所有版本。

## 使用示例

```typescript
import { Mastra } from '@mastra/core'

const mastra = new Mastra({/* storage config */})

const dataset = await mastra.datasets.get({ id: 'dataset-id' })

const { versions, pagination } = await dataset.listVersions({ page: 0, perPage: 10 })

for (const version of versions) {
  console.log(`Version ${version.version} created at ${version.createdAt}`)
}
```

## 参数

**page** (`number`): 页码。默认为 0。

**perPage** (`number`): 每页的版本数。默认为 20。

## 返回值

**result** (`Promise<object>`): 分页的版本列表。

**result.versions** (`DatasetVersion[]`): 版本记录数组。

**result.versions.id** (`string`): 版本记录的唯一标识符。

**result.versions.datasetId** (`string`): 父数据集的 ID。

**result.versions.version** (`number`): 版本号。

**result.versions.createdAt** (`Date`): 此版本的创建时间。

**result.pagination** (`object`): 分页元数据。

**result.pagination.total** (`number`): 版本总数。

**result.pagination.page** (`number`): 当前页码。

**result.pagination.perPage** (`number | false`): 每页版本数；如果未分页则为 false。

**result.pagination.hasMore** (`boolean`): 是否还有更多页面。