Updated on 2025-04-27 GMT+08:00

Obtaining the Sensitive Data Level List

Function

This API is used to obtain the sensitive data level list.

Calling Method

For details, see Calling APIs.

URI

GET /v1/{project_id}/scan-security-levels

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID.

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

offset

No

Integer

Page.

limit

No

Integer

Page size.

name

No

String

Level name.

category

No

String

Level source.

is_deleted

No

Boolean

true: Query all levels. false: Query levels that are not disabled.

Request Parameters

None

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

total

Integer

Total number of rules.

security_levels_list

Array of SecurityLevel objects

Rule list.

Table 4 SecurityLevel

Parameter

Type

Description

level_id

String

Task ID.

project_id

String

Project ID.

security_level_name

String

Identification result.

color_number

Integer

Security level in the identification result.

security_level_desc

String

Description of the security level in the identification result.

used_count

Integer

Number of associated identification templates.

category

String

Rule creation type.

create_time

Long

Rule creation time.

update_time

Long

Rule update time.

sort_weight

Integer

Rule order after sorting.

is_deleted

Boolean

Whether to disable the rule.

Status code: 400

Table 5 Response body parameters

Parameter

Type

Description

error_code

String

Error Code

error_msg

String

Error Message

Example Requests

Obtain the sensitive data level list.

GET /v1/{project_id}/scan-security-levels

Example Responses

Status code: 200

Request sent.

{
  "security_levels_list" : [ {
    "level_id" : "xxxxxxxxxxxx",
    "project_id" : "xxxxxxxxxxxx",
    "security_level_name" : "L4",
    "color_number" : 4,
    "security_level_desc" : "xxxxx",
    "used_count" : 4,
    "category" : "BUILT_SELF",
    "create_time" : 1710560820120,
    "update_time" : 1710573345350,
    "sort_weight" : 21,
    "is_deleted" : false
  } ],
  "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.