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