Help Center> CodeArts Check> API Reference> APIs> Task Management> Querying Check Parameters of a Task Rule Set (V2)
Updated on 2024-03-15 GMT+08:00

Querying Check Parameters of a Task Rule Set (V2)

Function

Querying Check Parameters of a Task Rule Set (V2)

Calling Method

For details, see Calling APIs.

URI

GET /v2/{project_id}/tasks/{task_id}/ruleset/{ruleset_id}/check-parameters

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID

task_id

Yes

String

Task ID.

ruleset_id

Yes

String

Rule Set ID

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

language

Yes

String

Rule Set Language

Request Parameters

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

Content-Type

No

String

Setting the Media Type and Encoding Format

X-Auth-Token

Yes

String

User token. It can be obtained by calling an IAM API. The value of X-Subject-Token in the response header is the user token.

Minimum: 1

Maximum: 100000

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

[items]

Array of TaskCheckParamters objects

Request succeeded!

Table 5 TaskCheckParamters

Parameter

Type

Description

check_id

Integer

Check Tool ID

name

String

Compilation Parameter Name

checker_configs

Array of CheckConfigInfo objects

Checking Parameter Settings

Table 6 CheckConfigInfo

Parameter

Type

Description

name

String

Check the parameter name.

cfg_key

String

Check the key value corresponding to the parameter.

default_value

String

Checking the Default Value of a Parameter

option_value

String

Check the optional parameters.

is_required

Integer

0: optional; 1: mandatory

description

String

Check Parameter Description

type

Integer

Parameter type. The options are as follows: 0: text; 2: optional.

status

String

Parameter status. The options are on (enabled) and off (disabled).

value

String

Checks parameter values.

Status code: 400

Table 7 Response body parameters

Parameter

Type

Description

error_code

String

Error Codes

error_msg

String

Description

Status code: 401

Table 8 Response body parameters

Parameter

Type

Description

error_code

String

Error Codes

error_msg

String

Description

Example Requests

GET https://{endpoint}/v2/{project_id}/tasks/{task_id}/ruleset/{ruleset_id}/check-parameters

Example Responses

Status code: 200

Request succeeded!

[ {
  "check_id" : 0,
  "name" : "compile_tool",
  "check_configs" : [ {
    "value" : "",
    "name" : "Command",
    "cfg_key" : "",
    "default_value" : "",
    "option_value" : "",
    "is_required" : 0,
    "description" : "Command",
    "type" : 0,
    "status" : "on"
  } ]
} ]

Status code: 400

Bad Request

{
  "error_code" : "CC.00000000",
  "error_msg" : "The network is busy. Please try again later."
}

Status code: 401

Unauthorized

{
  "error_code" : "CC.00000003",
  "error_msg" : "The authentication information has expired."
}

Status Codes

Status Code

Description

200

Request succeeded!

400

Bad Request

401

Unauthorized

Error Codes

See Error Codes.