文档首页/ 区块链服务 BCS/ 开发指南/ 区块链中间件接口/ 可信数据交换（公测）/ 数据集管理/ 查询数据集列表
更新时间：2023-01-17 GMT+08:00
查看PDF
分享

查询数据集列表

功能介绍

查询数据集，支持分页和按条件过滤查询

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

分页信息
表3 DatasetResponse

参数

参数类型

描述

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

加密类型
表4 DataFile

参数

参数类型

描述

fileType

String

文件类型

dataUrl

String

数据url

dataHash

String

数据哈希

dataSize

String

数据大小

dataName

String

数据名称
表5 PaginationResp

参数

参数类型

描述

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

失败响应

错误码

请参见错误码。

父主题： 数据集管理