tencent cloud

Querying Job
Download PDF
Last updated: 2025-09-09 20:46:31
Querying Job
Last updated: 2025-09-09 20:46:31
Download PDF

Feature Description

This API is used to query a batch data processing job.

Feature Description

Query a batch data processing job.

Authorization Description

When using a sub-account, you need to add the ci:DescribeInventoryTriggerJob permission to the action in the authorization policy. For all supported API operations in Cloud Infinite, see CI action.

Activating a Service

To use this feature, you need to bind a bucket in advance and enable Cloud Infinite service.
Note:
Note: After binding Cloud Infinite (CI), if you manually perform the unbinding operation on the bucket, you will not be able to continue using this function.

Use Limits

When using this API, please confirm the relevant restrictions first. For details, see Usage Limits.



Request

Request Sample

GET /inventorytriggerjob/<jobId> HTTP/1.1
Host: <BucketName-APPID>.ci.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>

Note:
Authorization: Auth String. For details, see the Request Signature document.
<jobId>: task ID. For details, see triggered task (independent node) or triggered task (workflow).

Request Header

This API only uses common request headers. For details, see Common Request Headers documentation.

Request Body

The request does not have a request body.

Response

Response Headers

This API only returns the public response header. For details, see Common Response Headers documentation.

Response Body

The response body is returned as application/xml. An example including the complete node data is shown below:
<Response>
    <RequestId><RequestId>
    <JobsDetail>
    ...
    </JobsDetail>
    <NonExistJobIds></NonExistJobIds>
</Response>
The data are as follows:
Node Name (Keyword)
Parent Node
Description
Type
Response
None.
Container for saving results
Container
Container node Response content:
Node Name (Keyword)
Parent Node
Description
Type
RequestId
Response
unique request ID
String
JobsDetail
Response
Task details
Container
NonExistJobIds
Response
Tasks that do not exist in the query ID Do not return when all tasks exist
String
For different trigger modes, the content of JobsDetail varies. See the following link:
Workflow
Independent task

Error Codes

This request returns common error responses and error codes. For more information, see Error Codes.

Examples

Request

GET /inventorytriggerjob/b3deffea2f84911ec9cb15254008618d9 HTTP/1.1
Accept: */*
Authorization:q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=****************************************
Host:bucket-1250000000.ci.ap-beijing.myqcloud.com


Response

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 666
Connection: keep-alive
Date: Mon, 28 Jun 2022 15:23:12 GMT
Server: tencent-ci
x-ci-request-id: NjJiZDU1ZmZfOTBmYTUwNjRfNzdjY18xYQ==

<Response>
    <RequestId>NjJiZDU1ZmZfOTBmYTUwNjRfNzdjY18xYQ==</RequestId>
    <JobsDetail>
        <Code>Success</Code>
        <Type>Workflow</Type>
        <Message/>
        <Name>demo</Name>
        <JobId>b3deffea2f84911ec9cb15254008618d9</JobId>
        <State>Running</State>
        <CreationTime>2022-06-27T15:23:10+0800</CreationTime>
        <StartTime>-</StartTime>
        <EndTime>-</EndTime>
        <Input>
            <Prefix>input</Prefix>
        </Input>
        <Operation>
            <TimeInterval>
                <Start>2022-02-01T12:00:00+0800</Start>
                <End>2022-05-01T12:00:00+0800</End>
            </TimeInterval>
            <WorkflowIds>w7476ff3564ee45b7b490d64bccaba6cc</WorkflowIds>  
        </Operation>
    </JobsDetail>
</Response>

Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback