全部产品
阿里云办公

CreatePornBatchDetectJob

更新时间:2017-12-29 17:33:03

描述

提交批量鉴黄任务。

请求参数

名称 类型 是否必填 描述
Project String 项目名
Action String CreatePornBatchDetectJob
SrcUri String 源数据的存储位置,
例如 OSS 资源”oss://bucket1/object”
TgtUri String 批量鉴黄输出内容到目标位置,
例如 OSS 桶的指定前缀”oss://bucket1/imm-porn-batch-tgt/session123/“
NotifyTopicName String 异步通知的 TopicName
NotifyEndpoint String 异步反向通知的 Endpoint,图像处理状态可以通过该 Endpoint 异步通知到调用者
ExternalID String 任务的外部标签,用于区分不同的任务

返回参数

名称 类型 描述
RequestId String 用户发送的每次接口调用请求,无论成功与否,系统都会返回一个唯一识别码 RequestId 给用户
JobId String 任务 ID
TgtLoc String 输出目标文件的位置,
  • 输入参数 ExternalID 不为空,以 TgtUri/{ExternalID}-${JobdId} 为前缀,
  • 输入参数 ExternalID 为空,以 TgtUri/${JobdId} 为前缀,
便于名字空间隔离
Status String 任务状态:
  • Running
  • Finished
  • Failed
CreateTime String 任务创建时间,例如”2017-12-14 10:28:35.360268 +0800 CST”

基于TgtUri返回TgtLoc,在OSS对象存储中的命名规则

基于TgtUri参数指定的前缀和ExternalID,比如/bucket1/imm-porn-batch-tgt/session123/,那么生成的目标文件的前缀为:

/bucket1/imm-porn-batch-tgt/session123/${ExternalID}-${JodId}

重复请求处理

基于幂等性的要求, 两次相同操作以最后执行的请求为准。

如果两次执行操作的内容相同或者重复请求(内容相同,SignatureNonce 也相同),并且系统已经存在该任务,则后续的请求直接返回成功,避免消耗计算资源做相同的任务。

转换生成目标文件

生成的目标文件会持久化保存,推荐为某个桶下的 /imm-porn-batch-tgt/${name} 路径,从而便于维护管理。

您可以主动删除转换后的目标文件,如果不主动删除则会长期保留以备使用,但是会占用存储空间。如果希望自动的删除目标文件,您也可以在 imm-porn-batch-tgt 前缀下配置 OSS的生命周期,这样目标文件在到期后,会根据策略被清除。

示例

请求示例:

  1. POST https://imm.cn-hangzhou.aliyuncs.com?Action=CreatePornBatchDetectJob
  2. &Project=test
  3. &SrcUri="oss://bucket/prefix"
  4. &TgtUri="oss://bucket/imm-porn-batch-tgt/session1"

成功返回示例

  1. {
  2. "RequestId": "FF3B7D81-66AE-47E0-BF69-157DCF187514",
  3. "JobId": "23468948-33EA-28A0-CA35-452ACE867326",
  4. "TgtLoc": "oss://bucket/imm-porn-batch-tgt/session1/23468948-33EA-28A0-CA35-452ACE867326/",
  5. "Status": "Running",
  6. "CreateTime": "2017-11-14 10:28:35.360268 +0800 CST"
  7. }