tencent cloud

数据万象

动态与公告
产品动态
产品公告
产品简介
产品概述
产品优势
应用场景
功能概览
地域与域名
使用限制
产品计费
计费概述
计费方式
计费项
免费额度
欠费说明
查看消费明细
常见问题
快速入门
注册与登录
绑定存储桶
上传和处理文件
下载和删除文件
解绑存储桶
通过 COS 使用数据万象
能力地图
图片处理
媒体处理
内容审核
AI 内容识别
文档处理
智能语音
文件处理
用户指南
概览
存储桶管理
智能工具箱
任务与工作流
数据监控
用量统计
实践教程
版权保护解决方案
图片处理实践
API 授权策略使用指引
工作流实践
API 文档
API 概览
结构体
公共请求头部
公共响应头部
开通万象服务
图片处理
AI 内容识别
智能语音
媒体处理
内容审核
文档处理
文件处理
任务与工作流
云查毒
错误码
请求签名
SDK 文档
SDK 概览
图片处理 Android SDK
图片处理 iOS SDK
COS Android SDK
C SDK
C++ SDK
.NET(C#) SDK
Go SDK
COS iOS SDK
Java SDK
JavaScript SDK
Node.js SDK
PHP SDK
Python SDK
小程序 SDK
SDK 产品个人信息保护规则
安全与合规
权限管理
常见问题
基础设置
文档处理
媒体处理
内容识别
智能语音
服务协议
Service Level Agreement
联系我们
词汇表

查询指定的文档转码任务

PDF
聚焦模式
字号
最后更新时间: 2024-01-20 11:39:30

功能描述

DescribeDocProcessJob 用于查询指定的文档转码任务。

请求

注意:
文档预览任务记录保留一个月,请及时保存任务记录。建议配置回调进行任务结果查询。

请求示例

GET /doc_jobs/<jobId> HTTP/1.1
Host: <BucketName-APPID>.ci.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
说明:
Authorization: Auth String(详情请参见 请求签名 文档)。
通过子账号使用时,需要授予相关的权限,详情请参见 授权粒度详情 文档。

请求头

此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。

请求体

该请求无请求体。

响应

响应头

此接口仅返回公共响应头部,详情请参见 公共响应头部 文档。

响应体

该响应体返回为 application/xml 数据,包含完整节点数据的内容展示如下:
<Response>
<JobsDetail>
<Code></Code>
<CreationTime></CreationTime>
<EndTime></EndTime>
<Input>
<Object></Object>
</Input>
<JobId></JobId>
<Message> </Message>
<Operation>
<DocProcess>
<EndPage></EndPage>
<ImageParams></ImageParams>
<SrcType></SrcType>
<StartPage></StartPage>
<TgtType></TgtType>
</DocProcess>
<DocProcessResult>
<FailPageCount></FailPageCount>
<PageInfo>
<PageNo></PageNo>
<TgtUri></TgtUri>
</PageInfo>
<SuccPageCount></SuccPageCount>
<TaskId></TaskId>
<TgtType></TgtType/>
<TotalPageCount></TotalPageCount>
</DocProcessResult>
<Output>
<Bucket></Bucket>
<Object></Object>
<Region></Region>
</Output>
</Operation>
<QueueId></QueueId>
<State></State>
<Tag></Tag>
</JobsDetail>
</Response>
具体的数据内容如下:
节点名称(关键字)
父节点
描述
类型
Response
保存结果的容器
Container
Container 节点 Response 的内容:
节点名称(关键字)
父节点
描述
类型
JobsDetail
Response
任务的详细信息,同 CreateDocProcessJobs 接口的 Response.JobsDetail 节点
Container
NonExistJobIds
Response
查询的 ID 中不存在的任务,所有任务都存在时不返回
String
Container 节点 Operation 的内容:
节点名称(关键字)
父节点
描述
类型
DocProcess
Response.JobsDetail.Operation
文档预览任务参数,同 CreateDocProcessJobs 接口的 Request.Operation.DocProcess 节点
Container
DocProcessResult
Response.JobsDetail.Operation
在 job 的类型为 DocProcess 且 job 状态为 success 时,返回文档预览任务结果详情
Container
Output
Response.JobsDetail.Operation
结果输出地址,同 CreateDocProcessJobs 接口的 Request.Operation.Output 节点
Container
Container 节点 DocProcessResult 节点的内容
节点名称(关键字)
父节点
描述
类型
PageInfo
Response.JobsDetail.Operation.DocProcessResult
预览任务产物详情
Container
TgtType
Response.JobsDetail.Operation.DocProcessResult
预览产物目标格式
String
TotalPageCount
Response.JobsDetail.Operation.DocProcessResult
预览任务产物的总数
Int
SuccPageCount
Response.JobsDetail.Operation.DocProcessResult
预览任务产物的成功数
Int
FailPageCount
Response.JobsDetail.Operation.DocProcessResult
预览任务产物的失败数
Int
TotalSheetCount
Response.JobsDetail.Operation.DocProcessResult
预览任务的 Sheet 总数(源文件为 Excel 特有参数)
Int
Container 节点 PageInfo 节点的内容
节点名称(关键字)
父节点
描述
类型
PageNo
Response.JobsDetail.Operation.DocProcessResult.PageInfo
预览产物页码,源文件为 Excel 格式时表示 SheetId
Container
TgtUri
Response.JobsDetail.Operation.DocProcessResult.PageInfo
预览产物生成的 cos 桶路径
Int
X-SheetPics
Response.JobsDetail.Operation.DocProcessResult.PageInfo
当前 Sheet 生成的图片总数(源文件为 Excel 特有参数)
Int
PicIndex
Response.JobsDetail.Operation.DocProcessResult.PageInfo
当前预览产物在整个源文件中的序号(源文件为 Excel 特有参数)
Int
PicNum
Response.JobsDetail.Operation.DocProcessResult.PageInfo
当前预览产物在 Sheet 中的序号(源文件为 Excel 特有参数)
Int

错误码

该请求操作无特殊错误信息,常见的错误信息请参见 错误码 文档。

实际案例

请求

GET /doc_jobs/d13cfd584cd9011ea820b597ad1785a2f 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=28e9a4986df11bed0255e97ff90500557e0e****
Host: examplebucket-1250000000.ci.ap-beijing.myqcloud.com

1.非 Excel 文档请求响应

<Response>
<JobsDetail>
<Code>Success</Code>
<CreationTime>2020-07-24T17:28:47+0800</CreationTime>
<EndTime>2020-07-24T17:28:49+0800</EndTime>
<Input>
<Object>1.doc</Object>
</Input>
<JobId>d13cfd584cd9011ea820b597ad1785a2f</JobId>
<Message/>
<Operation>
<DocProcess>
<EndPage>0</EndPage>
<ImageParams/>
<SrcType/>
<StartPage>2</StartPage>
<TgtType>png</TgtType>
</DocProcess>
<DocProcessResult>
<FailPageCount>0</FailPageCount>
<PageInfo>
<PageNo>2</PageNo>
<TgtUri>big/test-1</TgtUri>
</PageInfo>
<SuccPageCount>1</SuccPageCount>
<TaskId/>
<TgtType/>
<TotalPageCount>2</TotalPageCount>
</DocProcessResult>
<Output>
<Bucket>examplebucket-1250000000</Bucket>
<Object>big/test-${Number}</Object>
<Region>ap-chongqing</Region>
</Output>
</Operation>
<QueueId>p50882922b848464fadd222d771438328</QueueId>
<State>Success</State>
<Tag>DocProcess</Tag>
</JobsDetail>
</Response>

2. Excel 格式响应

<Response>
<JobsDetail>
<Code>Success</Code>
<CreationTime>2020-12-03T19:54:10+0800</CreationTime>
<EndTime>2020-12-03T19:54:13+0800</EndTime>
<Input>
<Object>1.xlsx</Object>
</Input>
<JobId>d13cfd584cd9011ea820b597ad1785a2f</JobId>
<Message/>
<Operation>
<DocProcess>
<Comments>0</Comments>
<DocPassword/>
<EndPage>2</EndPage>
<ImageParams/>
<PaperDirection>0</PaperDirection>
<PaperSize>0</PaperSize>
<Quality>100</Quality>
<SheetId>0</SheetId>
<SrcType/>
<StartPage>1</StartPage>
<TgtType/>
<Zoom>100</Zoom>
</DocProcess>
<DocProcessResult>
<FailPageCount>0</FailPageCount>
<PageInfo>
<PageNo>1</PageNo>
<PicIndex>1</PicIndex>
<PicNum>1</PicNum>
<TgtUri>mark2/1/test-1.jpg</TgtUri>
<X-SheetPics>2</X-SheetPics>
</PageInfo>
<PageInfo>
<PageNo>1</PageNo>
<PicIndex>2</PicIndex>
<PicNum>2</PicNum>
<TgtUri>mark2/1/test-2.jpg</TgtUri>
<X-SheetPics>2</X-SheetPics>
</PageInfo>
<SuccPageCount>6</SuccPageCount>
<TaskId/>
<TgtType/>
<TotalPageCount>6</TotalPageCount>
<TotalSheetCount>3</TotalSheetCount>
</DocProcessResult>
<Output>
<Bucket>markjrzhang-1251704708</Bucket>
<Object>mark/${SheetID}/pic-${Page}.jpg</Object>
<Region>ap-chongqing</Region>
</Output>
</Operation>
<QueueId>p5fdbba9a9b83479f84538d5beb*****</QueueId>
<State>Success</State>
<Tag>DocProcess</Tag>
</JobsDetail>
</Response>


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈