
# 查询subTestCase阻塞任务数据 - ListSubTaskCaseOverstockUsing
#### 功能介绍
查询资源池下指定时间段内的阻塞任务数据
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
GET /v1/projects/{service_id}/dashboard/statistic/block
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| service_id | 是    | String | **参数解释：** 项目的32位uuid，项目唯一标识，通过[获取CodeArts项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4005.html)接口查询项目列表获取。 **约束限制** 不涉及 **取值范围** 32个字符组成的字符串 **默认取值** 不涉及 |
   
表2Query参数 
| 参数           | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|:---|
| startTime    | 是    | Long    | 数据开始时间                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| endTime      | 是    | Long    | 数据结束时间                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| executorType | 否    | String  | 执行机类型                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| label        | 是    | String  | 执行机标签                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| location_id  | 否    | String  | **参数解释：** 执行机所属区域id **取值范围：** 大小写字母、数字。 长度限制固定32位 **默认取值：** 无 **获取方法：** 在页面任意位置打开开发者工具，查询subTestCase阻塞任务数据，在/v1/projects/{service_id}/dashboard/statistic/block接口的query中location_id字段 |
| pageNum      | 否    | Integer | 分页当前页码 **默认取值：** 0                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| pageSize     | 否    | Integer | 分页大小(分页参数只要有一个为空即不做分页) **默认取值：** 0                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
   
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释** 用户Token。通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中X-Subject-Token的值） **约束限制** 不涉及 **取值范围** 字符串长度不少于1，不超过100000 **默认取值** 不涉及 |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                                                                                    |
|:---|:---|:---|
| status | String | **参数解释** 接口返回状态，ok-成功，failed-失败 **取值范围** ok,failed |
| result | Object | **参数解释** 租户的在线拨测套餐列表 **取值范围** 不涉及                  |
   
表5PageInfoSubtaskcaseOverstockDto 
| 参数                  | 参数类型                                                                                                         | 描述                 |
|:---|:---|:---|
| end_row             | Long                                                                                                         | 当前页面最后一个元素在数据库中的行号 |
| has_next_page       | Boolean                                                                                                      | 是否有下一页             |
| has_previous_page   | Boolean                                                                                                      | 是否有前一页             |
| is_first_page       | Boolean                                                                                                      | 是否为第一页             |
| is_last_page        | Boolean                                                                                                      | 是否为最后一页            |
| list                | Array of [SubtaskcaseOverstockDto] objects | 返回结果               |
| navigate_first_page | Integer                                                                                                      | 导航条上的第一页           |
| navigate_last_page  | Integer                                                                                                      | 导航条上的最后一页          |
| navigate_pages      | Integer                                                                                                      | 导航页码数              |
| navigatepage_nums   | Array of integers                                                                                            | 所有导航页号             |
| next_page           | Integer                                                                                                      | 下一页                |
| page_num            | Integer                                                                                                      | 当前页                |
| page_size           | Integer                                                                                                      | 每页的数量              |
| pages               | Integer                                                                                                      | 总页数                |
| pre_page            | Integer                                                                                                      | 前一页                |
| size                | Integer                                                                                                      | 当前页的数量             |
| start_row           | Long                                                                                                         | 当前页面第一个元素在数据库中的行号  |
| total               | Long                                                                                                         | 总条数                |
   
 表6SubtaskcaseOverstockDto 
| 参数                          | 参数类型    | 描述      |
|:---|:---|:---|
| data_time                   | String  | 查询时间    |
| executor_type               | String  | 执行机类型   |
| id                          | String  | UUID    |
| label                       | String  | 执行机标签   |
| location_id                 | String  | 执行机所属区域 |
| subtaskcase_overstock_count | Integer | 积压数量    |
| test_service_id             | String  | 服务ID    |
   
**状态码：401**
表7响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误编码 |
| error_msg  | String | 错误原因 |
   
**状态码：403**
表8响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误编码 |
| error_msg  | String | 错误原因 |
   
**状态码：404**
表9响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误编码 |
| error_msg  | String | 错误原因 |
   
#### 请求示例
```
get https://{endpoint}/v1/projects/4858a39d9861476ca2cbc71db0d5db2e/dashboard/statistic/block?startTime=1779366601428&endTime=1779323401428&label=DEFAULT
```
#### 响应示例
**状态码：200**
OK
```
{
  "status" : "ok",
  "result" : {
    "pageNo" : 1,
    "pageSize" : 0,
    "totalPage" : 0,
    "totalSize" : 0,
    "pageList" : [ ]
  }
}
```
**状态码：401**
Unauthorized
```
{
  "error_code" : "DEV.00000003",
  "error_msg" : "认证信息过期"
}
```
#### SDK代码示例
SDK代码示例如下。
#### Java
```
package com.huaweicloud.sdk.test;
import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.cloudtest.v1.region.CloudtestRegion;
import com.huaweicloud.sdk.cloudtest.v1.*;
import com.huaweicloud.sdk.cloudtest.v1.model.*;
public class ListSubTaskCaseOverstockUsingSolution {
    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");
        ICredential auth = new BasicCredentials()
                .withAk(ak)
                .withSk(sk);
        CloudtestClient client = CloudtestClient.newBuilder()
                .withCredential(auth)
                .withRegion(CloudtestRegion.valueOf("<YOUR REGION>"))
                .build();
        ListSubTaskCaseOverstockUsingRequest request = new ListSubTaskCaseOverstockUsingRequest();
        request.withServiceId("{service_id}");
        try {
            ListSubTaskCaseOverstockUsingResponse response = client.listSubTaskCaseOverstockUsing(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}
```
#### Python
```
# coding: utf-8
import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkcloudtest.v1.region.cloudtest_region import CloudtestRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkcloudtest.v1 import *
if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]
    credentials = BasicCredentials(ak, sk)
    client = CloudtestClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(CloudtestRegion.value_of("<YOUR REGION>")) \
        .build()
    try:
        request = ListSubTaskCaseOverstockUsingRequest()
        request.service_id = "{service_id}"
        response = client.list_sub_task_case_overstock_using(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)
```
#### Go
```
package main
import (
"fmt"
"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    cloudtest "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cloudtest/v1"
"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cloudtest/v1/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cloudtest/v1/region"
)
func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")
    auth, err := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        SafeBuild()
    if err != nil {
        fmt.Println(err)
        return
    }
    hcClient, err := cloudtest.CloudtestClientBuilder().
         WithRegion(region.ValueOf("<YOUR REGION>")).
         WithCredential(auth).
         SafeBuild()
    if err != nil {
        fmt.Println(err)
        return
    }
    client := cloudtest.NewCloudtestClient(hcClient)
    request := &model.ListSubTaskCaseOverstockUsingRequest{}
request.ServiceId = "{service_id}"
response, err := client.ListSubTaskCaseOverstockUsing(request)
if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}
```
#### 更多
更多编程语言的SDK代码示例，请参见[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/CloudTest/sdk?api=ListSubTaskCaseOverstockUsing)的代码示例页签，可生成自动对应的SDK代码示例。
#### 状态码
| 状态码 | 描述           |
|:---|:---|
| 200 | OK           |
| 401 | Unauthorized |
| 403 | Forbidden    |
| 404 | Not Found    |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。
