CreateC2paBucketSignTask - 创建OSS Bucket批量C2PA可信签名任务-AI 数智鉴密(AI DeepSign )-阿里云帮助中心

为OSS Bucket内指定前缀下的对象创建批量C2PA可信签名任务，在完整性验证基础上，签名证书链可通过C2PA官方信任列表验证。

接口说明

签名类型

基础签名：使用平台自有证书签名，支持内容完整性验证。
可信签名：在完整性验证基础上，签名证书链可通过 C2PA 官方信任列表验证。

本接口提供批量可信签名，可通过 GetC2paSignResult 查询任务状态和结果。如需对单张图片进行基础签名，请调用 SignUserImage。

请求说明

SourcePrefix 必须位于 ai-deepsign/ 或其子目录下，并且不能与保留输出前缀 ai-deepsign-signed/ 重叠。
当前版本支持 JPEG/JPG、PNG 和 MP4 格式文件进行可信签名，其他格式的对象将被标记为失败但不会中断整个任务。
单个任务默认最多可包含 20,000 个非目录对象，每个对象大小限制在 800 MiB 以内。
服务会自动递归扫描指定前缀下的所有非目录对象，无需设置目录分隔符。
创建任务时仅验证权限及统计对象数量，实际处理还需确保读取源对象以及向目标位置写入数据的权限。
推荐为关联角色配置特定 OSS 权限以保证流程顺利执行。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
BucketRegionId	string	是	用户 OSS Bucket 所在地域，必须与 Bucket 的实际地域一致	cn-hangzhou
BucketName	string	是	用户 OSS Bucket 名称。需提前授权服务关联角色 AliyunServiceRoleForAIDeepSign 访问	example-bucket
SourcePrefix	string	是	源对象前缀。必须为 ai-deepsign/或其子目录，服务将递归处理其中扩展名为.jpg、.jpeg、.png 或.mp4 的对象	ai-deepsign/images/
SourceType	string	否	可选的内容来源类型，当前版本暂不支持	digitalCapture
SoftwareAgent	string	否	可选的生成内容软件名称，当前版本暂不支持	Adobe Photoshop 25.0

返回参数

名称	类型	描述	示例值
	object	创建任务返回结果
RequestId	string	请求 ID	01A03DCE-4091-1A91-9810-692C3D783877
TaskId	string	Bucket 批量签名任务 ID，可用于查询、暂停、恢复或终止任务	047b8305-9572-4eed-b7fb-8588b989b6e5
Success	boolean	请求是否成功	true
Message	string	返回信息	success
HttpStatusCode	integer	HTTP 状态码	200
Code	string	返回码	OK

示例

正常返回示例

JSON格式

{
  "RequestId": "01A03DCE-4091-1A91-9810-692C3D783877",
  "TaskId": "047b8305-9572-4eed-b7fb-8588b989b6e5",
  "Success": true,
  "Message": "success",
  "HttpStatusCode": 200,
  "Code": "OK"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。