History
Introduction
API Category
Making API Requests
Region APIs
Instance APIs
Cloud Hosting Cluster APIs
Image APIs
Instance Launch Template APIs
Placement Group APIs
Key APIs
Security Group APIs
Network APIs
Data Types
Error Codes
ci:CreateMediaJobs 权限。cam:passrole 权限。异步处理接口会通过 CAM 的“角色”进行 COS 的资源读写操作,PassRole 权限用于传递角色, 具体请查看 访问管理 > 写操作 > PassRole 接口。POST /jobs HTTP/1.1Host: <BucketName-APPID>.ci.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>Content-Length: <length>Content-Type: application/xml<body>
<Request><Tag>ImageInspect</Tag><Input><Object>input/test.png</Object></Input><Operation><UserData>This is my data.</UserData><JobLevel>0</JobLevel></Operation><CallBack>http://callback.demo.com</CallBack><CallBackFormat>JSON</CallBackFormat></Request>
节点名称(关键字) | 父节点 | 描述 | 类型 | 是否必选 |
Request | 无 | 保存请求的容器 | Container | 是 |
节点名称(关键字) | 父节点 | 描述 | 类型 | 是否必选 |
Tag | Request | 创建任务的 Tag:ImageInspect | String | 是 |
Input | Request | 待操作的文件信息 | Container | 是 |
Operation | Request | 操作规则 | Container | 否 |
CallBackFormat | Request | 任务回调格式,JSON 或 XML,默认 XML,优先级高于队列的回调格式 | String | 否 |
CallBackType | Request | 任务回调类型,Url 或 TDMQ,默认 Url,优先级高于队列的回调类型 | String | 否 |
CallBack | Request | 任务回调地址,优先级高于队列的回调地址。设置为 no 时,表示队列的回调地址不产生回调 | String | 否 |
CallBackMqConfig | Request | Container | 否 |
节点名称(关键字) | 父节点 | 描述 | 类型 | 是否必选 |
UserData | Request.Operation | 透传用户信息,可打印的 ASCII 码,长度不超过1024 | String | 否 |
JobLevel | Request.Operation | 任务优先级,级别限制:0 、1 、2 。级别越大任务优先级越高,默认为0 | String | 否 |
ImageInspect | Request.Operation | 该任务的参数 | Container | 否 |
节点名称(关键字) | 父节点 | 描述 | 类型 | 是否必选 |
AutoProcess | Request.Operation.ImageInspect | 是否开启识别到图片异常后自动对图片进行如移动到其他目录、设置为私有权限、删除等动作。取值:true/false,默认为false | String | 否 |
ProcessType | Request.Operation.ImageInspect | 指定检测到异常图片后的处理动作 BackupObject:将图片移动 abnormal_images_backup下,该目录由后台自动创建 SwitchObjectToPrivate:将图片权限设置为私有 DeleteObject:删除图片 默认值:BackupObject 当 AutoProcess 为 true 时,该参数生效 | String | 否 |
节点名称(关键字) | 父节点 | 描述 | 类型 | 是否必选 |
Object | Request.Input | 文件路径 | String | 是 |
<Response><JobsDetail><Code>Success</Code><Message/><JobId>cda071f3af9e011ed8f900133752da9af</JobId><State>Submitted</State><CreationTime>2022-06-27T15:23:10+0800</CreationTime><StartTime>-</StartTime><EndTime>-</EndTime><QueueId>p3a3b198088e74b76b31d553a77b656be</QueueId><Tag>ImageInspect</Tag><Input><BucketId>test-123456789</BucketId><Object>input/test.png</Object><Region>ap-chongqing</Region></Input><Operation><UserData>This is my data.</UserData><JobLevel>0</JobLevel></Operation></JobsDetail></Response>
节点名称(关键字) | 父节点 | 描述 | 类型 |
Response | 无 | 保存结果的容器 | Container |
节点名称(关键字) | 父节点 | 描述 | 类型 |
JobsDetail | Response | 任务的详细信息 | Container 数组 |
节点名称(关键字) | 父节点 | 描述 | 类型 |
Code | Response.JobsDetail | 错误码,当 State 为 Failed 时生效 | String |
Message | Response.JobsDetail | 错误描述,当 State 为 Failed 时生效 | String |
JobId | Response.JobsDetail | 新创建任务的 ID | String |
Tag | Response.JobsDetail | 新创建任务的 Tag:ImageInspect | String |
State | Response.JobsDetail | 任务状态 Submitted:已提交,待执行 Running:执行中 Success:执行成功 Failed:执行失败 Pause:任务暂停,当暂停队列时,待执行的任务会变为暂停状态 Cancel:任务被取消执行 | String |
CreationTime | Response.JobsDetail | 任务的创建时间 | String |
StartTime | Response.JobsDetail | 任务的开始时间 | String |
EndTime | Response.JobsDetail | 任务的结束时间 | String |
QueueId | Response.JobsDetail | String | |
Input | Response.JobsDetail | 该任务的输入资源地址 | Container |
Operation | Response.JobsDetail | 该任务的规则 | Container |
节点名称(关键字) | 父节点 | 描述 | 类型 |
Region | Response.JobsDetail.Input | 存储桶的地域 | String |
BucketId | Response.JobsDetail.Input | 源文件所在的存储桶 | String |
Object | Response.JobsDetail.Input | 源文件的文件名 | String |
节点名称(关键字) | 父节点 | 描述 | 类型 |
UserData | Response.JobsDetail.Operation | 透传用户信息 | String |
JobLevel | Response.JobsDetail.Operation | 任务优先级 | String |
ImageInspect | Response.JobsDetail.Operation | Container | |
ImageInspectResult | Response.JobsDetail.Operation | 异常图片检测结果,任务未完成时不返回 | Container |
节点名称(关键字) | 父节点 | 描述 | 类型 |
State | Response.JobsDetail.Operation.ImageInspectResult | 当前节点的任务状态,为 Success、Failed 其中一个 | String |
Code | Response.JobsDetail.Operation.ImageInspectResult | 错误码,只有 State 为 Failed 时有意义 | String |
Message | Response.JobsDetail.Operation.ImageInspectResult | 错误描述,只有 State 为 Failed 时有意义 | String |
InputObjectName | Response.JobsDetail.Operation.ImageInspectResult | 当前节点的输入对象名 | String |
InputObjectUrl | Response.JobsDetail.Operation.ImageInspectResult | 当前节点的输入对象 Url | String |
ProcessResult | Response.JobsDetail.Operation.ImageInspectResult | 当前节点的处理结果详情 | Container |
节点名称(关键字) | 父节点 | 描述 | 类型 |
PicSize | Response.JobsDetail.Operation.ImageInspectResult.ProcessResult | 检测的原图大小,单位为Bytes | Int |
PicType | Response.JobsDetail.Operation.ImageInspectResult.ProcessResult | 检测的原图类型。例如 jpg、png 等 | String |
Suspicious | Response.JobsDetail.Operation.ImageInspectResult.ProcessResult | 是否检测到图片格式以外的文件。false 为正常图片文件,true 表示含有其他格式的可疑文件 | String |
SuspiciousBeginByte | Response.JobsDetail.Operation.ImageInspectResult.ProcessResult | 检测到的可疑文件的起始字节位置,单位为Bytes | Int |
SuspiciousEndByte | Response.JobsDetail.Operation.ImageInspectResult.ProcessResult | 检测到的可疑文件的末尾字节位置,单位为Bytes | Int |
SuspiciousSize | Response.JobsDetail.Operation.ImageInspectResult.ProcessResult | 检测到的可疑文件的大小 | Int |
SuspiciousType | Response.JobsDetail.Operation.ImageInspectResult.ProcessResult | 检测到的可疑文件的类型,例如 MPEG-TS | String |
AutoProcessResult | Response.JobsDetail.Operation.ImageInspectResult.ProcessResult | 检测到为可疑文件后的图片自动处理结果 | Container |
节点名称(关键字) | 父节点 | 描述 | 类型 |
Code | Response.JobsDetail.Operation.ImageInspectResult.ProcessResult.AutoProcessResult | 自动处理结果的错误码,为 Success、Failed 其中一个 | String |
Message | Response.JobsDetail.Operation.ImageInspectResult.ProcessResult.AutoProcessResult | 自动处理结果的错误信息,当 State 为 Failed 时有效 | String |
POST /jobs HTTP/1.1Authorization: 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.comContent-Length: 166Content-Type: application/xml<Request><Tag>ImageInspect</Tag><Input><Object>input/test.png</Object></Input><Operation><UserData>This is my data.</UserData><JobLevel>0</JobLevel></Operation><CallBack>http://callback.demo.com</CallBack><CallBackFormat>JSON</CallBackFormat></Request>
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 230Connection: keep-aliveDate: Mon, 28 Jun 2022 15:23:12 GMTServer: tencent-cix-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****<Response><JobsDetail><Code>Success</Code><Message/><JobId>cda071f3af9e011ed8f900133752da9af</JobId><State>Submitted</State><CreationTime>2022-06-27T15:23:10+0800</CreationTime><StartTime>-</StartTime><EndTime>-</EndTime><QueueId>p2242ab62c7c94486915508540933a2c6</QueueId><Tag>ImageInspect</Tag><Input><BucketId>test-123456789</BucketId><Object>input/test.png</Object><Region>ap-chongqing</Region></Input><Operation><UserData>This is my data.</UserData><JobLevel>0</JobLevel></Operation></JobsDetail></Response>
文档反馈