Help Center/ Data Security Center/ API Reference/ API Description/ Sensitive Data Identification/ Querying the Sensitive Data Identification Subtask List of an Asset
Updated on 2025-07-09 GMT+08:00

Querying the Sensitive Data Identification Subtask List of an Asset

Function

This API is used to query the sensitive data identification subtask list of an asset.

Calling Method

For details, see Calling APIs.

URI

GET /v1/{project_id}/sdg/scan/job/{job_id}/task

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID.

job_id

Yes

String

Sensitive data identification task ID.

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

offset

No

Integer

Page.

limit

No

Integer

Page size.

workspace_id

No

String

Workspace ID

Request Parameters

None

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

total

Integer

Total number of subtasks.

tasks

Array of ScanTask objects

Sub-task list.

Table 4 ScanTask

Parameter

Type

Description

id

String

Task ID.

category

String

Asset type.

status

String

Task status.

progress

Integer

Task progress.

asset_name

String

Asset name.

asset_id

String

Asset ID.

start_time

Long

Task start time.

end_time

Long

Task end time.

scanned_object_num

Integer

Number of identified objects.

to_be_scanned_object_num

Integer

Number of objects to be identified.

scan_speed

Integer

Scanning rate.

skip_object_num

Integer

Number of skipped objects.

last_scan_risk

String

Last identified result.

security_level_name

String

Identification result.

security_level_color

Integer

Security level in the identification result.

Status code: 400

Table 5 Response body parameters

Parameter

Type

Description

error_code

String

Error Code

error_msg

String

Error Message

Example Requests

Query the sensitive data identification subtask list of an asset.

GET /v1/{project_id}/sdg/scan/job/{job_id}/task

Example Responses

Status code: 200

Request sent.

{
  "tasks" : [ {
    "id" : "xxxxxxxxxxxx",
    "category" : "OBS",
    "status" : "FINISHED",
    "progress" : 0,
    "asset_name" : "xxxx",
    "asset_id" : "xxxxxxxxxxxx",
    "start_time" : 1711960461182,
    "end_time" : 1711961941073,
    "scanned_object_num" : 4,
    "to_be_scanned_object_num" : 0,
    "scan_speed" : 1,
    "skip_object_num" : 15,
    "last_scan_risk" : "HIGH",
    "security_level_name" : "L4",
    "security_level_color" : 9
  } ],
  "total" : 1
}

Status code: 400

Invalid request.

{
  "error_code" : "dsc.40000011",
  "error_msg" : "Invalid parameter"
}

Status Codes

Status Code

Description

200

Request sent.

400

Invalid request.

Error Codes

See Error Codes.