功能描述
本接口用于主动查询指定的文件解压任务结果。
授权说明
服务开通
使用该功能需提前开通数据万象,并绑定存储桶。详情请参见 绑定存储桶。
使用该功能需提前通过控制台或接口开通文件处理服务 。详情请参见 开通文件处理服务。
使用限制
请求
请求示例
GET /file_jobs/<jobId> HTTP/1.1Host: <BucketName-APPID>.ci.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>
说明
Authorization: Auth String(详情请参见 请求签名 文档)。
通过子账号使用时,需要授予相关的权限,详情请参见 授权粒度详情 文档。
jobId 为提交任务时返回的 JobId。
请求头
请求体
该请求无请求体。
响应
响应头
响应体
该响应体返回为 application/xml 数据,包含完整节点数据的内容展示如下:
<Response><JobsDetail><Code>Success</Code><Message/><JobId>f93984788066911ed89ed352d4d9d2084</JobId><State>Success</State><Progress>0</Progress><CreationTime>2022-07-18T15:16:43+0800</CreationTime><EndTime>-</EndTime><StartTime>-</StartTime><QueueId>p2911917386e148639319e13c285cc774</QueueId><Tag>FileUncompress</Tag><Input><BucketId>test-1234567890</BucketId><Object>input/test.zip</Object><Region>ap-chongqing</Region></Input><Operation><FileUncompressConfig><Prefix>output/</Prefix><PrefixReplaced>1</PrefixReplaced><UnCompressKey>MTIzNDU2Nzg5MA==</UnCompressKey></FileUncompressConfig><Output><Region>ap-chongqing</Region><Bucket>test-1234567890</Bucket></Output><FileUncompressResult><Region>ap-chongqing</Region><Bucket>test-1234567890</Bucket><FileCount>1</FileCount><FileList><Contents><Key>test1.jpg</Key><LastModified>2021-11-21T12:30:42+0000</LastModified><FileSize>46743</FileSize></Contents><IsTruncated>false</IsTruncated></FileList></FileUncompressResult><UserData>This is my data.</UserData></Operation></JobsDetail></Response>
具体的数据内容如下:
节点名称(关键字) | 父节点 | 描述 | 类型 |
Response | 无 | 保存结果的容器 | Container |
Container 节点 Response 的内容:
节点名称(关键字) | 父节点 | 描述 | 类型 |
JobsDetail | Response | Container 数组 | |
NonExistJobIds | Response | 查询的 ID 中不存在任务,所有任务都存在时不返回 | String 数组 |
错误码
实际案例
请求
GET /file_jobs/f93984788066911ed89ed352d4d9d2084 HTTP/1.1Accept: */*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:test-1234567890.ci.ap-chongqing.myqcloud.com
响应
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 666Connection: keep-aliveDate: Mon, 18 Jul 2022 19:37:29 GMTServer: tencent-cix-ci-request-id: NjMxMDJhYTNfMThhYTk0MGFfYmU1OV8zZjc=<Response><JobsDetail><Code>Success</Code><Message/><JobId>f93984788066911ed89ed352d4d9d2084</JobId><State>Submitted</State><Progress>0</Progress><CreationTime>2022-07-18T15:16:43+0800</CreationTime><EndTime>-</EndTime><StartTime>-</StartTime><QueueId>p2911917386e148639319e13c285cc774</QueueId><Tag>FileUncompress</Tag><Input><BucketId>test-1234567890</BucketId><Object>input/test.zip</Object><Region>ap-chongqing</Region></Input><Operation><FileUncompressConfig><Prefix>output/</Prefix><PrefixReplaced>1</PrefixReplaced></FileUncompressConfig><Output><Region>ap-chongqing</Region><Bucket>test-1234567890</Bucket></Output><UserData>This is my data.</UserData></Operation></JobsDetail></Response>