Updated on 2025-05-29 GMT+08:00

Querying Job Data

Function

Query job data.

Precautions

None

Calling Method

POST

URI

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

Path parameters

Parameter

Mandatory

Type

Value Range

Description

job_id

Yes

string

Regular expression: ^[-_0-9a-zA-Z]{0,36}$

job id

domain_id

Yes

string

Regular expression: ^[-_0-9a-zA-Z]{0,36}$

Tenant ID of ESM.

Query parameters

None

Request

  • Request header parameters

    For details, see the header description in the sample request.

  • Request body parameters
    Table 1 QueryJobSdrRequest object attributes

    Parameter

    Mandatory

    Type

    Value Range

    Description

    marker

    No

    string

    Regular expression: ^[-_+/=0-9a-zA-Z]{0,200}

    Default value: ""

    Query flag, which is in the previous response. It is not required upon the first query.

    limit

    No

    int32

    1~200

    Default value: 100

    Number of returned SDRs

  • Sample request
    GET /meter/v1/{domain_id}/query-jobs/{job_id}/sdr HTTP/1.1
    Host: example.com
    Content-Type: application/json
    Accept: application/json
    X-Auth-Token: xxx
    { 
        "marker": "xxx", 
        "limit": 10 
    }

Response

  • Response parameters
    • Response status code: 200. QueryJobSdrResponse is returned.
      Table 2 QueryJobSdrResponse object attributes

      Parameter

      Mandatory

      Type

      Value Range

      Description

      data

      No

      List<SdrRecordVo>

      None

      SDR data

      marker

      No

      string

      None

      Query flag in the next query. If this parameter is left blank, all data has been returned.

  • Sample response
    HTTP/1.1 200 OK
    Date:Tue,18 Jul 2023 09:58:01 GMT
    Server: example.com
    Content-Type: application/json;charset=UTF8
    { 
        "data": [], 
        "marker": "xxx" 
    }

Status Codes

Table 3 Status codes

Status Code

Description

200

Operation successful.

400

Parameter error.

401

Token authentication failed.

403

Authentication failed.

404

The REST API was not found.

500

Internal error.

Operation Severity

Minor