Querying Issue Details Statistics
Function
This API is used to query the statistics of code check issues based on the check task ID, including the number of issues in each status and severity.
Calling Method
For details, see Calling APIs.
Authorization Information
Each account root user has all the permissions required to call all APIs, but IAM users must be assigned the following required identity policy-based permissions. For details about the required permissions, see Permissions Policies and Supported Actions.
| Action | Access Level | Resource Type (*: required) | Condition Key | Alias | Dependencies |
|---|---|---|---|---|---|
| codeartscheck:task:getReport | Read | task * | - | - | - |
| - | codeartscheck:ProjectId |
URI
GET /v2/tasks/{task_id}/defects-statistic
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| task_id | Yes | String | Definition : Task ID, which is the return value of the API used to create a check task. Each check task, its brach tasks, and incremental tasks created through APIs have a unique task ID. Obtain the ID by calling the API used to query the task list. id indicates the task ID. Constraints: N/A. Value range: 1 to 32 characters. Default value: N/A. |
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| time_info_switch | No | String | Definition: Whether to query the check start time and end time. Constraints: N/A Value range: Default value: false |
Request Parameters
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| X-Auth-Token | Yes | String | Definition User token. Obtain one by calling the IAM API Obtaining a User Token. The value of X-Subject-Token in the response header is a token. Constraints N/A Range The length is the value of [1-100000]. Default Value N/A |
Response Parameters
Status code: 200
| Parameter | Type | Description |
|---|---|---|
| severity | StatisticSeverityV2 object | Definition Number of issues of each severity level. |
| status | StatisticStatusV2 object | Definition Number of issues in each status. |
| last_check_time | String | Definition: Check start time (UTC). Format: yyyy-MM-ddTHH:mm:ssZ. For example, 2020-09-25T12:05:00Z. Value range: N/A |
| last_check_finish_time | String | Definition: Check end time (UTC). Format: yyyy-MM-ddTHH:mm:ssZ. For example, 2020-09-25T12:05:00Z. Value range: N/A |
| Parameter | Type | Description |
|---|---|---|
| critical | Integer | Definition: Number of critical issues. Ignored and fixed issues are not included. Value range: N/A |
| major | Integer | Definition: Number of major issues. Ignored and fixed issues are not included. Value range: N/A |
| minor | Integer | Definition: Number of minor issues. Ignored and fixed issues are not included. Value range: N/A |
| suggestion | Integer | Definition: Number of suggestions. Ignored and fixed issues are not included. Value range: N/A |
| Parameter | Type | Description |
|---|---|---|
| unresolved | Integer | Definition: Number of pending issues. Value range: N/A. |
| resolved | Integer | Definition: Number of resolved and fixed issues. Value range: N/A. |
| dismissed | Integer | Definition Number of ignored issues. Range N/A |
| fixed | Integer | Definition Number of fixed issues. Range N/A |
| solved | Integer | Definition Number of resolved issues. Range N/A |
Status code: 400
| Parameter | Type | Description |
|---|---|---|
| error_code | String | Definition: Error code. Value range: N/A |
| error_msg | String | Definition: Error message. Value range: N/A |
Status code: 401
| Parameter | Type | Description |
|---|---|---|
| error_code | String | Definition: Error code. Value range: N/A |
| error_msg | String | Definition: Error message. Value range: N/A |
Example Requests
Query issue details statistics under task ID 2b31ed520xxxxxxebedb6e57xxxxxxxx.
GET https://{endpoint}/v2/tasks/2b31ed520xxxxxxebedb6e57xxxxxxxx/defects-statistic Example Responses
Status code: 200
Request succeeded.
{
"severity" : {
"critical" : 120,
"major" : 877,
"minor" : 79,
"suggestion" : 3
},
"status" : {
"unresolved" : 877,
"resolved" : 79,
"dismissed" : 5,
"fixed" : 70,
"solved" : 9
},
"last_check_time" : null,
"last_check_finish_time" : null
} Status code: 400
A request error occurred.
{
"error_code" : "CC.xxxxxxxx.400",
"error_msg" : "Verify request parameter failed. Check whether the request parameters are correct."
} Status code: 401
The permission is insufficient.
{
"error_code" : "CC.00000003",
"error_msg" : "Authentication information expired."
} Status Codes
| Status Code | Description |
|---|---|
| 200 | Request succeeded. |
| 400 | A request error occurred. |
| 401 | The permission is insufficient. |
Error Codes
See Error Codes.
What is your overall rating for this page?
Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot