查询指定数据集
功能介绍
查询指定数据集，根据数据集发布者身份标识和数据产品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 | 失败响应 |
错误码
请参见错误码。
