> ## 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 按 ID 获取数据集

> PIN API 的 GET /v1/datasets/{id}。获取单个数据集的详情，包括格式、状态、大小、行数、访问模式与创建时间。

使用获取数据集接口检索特定数据集的详细信息。在路径中提供数据集标识符。

## 接口

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

## 认证

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

## 路径参数

<ParamField path="id" type="string" required>
  数据集的唯一标识符。
</ParamField>

## 响应

<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>

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "code": 0,
    "data": {
      "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>