CreateImageProcessTask
描述
创建一个图片处理的任务。该任务需要一个图片类型的 project,目前为 PhotoStarter / PhotoProfessional。
请求参数
名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
Project | string | 是 | Project |
Action | String | 是 | CreateImageProcessTask |
ImageUri | string | 是 | 图片 Uri OSS 地址规则为: oss://bucket/object ,其中 bucket 为和当前 Project 在同一区域的 OSS 桶名, object 为文件路径。 |
TargetList | []Target | 是 | 处理后的图片。可对同一图片做不同的处理。 |
NotifyTopicName | String | 否 | 异步通知的 TopicName |
NotifyEndpoint | String | 否 | 异步反向通知的 Endpoint,作业处理状态可以通过该 Endpoint 异步通知到调用者 |
关于 MNS 的使用方式,参考 消息服务 MNS 概述
数据类型Target
IMM 参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
Actions | []String | 否 | 需要的处理,和oss的图片处理参数统一,将每个“/”分割放在Actions数组中 |
TargetUri | String | 否 | 输出文件的OSS URI。 |
返回参数
名称 | 类型 | 描述 |
---|---|---|
RequestId | String | 用户发送的每次接口调用请求,无论成功与否,系统都会返回一个唯一识别码 RequestId 给用户 |
TaskId | String | 该任务对唯一 ID |
TaskType | String | Task 所属类型,固定值 ImageProcessTask |
示例
请求示例
POST https://imm.cn-shanghai.aliyuncs.com
?Action= CreateImageProcessTask
&Project=test
&ImageUri=oss://xxx/test/res.jpg
&TargetList=[]
成功返回示例
{
"RequestId": "10AFFE69-73BA-47C2-8A85-029AA9DA72A3",
"TaskId": "ImageProcessTask-ffcdec0c-73ba-451a-bec4-a9fe3f4cd765",
"TaskType": "ImageProcessTask"
}
订阅消息返回示例
返回参数
Parameter | Type | Comment |
---|---|---|
eventName | string | 任务类型,返回固定值 ImageProcessTask 。 |
imm.TaskId | string | 任务唯一 ID |
imm.Results | json string | 图片处理结果 |
MNS 返回的消息格式如:
{
"events": [
{
"eventName": "ImageProcessTask",
"eventSource": "acs:imm",
"eventTime": "2019-02-20T11:06:25.264Z",
"eventVersion": "1.0",
"imm": {
“Success”: “”,
“CompressDuration”: “”,
“Results”: “[{\”Success\”:\”true\”,\”TargetUri\”:\”oss://abc/p1.jpg\”,\”Reason\”:\”\”},{\”Success\”:\”true\”,\”TargetUri\”:\”oss://abc/p2.heic\”,\”Reason\”:\”\”}]”,
“JobId”: “ImageProcessTask-f8ba005b-52d7-462e-bf1b-e9a36a62170b”,
“ErrorCode”: “”,
“SourceResolution”: “340x247”,
“TaskId”: “ImageProcessTask-f8ba005b-52d7-462e-bf1b-e9a36a62170b”,
“ImageUri”: “oss://imm-test-spark-cn-shanghai/test/tt/bmp1.bmp”,
“SourceCodec”: “BMP3”
}
}
]
}
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论