Extracting a Data Watermark
Function
This API is used to extract a data watermark.
URI
POST /v1/{project_id}/sdg/database/watermark/extract
|
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
|
project_id |
Yes |
String |
Project ID. |
Request Parameters
|
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
|
X-Auth-Token |
Yes |
String |
User token, which can be obtained by calling the IAM API (value of X-Subject-Token in the response header). |
|
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
|
watermark_key |
Yes |
String |
Watermark key |
|
columns |
Yes |
Array of Columns objects |
Field type list, which cannot exceed 100. |
|
data |
Yes |
Array of Map<String,Object> objects |
Watermark data records, which cannot exceed 30,000. |
Response Parameters
Status code: 200
|
Parameter |
Type |
Description |
|---|---|---|
|
watermarks |
Array of strings |
List of watermarks extracted. The uploaded data may include different watermarks. All watermarks extracted are returned, and the number of watermarks cannot exceed 100. |
Status code: 400
|
Parameter |
Type |
Description |
|---|---|---|
|
error_code |
String |
Error Code |
|
error_msg |
String |
Error Message |
Example Requests
Extract data watermarks. The watermark key is "key", and the data field of the data type table is "col". This field is not a primary key.
POST https://{endpoint}/v1/{project_id}/sdg/database/watermark/extract
{
"watermark_key" : "key",
"columns" : {
"name" : "col",
"type" : "INTEGER",
"primary_key" : false
},
"data" : {
"col" : 0.1
}
}
Example Responses
Status code: 200
Request successful.
{
"watermarks" : [ "watermark" ]
}
Status code: 400
Parameter error.
{
"error_code" : "DSC.00000004",
"error_msg" : "Invalid parameter"
}
Status Codes
|
Status Code |
Description |
|---|---|
|
200 |
Request successful. |
|
400 |
Parameter error. |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.