发布数据集
功能介绍
发布数据集。水印功能只支持“华北-北京四”区域
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v1/datashare/dataset
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
orgID |
是 |
String |
组织id |
|
channelID |
是 |
String |
通道id |
|
cryptoMethod |
是 |
String |
加密方法，目前固定为SW |
|
cert |
是 |
String |
证书 |
|
sk |
是 |
String |
私钥 |
|
timestamp |
是 |
String |
时间戳 |
|
provider |
是 |
String |
数据发布者身份标识 |
|
providerName |
否 |
String |
数据发布者名称 |
|
productName |
是 |
String |
产品名称 |
|
productID |
是 |
String |
产品ID |
|
sampleUrl |
是 |
String |
样例数据存放地址 |
|
sampleSize |
否 |
String |
样例数据大小 |
|
sampleType |
否 |
String |
样例数据类型 |
|
sampleName |
否 |
String |
样例数据名称 |
|
fileType |
否 |
String |
数据文件类型 |
|
dataUrl |
是 |
String |
数据存放地址 |
|
dataHash |
否 |
String |
数据哈希 |
|
dataSize |
否 |
String |
数据大小 |
|
dataName |
否 |
String |
数据名称 |
|
description |
否 |
String |
数据集描述信息，在使用abe加密时，需要对加密策略进行详细描述 |
|
plainData |
是 |
String |
base64编码的明文数据 |
|
category |
否 |
String |
加密类型，abe/symmetric，默认为symmetric，如果使用abe加密，则policy必填 |
|
watermarkType |
否 |
String |
水印类型，visible明水印，blind暗水印，嵌入水印时，必须填写；不填写时默认不嵌入水印。嵌入的水印内容为：发布人did_productID。 |
|
file |
否 |
File |
加水印的文件，当对文件加水印时，plainData无效果 |
|
policy |
否 |
policy object |
abe策略 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Threshold |
是 |
Integer |
策略需要满足的属性阈值 |
|
Children |
是 |
Array of policy-children objects |
子属性列表 |
响应参数
状态码： 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 |
加密类型 |
|
encryptData |
String |
加密后的数据 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
fileType |
String |
文件类型 |
|
dataUrl |
String |
数据url |
|
dataHash |
String |
数据哈希 |
|
dataSize |
String |
数据大小 |
|
dataName |
String |
数据名称 |
状态码： 500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
errorCode |
String |
错误码 |
|
errorMsg |
String |
错误描述 |
请求示例
abe示例策略（policy）。该示例策略中，解密者需要符合属性att1=="hello"或符合子策略才能解密；解密者需要属性att3的值大于16才能符合子策略。
{
"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",
"providerName" : "huawei",
"productName" : "prodname",
"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" : "mydata1",
"description" : "this is my second prod",
"plainData" : "base64 encoding string",
"category" : "abe",
"watermarkType" : "string",
"file" : "string",
"policy" : "{\"threshold\" : 1,\"children\" : [{\"name\" : \"att1\", \"type\" : \"plain\",\"value\" : \"hello\"}, {\"name\" : \"policy\", \"type\" : \"policy\",\"value\" : {\"Threshold\" : 1,\"Children\" : [{\"name\" : \"att3\", \"type\" :\"comparable\", \"value\" : {\"op\" : \">\", \"value\" : \"16\", \"maxValue\" : \"10000\"}}]}}]}"
}响应示例
状态码： 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",
"encryptData" : "string"
}状态码： 500
失败响应
{
"errorCode" : "BCS.5002046",
"errorMsg" : "Incorrect number of arguments"
}状态码
|
状态码 |
描述 |
|---|---|
|
200 |
数据集信息 |
|
500 |
失败响应 |
错误码
请参见错误码。
