> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# PIN 列出数据集

> PIN API 的 GET /v1/datasets。获取账户中的全部数据集列表，包含名称、格式、状态与元数据。

使用列出数据集接口获取与你的账户关联的全部数据集。响应包含每个数据集的名称、格式、状态、大小、行数、访问模式与创建时间。

## 接口

```http theme={null}
GET /v1/datasets
```

## 认证

需要有效的 `Authorization: Bearer <jwt-or-api-key>` 头。

## 响应

<ResponseField name="items" type="array">
  <Expandable title="数据集对象">
    <ResponseField name="id" type="string">
      唯一的数据集标识符。
    </ResponseField>

    <ResponseField name="name" type="string">
      数据集名称。
    </ResponseField>

    <ResponseField name="format" type="string">
      文件格式，例如 `jsonl`、`csv` 或 `parquet`。
    </ResponseField>

    <ResponseField name="status" type="string">
      当前状态，例如 `ready`、`processing` 或 `downloading`。
    </ResponseField>

    <ResponseField name="size_bytes" type="integer">
      数据集大小，以字节为单位。
    </ResponseField>

    <ResponseField name="rows" type="integer">
      数据集中的行数。
    </ResponseField>

    <ResponseField name="access_mode" type="string">
      访问模式，取值为 `local` 或 `stream`。
    </ResponseField>

    <ResponseField name="created_at" type="string">
      数据集创建的 ISO 8601 时间戳。
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET https://ariapin.example.com:8001/v1/datasets \
    -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "code": 0,
    "data": {
      "items": [
        {
          "id": "ds_123",
          "name": "my-dataset",
          "format": "jsonl",
          "status": "ready",
          "size_bytes": 10485760,
          "rows": 50000,
          "access_mode": "local",
          "created_at": "2024-06-10T14:22:00Z"
        }
      ]
    },
    "message": ""
  }
  ```
</ResponseExample>