Updating the Sensitive Data Identification Result

Function

This API is used to update the sensitive data classification identification result based on the specified task ID and project ID.

Calling Method

For details, see Calling APIs.

URI

PUT /v1/{project_id}/scan-jobs/{job_id}/classification-results

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
job_id	Yes	String	Sensitive data identification task ID, which is used to identify a specific scan task.
project_id	Yes	String	Project ID, which is used to identify a specific project.

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
asset_id	No	String	Asset ID, which uniquely identifies an asset.
asset_name	No	String	Asset name, which is used to identify and manage assets.
asset_type	No	String	Asset type, such as OBS, DATABASE, and BIGDATA.
create_time	No	Long	Timestamp when the identification result is created.
id	No	String	Result flag, which uniquely identifies the identification result.
ins_id	No	String	Instance ID, which is used to identify a specific instance.
job_id	No	String	Task ID, which is used to identify a specific task.
match_info	No	Array of ClassificationMatchReqInfo objects	List of matched rules, including all matched rules in the asset and their details.
object_full_path	No	String	Complete path of the object in an asset.
object_name	No	String	Name of the object in an asset.
project_id	No	String	Project ID, which is used to identify a specific project.
scan_time	No	Long	Timestamp when an asset is identified.
security_level_color	No	Integer	Risk level color of the identification result, which is displayed on the GUI.
security_level_id	No	String	Identification result level ID, which indicates the risk level ID of the asset.
security_level_name	No	String	Identification result level name, which indicates the risk level name of the asset.
task_id	No	String	Subtask ID, which is used to identify a specific subtask.
update_time	No	Long	Timestamp when the identification result is last updated.

**Table 3** ClassificationMatchReqInfo
Parameter	Mandatory	Type	Description
classification_id	No	String	Classification and grading ID, which indicates the classification to which a rule belongs.
classification_name	No	String	Classification and grading name, indicating the name of the classification to which the rule belongs.
match_content_cnt	No	Integer	Number of matched contents.
match_rate	No	Double	Match rate, indicating the accuracy or priority of rule matching.
matched_detail	No	String	Matching details, which indicate the specific content and position matched by the rule.
matched_examples	No	Array of MatchedReqExamples objects	List of matching rules, which includes examples of content matched by the rule.
rule_id	No	String	Rule ID, which uniquely identifies a rule.
rule_name	No	String	Rule name, which is used to identify and manage rules.
security_level_color	No	Integer	Risk level color of the identification result, which is displayed on the GUI.
security_level_id	No	String	Identification result level ID, which indicates the risk level ID identified by the rule.
security_level_name	No	String	Identification result level name, which indicates the risk level name identified by the rule.
template_id	No	String	Template ID, which is used to identify a specific scan template.
template_name	No	String	Template name, which is used to identify and manage templates.

**Table 4** MatchedReqExamples
Parameter	Mandatory	Type	Description
context	No	String	Context of the matching content.
line_number	No	Long	Number of rows, which indicates the specific position of the matched content in the file.
matched_content	No	String	Detailed matched content.

Response Parameters

Status code: 200

Request succeeded. The update result is returned.

Status code: 201

Update succeeded.

None

Example Requests

PUT /v1/{project_id}/scan-jobs/{job_id}/classification-results

{
  "asset_id" : "string",
  "asset_name" : "string",
  "asset_type" : "string",
  "create_time" : 0,
  "id" : "string",
  "ins_id" : "string",
  "job_id" : "string",
  "match_info" : [ { } ],
  "object_full_path" : "string",
  "object_name" : "string",
  "project_id" : "string",
  "scan_time" : 0,
  "security_level_color" : 0,
  "security_level_id" : "string",
  "security_level_name" : "string",
  "task_id" : "string",
  "update_time" : 0
}

Example Responses

None

Status Codes

Status Code	Description
200	Request succeeded. The update result is returned.
201	Update succeeded.
401	Unauthorized. The user is not logged in or the token is invalid.
403	Unauthorized to access the resource.
404	The specified task or project is not found.