> For the complete documentation index, see [llms.txt](https://testindata.gitbook.io/dataset/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://testindata.gitbook.io/dataset/open-api/slice.md).

# 使用子集

通过子集管理数据

### 获取子集列表

> GET http\://{{host}}/v1/dataset/{{dataset\_id}}/slices-list

```
GET http://{{host}}/v1/dataset/{{dataset_id}}/slices-list
Content-Type: application/json
T-key: {{T-key}}

Response:
{
  "code": "",
  "msg": "",
  "data": {
    "items": [
        {
            "ds_id": "ds_gsjzgjndgpayunpnyee3",
            "slc_id": "slc_e-okvcmdqrd_-iar",
            "slice_name": "一个23",
            "data_num": 3,
            "created_at": 1623752223
        }
    ]
  }
}


```

### 创建子集并添加文件

可将制定的文件归入到某个子集，子集可单独查看，也可以单独获取使用。

> POST http\://{{host}}/v1/dataset/{{dataset\_id}}/slices

请求参数

| 参数          | 类型     | 是否必传 | 描述     |
| ----------- | ------ | ---- | ------ |
| slice\_name | string | 是    | 子集名称   |
| fids        | string | 是    | 文件ID数组 |

```
POST http://{{host}}/v1/dataset/{{dataset_id}}/slices
Content-Type: application/json
T-key: {{T-key}}

{
    "slice_name": "slice_name",
    "fid": ["fid1", "fid2"]
}


Response:
{
  "code": "",
  "msg": "",
  "data": {
    "slc_id": "slc_8filvuzd4ejcr9iz",
    "succ_num": 1
  }
}
```

### 追加文件到子集

> POST http\://{{host}}/v1/dataset/{{dataset\_id}}/slices

请求参数

| 参数      | 类型     | 是否必传 | 描述     |
| ------- | ------ | ---- | ------ |
| slc\_id | string | 是    | 子集ID   |
| fids    | string | 是    | 文件ID数组 |

```
POST http://{{host}}/v1/dataset/{{dataset_id}}/slices
Content-Type: application/json
T-key: {{T-key}}

{
    "slc_id": "slice_id",
    "fid": ["fid1", "fid2"]
}


Response:
{
  "code": "",
  "msg": "",
  "data": {
    "slc_id": "slc_8filvuzd4ejcr9iz",
    "succ_num": 1
  }
}
```

### 获取子集信息

> GET http\://{{host}}/v1/dataset/{{dataset\_id}}/slices-info/{{slc\_id}}

请求示例

```
GET http://{{host}}/v1/dataset/{{dataset_id}}/slices-info/{{slc_id}}
Content-Type: application/json
T-key: {{T-key}}


Response:
{
  "code": "",
  "msg": "",
  "data": {
      "ds_id": "ds_gsjzgjndgpayunpnyee3",
      "dataset_name": "高清图",
      "slc_id": "slc_e-okvcmdqrd_-iar",
      "slice_name": "一个23",
      "data_num": 3,
      "created_at": 1623752223
  }
}
```