创建查询任务

功能

创建查询任务。

注意事项

无

调用方法

POST

URI

/meter/v1/{domain_id}/query-jobs

路径参数

查询参数

无

请求

• 请求header参数

  请参见请求示例中header描述。

• 请求body参数

  表1 CreateQueryJobRequest对象属性

  参数	是否必选	类型	值域	说明
  hcso_id	否	string	正则表达式为^[-_0-9a-zA-Z]{0,36}	hcso id
  region_id	否	string	正则表达式为^[-_0-9a-zA-Z]{0,255}	hcso id
  min_sdr_time	否	string	正则表达式为^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$	话单文件最小值：2022-01-01 00:00:00，（只使用年月日部分，即查询2022年1月1日开始的话单）
  max_sdr_time	否	string	正则表达式为^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$	话单文件最大值：2022-01-31 00:00:00，（只使用年月日部分，即查询2022年1月30日结束的话单）

• 请求示例

  POST /meter/v1/{domain_id}/query-jobs HTTP/1.1
  Host: example.com
  Content-Type: application/json
  Accept: application/json
  X-Auth-Token: xxx
  { 
      "hcso_id": "xxx", 
      "region_id": "region", 
      "min_sdr_time": "2022-01-01 00:00:00", 
      "max_sdr_time": "2022-02-01 00:00:00" 
  }

响应

• 响应参数
  • 响应状态码201：返回CreateQueryJobResponse。

    表2 CreateQueryJobResponse对象属性

    参数	是否必选	类型	值域	说明
    job_id	否	string	无	任务id。

• 响应示例

  HTTP/1.1 201 OK
  Date:Tue,18 Jul 2023 09:58:01 GMT
  Server: example.com
  Content-Type: application/json;charset=UTF8
  { 
      "job_id": "xxx" 
  }

状态码

操作危险级别

Minor