tencent cloud

Feedback

Querying Content Recognition Job

Last updated: 2024-02-27 15:52:06

    Feature Description

    This API is used to query a specified job.
    

    Request

    Sample request

    GET /ai_jobs/<jobId> HTTP/1.1
    Host: <BucketName-APPID>.ci.<Region>.myqcloud.com
    Date: <GMT Date>
    Authorization: <Auth String>
    
    Note:
    Authorization: Auth String (See Request Signature for details.)
    When this feature is used by a sub-account, relevant permissions must be granted as instructed in Authorization Granularity Details.

    Request headers

    This API only uses Common Request Headers.

    Request body

    This request does not have a request body.

    Response

    Response headers

    This API only returns Common Response Headers.

    Response body

    The response body returns application/xml data. The following contains all the nodes:
    <Response>
    <JobsDetail>
    </JobsDetail>
    <NonExistJobIds></NonExistJobIds>
    </Response>
    The nodes are described as follows:
    Node Name (Keyword)
    Parent Node
    Description
    Type
    Response
    None
    Response container
    Container
    Response has the following sub-nodes:
    Node Name (Keyword)
    Parent Node
    Description
    Type
    JobsDetail
    Response
    Job details
    Container
    NonExistJobIds
    Response
    List of non-existing job IDs queried. If all jobs exist, this node is not returned.
    String
    The content of JobsDetail varies by job type. For more information, see the following documents:

    Error codes

    No special error message will be returned for this request. For the common error messages, please see Error Codes.

    Examples

    Request

    GET /ai_jobs/a8d121820f5e411ec926ef19d53ba9c6f HTTP/1.1
    Accept: */*
    Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR****&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0ea057
    Host: test-1234567890.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: NjMxMDJhYTRfMThhYTk0MGFfYmU1Nl8xNTk=
    
    <Response>
    <JobsDetail>
    <Code>Success</Code>
    <Message></Message>
    <JobId>a8d121820f5e411ec926ef19d53ba9c6f</JobId>
    <State>Running</State>
    <CreationTime>2022-07-07T12:12:12+0800</CreationTime>
    <StartTime>2022-07-07T12:12:13+0800</StartTime>
    <EndTime>-</EndTime>
    <QueueId>p893bcda225bf4945a378da6662e81a89</QueueId>
    <Tag>Translation<Tag>
    <Input>
    <Object>test.txt</Object>
    <Lang>zh</Lang>
    <Type>txt</Type>
    </Input>
    <Operation>
    <Translation>
    <Lang>en</Lang>
    <Type>txt</Type>
    </Translation>
    <Output>
    <Region>ap-beijing</Region>
    <Bucket>test-123456789</Bucket>
    <Object>test-result.txt</Object>
    </Output>
    <UserData>This is my data.</UserData>
    <JobLevel>0</JobLevel>
    </Operation>
    </JobsDetail>
    </Response>