查询指定数据集
功能介绍
查询指定数据集，根据数据集发布者身份标识和数据产品id信息查询。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v1/datashare/query-dataset
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
orgID | 是 | String | 组织id |
channelID | 是 | String | 通道id |
cryptoMethod | 是 | String | 加密方法，目前固定为SW |
cert | 是 | String | 证书 |
sk | 是 | String | 私钥 |
timestamp | 是 | String | 时间戳 |
provider | 是 | String | 数据集发布者身份标识 |
productID | 是 | String | 数据集产品id |
响应参数
状态码： 200
参数 | 参数类型 | 描述 |
|---|---|---|
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 | 加密类型 |
参数 | 参数类型 | 描述 |
|---|---|---|
fileType | String | 文件类型 |
dataUrl | String | 数据url |
dataHash | String | 数据哈希 |
dataSize | String | 数据大小 |
dataName | String | 数据名称 |
状态码： 500
参数 | 参数类型 | 描述 |
|---|---|---|
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",
"provider" : "did:example:DHkJjyD5wZwya6sd6BNBnG",
"productID" : "product2"
} 响应示例
状态码： 200
操作结果
{
"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"
} 状态码： 500
失败响应
{
"errorCode" : "BCS.5002046",
"errorMsg" : "Incorrect number of arguments"
} 状态码
状态码 | 描述 |
|---|---|
200 | 操作结果 |
500 | 失败响应 |
错误码
请参见错误码。
