全部产品
Search

搜索本产品

    边缘安全加速：UploadFile - 上传刷新或者预热文件

    文档中心

    边缘安全加速：UploadFile - 上传刷新或者预热文件

    更新时间：Jun 25, 2026

    上传刷新或预热文件以提高访问速度。

    接口说明

    说明

    • 文件大小最大 10MB。

    调试

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

    调试

    授权信息

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

    请求参数

    名称

    类型

    必填

    描述

    示例值
    SiteId

    integer

    是

    站点 ID，可通过调用 ListSites 接口获取。

    123456789****
    Url

    string

    是

    OSS 存储刷新或者预热文件的 URL。Url 参数接受两种格式的 URL：

    • 中转 URL（推荐），通过 ESA 控制台或 SDK 的文件传输功能自动生成。

    • OSS pre-signed HTTPS URL，需将文件上传至有权限的 OSS Bucket 后生成。isFileTransferUrl 字段标识是否使用中转 URL 模式。

    https://XXXXXX.oss-cn-hangzhou.aliyuncs.com/{prefix}_{account_uid}_{hash}
    Type

    string

    是

    刷新/预热任务类型，取值：

    • file（默认值）：文件刷新。

    • preload：文件预热。

    • directory：目录刷新。

    • ignoreParams：去参数刷新。

    枚举值：

    • file :

      文件刷新

    • ignoreparams :

      去参数刷新

    • preload :

      文件预热

    • directory :

      目录刷新

    file
    UploadTaskName

    string

    是

    上传任务名。

    purge_task_2024_11_11

    返回参数

    名称

    类型

    描述

    示例值

    object

    Schema of Response

    RequestId

    string

    请求 ID。

    3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F
    UploadId

    integer

    文件上传任务 ID，后续可通过此 ID 提交、查询任务。

    159253299357****

    示例

    正常返回示例

    JSON格式

    {
  "RequestId": "3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F",
  "UploadId": 0
}

    错误码

    HTTP status code

    错误码

    错误信息

    描述
    400 InvalidTime The query time cannot exceed the last 3 days. 查询时间不能超过最近3天。
    400 MissingParameter.ObjectType The ObjectType parameter is required if DomainName or ObjectType is specified. 请填写ObjectType参数。
    400 InvalidParameters The specified parameters are invalid. 参数非法。
    400 ExceedFileUpload The size of the uploaded file exceeds the upper limit. Select a file less than 10 MB. 您上传的文件大小超出了限制，请选择小于10MB的文件重新进行上传。
    400 TooManyRequests Too many requests.Please try again later. 请求过于频繁，请稍后重试。

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

    变更历史

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