All Products
Search

This Product

    Edge Security Acceleration:GetUploadTask

    Document Center

    Edge Security Acceleration:GetUploadTask

    Last Updated:Jun 25, 2026

    Queries the execution status and runtime information of a file upload task by task ID.

    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

    No authorization for this operation. If you encounter issues with this operation, contact technical support.

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    SiteId

    integer

    No

    The site ID, which can be obtained by calling the ListSites operation.

    Important This parameter is required when querying an upload task.

    123456****

    UploadId

    integer

    No

    The file upload task ID, which is assigned when you call the UploadFile operation.

    Important This parameter is required and must be a valid task ID returned by the UploadFile operation. If this parameter is not provided or the specified ID does not exist, an InvalidParameters (400) error is returned.

    159253299357****

    Response elements

    Element

    Type

    Description

    Example

    object

    The response structure.

    RequestId

    string

    The request ID.

    ET5BF670-09D5-4D0B-BEBY-D96A2A52****
    Status

    string

    The task status. Valid values:

    • init: The task is being initialized.

    • activacted: The task is activated.

    • running: The task is running.

    • success: The task succeeded.

    • partial: The task partially succeeded.

    • fail: The task failed.

    running
    Description

    string

    The error message returned if the upload task fails.

    invalid url

    Examples

    Success response

    JSON format

    {
  "RequestId": "ET5BF670-09D5-4D0B-BEBY-D96A2A52****",
  "Status": "running",
  "Description": "invalid url"
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 MissingTimeParameter The StartTime and EndTime must be both specified. Please provide both a start time and an end time.
    400 InvalidEndTime.Mismatch The specified EndTime is earlier than the StartTime. The end time you entered is earlier than the start time. Please check and try again.
    400 DomainNameOverLimit A maximum of 500 domains are supported for each request. Only 500 domain names are supported at a time. Please reduce the number of domain names to request again.
    400 InvalidTime The query time cannot exceed the last 3 days. The query time cannot exceed the last 3 days.
    400 MissingParameter.ObjectType The ObjectType parameter is required if DomainName or ObjectType is specified. Specify the ObjectType parameter.
    400 InvalidStationParameter The specified Station is invalid. The specified node parameter is invalid.
    400 TooManyRequests Too many requests.Please try again later. Requests are too frequent, please try again later.
    400 InvalidTaskId.Malformed The specified taskId is invalid. The specified task ID is invalid.
    400 InvalidParameters.InvalidUrls The specified urls are invalid. The requested URL parameter is invalid.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.