All Products
Search

This Product

    AI DeepSign:GetC2paSignResult

    Document Center

    AI DeepSign:GetC2paSignResult

    Last Updated:Sep 07, 2026

    Queries the status and result of a single-file or OSS Bucket batch C2PA trusted signing task.

    Operation description

    Request description

    • This operation queries the status and final result of a trusted signing task created by CreateC2paSignTask or CreateC2paBucketSignTask.

    • Supports querying both FILE and BUCKET types of trusted signing tasks. This operation does not apply to the basic signing operation SignUserImage.

    • For Bucket tasks in the PROCESSING, PAUSING, PAUSED, or CANCELING state, intermediate statistics information is not returned. Complete statistics information and report locations are provided only after the task enters the SUCCEEDED or CANCELED state.

    • The query operation itself is free and does not re-trigger the underlying signing procedure.

    • TaskId must conform to the standard UUID format (lowercase with hyphens) and is also compatible with legacy decimal format IDs.

    • If the provided TaskId format is incorrect, an InvalidParam error is returned directly without further querying the task table or certificate service.

    • Note the distinction between a successful API invocation and a successful task execution: even if the API invocation succeeds (Code=OK, Success=true), the actual task may still have failed with a specific ErrorCode.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    aideepsign:GetC2paSignResult

    get

    *All Resource

    *

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    TaskId

    string

    Yes

    The opaque task ID returned by CreateC2paSignTask, with a maximum of 64 characters.

    7093c29e-f472-4e1e-91c6-a43df7c7382e

    Response elements

    Element

    Type

    Description

    Example

    object

    The task query result.

    RequestId

    string

    The request ID of this API call.

    A1B2C3D4-E5F6-7890-ABCD-EF1234567890
    TaskId

    string

    The C2PA signing task ID.

    7093c29e-f472-4e1e-91c6-a43df7c7382e
    Status

    string

    The task status. Valid values: PROCESSING, SUCCEEDED, FAILED.

    SUCCEEDED
    SignedFileUrl

    string

    The temporary download URL of the signed file. Returned only when Status=SUCCEEDED.

    https://example.oss-cn-hangzhou.aliyuncs.com/...
    ErrorCode

    string

    The task failure error code. Returned only when Status=FAILED.

    C2PA_FORMAT_UNSUPPORTED
    ErrorMessage

    string

    The task failure error message. Returned only when Status=FAILED.

    only valid JPEG and PNG source files are supported
    TaskType

    string

    The task type: FILE or BUCKET.

    BUCKET
    TotalCount

    integer

    The total number of objects scanned by the Bucket task. Returned only when the Bucket task is in the SUCCEEDED or CANCELED state.

    3
    SucceededCount

    integer

    The number of objects successfully signed by the Bucket task. Returned only when the Bucket task is in the SUCCEEDED or CANCELED state.

    1
    FailedCount

    integer

    The number of objects that failed, were skipped, or were terminated by the Bucket task. Returned only when the Bucket task is in the SUCCEEDED or CANCELED state.

    2
    ReportObjectKey

    string

    The object key of the final standard JSON report for the Bucket task. Returned only when the Bucket task succeeds.

    ai-deepsign-signed/047b8305-9572-4eed-b7fb-8588b989b6e5/c2pa_report.json
    ReportFileUrl

    string

    The temporary download URL returned when the Bucket task enters the CANCELED state and the internal JSON report is written successfully. The report covers only objects discovered before termination.

    https://ai-deepsign-hangzhou-prod.oss-cn-hangzhou.aliyuncs.com/c2pa_bucket_reports/047b8305-9572-4eed-b7fb-8588b989b6e5/c2pa_report.json?Expires=1788000000&Signature=***
    Success

    boolean

    Indicates whether this query call is successful. This value may still be true even if the task itself fails.

    True
    Message

    string

    The additional message. Returns success when the API call succeeds.

    success
    HttpStatusCode

    integer

    The HTTP status code. Returns 200 when the API call succeeds.

    200
    Code

    string

    The business error code of this API call. Returns OK when the call succeeds.

    OK

    Examples

    Success response

    JSON format

    {
  "RequestId": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890",
  "TaskId": "7093c29e-f472-4e1e-91c6-a43df7c7382e",
  "Status": "SUCCEEDED",
  "SignedFileUrl": "https://example.oss-cn-hangzhou.aliyuncs.com/...",
  "ErrorCode": "C2PA_FORMAT_UNSUPPORTED",
  "ErrorMessage": "only valid JPEG and PNG source files are supported",
  "TaskType": "BUCKET",
  "TotalCount": 3,
  "SucceededCount": 1,
  "FailedCount": 2,
  "ReportObjectKey": "ai-deepsign-signed/047b8305-9572-4eed-b7fb-8588b989b6e5/c2pa_report.json",
  "ReportFileUrl": "https://ai-deepsign-hangzhou-prod.oss-cn-hangzhou.aliyuncs.com/c2pa_bucket_reports/047b8305-9572-4eed-b7fb-8588b989b6e5/c2pa_report.json?Expires=1788000000&Signature=***",
  "Success": true,
  "Message": "success",
  "HttpStatusCode": 200,
  "Code": "OK"
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.