# 查询数据集列表
#### 功能介绍
查询数据集，支持分页和按条件过滤查询
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=BCS&api=QueryDatasetByCond)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
POST /v1/datashare/query-datasets
#### 请求参数
表1请求Body参数 
| 参数           | 是否必选 | 参数类型   | 描述                             |
|:---|:---|:---|:---|
| orgID        | 是    | String | 组织id                           |
| channelID    | 是    | String | 通道id                           |
| cryptoMethod | 是    | String | 加密方法，目前固定为SW                   |
| cert         | 是    | String | 证书                             |
| sk           | 是    | String | 私钥                             |
| timestamp    | 是    | String | 时间戳                            |
| currentPage  | 否    | String | 分页参数：当前页码（默认1）                 |
| pageSizeNum  | 否    | String | 分页参数：每页条数(默认100)               |
| provider     | 否    | String | 过滤条件：发布者身份标识                   |
| searchText   | 否    | String | 过滤条件：匹配关键字（基于数据集中的产品名称、产品描述信息） |
| status       | 否    | String | 过滤条件：数据集状态（ready、closed）       |
   
#### 响应参数
**状态码： 200**
表2响应Body参数 
| 参数         | 参数类型                                                                                | 描述   |
|:---|:---|:---|
| items      | Array of [DatasetResponse] objects | 列表   |
| pagination | [PaginationResp] object             | 分页信息 |
   
 表3DatasetResponse 
| 参数              | 参数类型                                                                  | 描述         |
|:---|:---|:---|
| provider        | String                                                                | 数据集提供者身份标识 |
| providerName    | String                                                                | 数据集提供者名称   |
| productName     | String                                                                | 数据集产品名称    |
| productID       | String                                                                | 数据集产品id    |
| sampleUrl       | String                                                                | 样例数据url    |
| sampleSize      | String                                                                | 样例数据大小     |
| sampleType      | String                                                                | 样例数据类型     |
| sampleName      | String                                                                | 样例数据名称     |
| fileType        | String                                                                | 文件类型       |
| dataUrl         | String                                                                | 数据url      |
| dataHash        | String                                                                | 数据哈希值      |
| dataSize        | String                                                                | 数据大小       |
| dataName        | String                                                                | 数据名称       |
| description     | String                                                                | 数据描述       |
| price           | String                                                                | 数据价格       |
| encryptedAesKey | String                                                                | 密钥         |
| status          | String                                                                | 状态         |
| publishTime     | String                                                                | 数据发布时间     |
| dataFiles       | Array of [DataFile] objects | 数据文件列表     |
| sampleFiles     | Array of [DataFile] objects | 样例文件列表     |
| category        | String                                                                | 加密类型       |
   
 表4DataFile 
| 参数       | 参数类型   | 描述    |
|:---|:---|:---|
| fileType | String | 文件类型  |
| dataUrl  | String | 数据url |
| dataHash | String | 数据哈希  |
| dataSize | String | 数据大小  |
| dataName | String | 数据名称  |
   
 表5PaginationResp 
| 参数          | 参数类型    | 描述   |
|:---|:---|:---|
| currentPage | Integer | 当前页码 |
| pageSizeNum | Integer | 每页条数 |
| totalItems  | Integer | 总条数  |
   
**状态码： 500**
表6响应Body参数 
| 参数        | 参数类型   | 描述   |
|:---|:---|:---|
| errorCode | String | 错误码  |
| errorMsg  | String | 错误描述 |
   
#### 请求示例
```
{
  "orgID" : "ce0ac69b0c8648cd25b44a551780409767c8890b",
  "channelID" : "mychannel",
  "cryptoMethod" : "SW",
  "cert" : "-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----",
  "sk" : "-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----",
  "timestamp" : "2020-10-27T17:28:16+08:00",
  "currentPage" : "string",
  "pageSizeNum" : "string",
  "provider" : "string",
  "searchText" : "string",
  "status" : "string"
}
```
#### 响应示例
**状态码： 200**
数据集分页信息
```
{
  "items" : [ {
    "provider" : "did:example:DHkJjyD5wZwya6sd6BNBnG",
    "providerName" : "aws",
    "productName" : "prodname2",
    "productID" : "product2",
    "sampleUrl" : "http://hwcloud.com/sample.com/prodname2",
    "sampleSize" : "10KB",
    "sampleType" : "csv",
    "sampleName" : "data_sub1",
    "fileType" : "csv",
    "dataUrl" : "http://hwcloud.com/prodname2",
    "dataHash" : "2282ba7a1a2ef5700609214a997d3d4237a03bfd3632c6d089e57e7b6f467969",
    "dataSize" : "100MB",
    "dataName" : "mydata",
    "description" : "this is second prod",
    "price" : "0",
    "encryptedAesKey" : "BA4Ub3t3IskN8uKcEMa+4cbtsDS8OzF4V/qqb4OcPMeMvp7IL+HClzAbL6lPnhbDg/AnrStBlf0qFzRj+qvk6ZH0c7wP0aS48fSoNtecG79aFpFx0dg7rFdVYXWWzgeyI03eD3gFdXlQ/ovpxKJG5ALK39OCazUqDrawZHSDGyIlw0hGh88Q+GVORVSp+6V5Ag==",
    "status" : "ready",
    "publishTime" : "1607157244",
    "dataFiles" : [ {
      "fileType" : "csv",
      "dataUrl" : "http://hwcloud.com/prodname2",
      "dataHash" : "2282ba7a1a2ef5700609214a997d3d4237a03bfd3632c6d089e57e7b6f467969",
      "dataSize" : "100MB",
      "dataName" : "mydata"
    } ],
    "sampleFiles" : [ {
      "fileType" : "csv",
      "dataUrl" : "http://hwcloud.com/prodname2",
      "dataHash" : "2282ba7a1a2ef5700609214a997d3d4237a03bfd3632c6d089e57e7b6f467969",
      "dataSize" : "100MB",
      "dataName" : "mydata"
    } ],
    "category" : "string"
  } ],
  "pagination" : {
    "currentPage" : 1,
    "pageSizeNum" : 100,
    "totalItems" : 10
  }
}
```
**状态码： 500**
失败响应
```
{
  "errorCode" : "BCS.5002046",
  "errorMsg" : "Incorrect number of arguments"
}
```
#### 状态码
| 状态码 | 描述      |
|:---|:---|
| 200 | 数据集分页信息 |
| 500 | 失败响应    |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/devg-bcs/ErrorCode.html)。