Help Center/ Data Security Center/ API Reference/ API Description/ Sensitive Data Identification/ Querying the Sub-task List of a Sensitive Data Identification Task
Updated on 2026-01-13 GMT+08:00
Online Debugging
CLI Examples
View PDF
Share

Querying the Sub-task List of a Sensitive Data Identification Task

Function

This API is used to query the sub-task list of a sensitive data identification task.

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.

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 sub-task list of a sensitive data identification task.

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.