ASTRO轻应用 ASTROZERO-分段上传:终止(即取消)分段上传任务

时间:2024-10-18 10:59:27

终止(即取消)分段上传任务

  • 功能描述

    分段上传任务可以被取消,当一个分段上传任务被取消后,就不能再使用其“uploadId”做任何操作,已经上传段也会被删除。

    采用分段上传方式上传文件过程中或上传文件失败后会在桶内产生段,这些段会占用存储空间,可以通过取消该分段上传任务来清理掉不需要的段,节约存储空间。

  • URI

    POST AstroZero 域名 /u-route/baas/sys/v1.1/connectors/{connector_type}/{connector_name}/abortupload?object=X&uploadId=Y

    表9 路径参数

    参数

    是否必选

    参数类型

    描述

    connector_type

    String

    参数解释

    连接器的类型。

    约束限制

    不涉及。

    取值范围

    • obs:与OBS对接的连接器。
    • minio:与MINIO对接的连接器。
    • objectstorageproxy:对象存储代理类型。

    默认取值

    不涉及。

    connector_name

    String

    参数解释

    连接器实例的名称,即创建连接器时命名的连接器实例名称。

    约束限制

    不涉及。

    取值范围

    不涉及。

    默认取值

    不涉及。

    object

    String

    参数解释

    上传文件到桶里的全路径,包含文件名、文件类型、上传到桶里的路径。不携带路径时,表示上传到桶的根目录下。

    示例:取值为“a/b/c/test.mp4”,表示将文件“test.mp4”上传到桶的“a/b/c”路径下。如果桶中不存在该路径,会创建该路径。

    约束限制

    不涉及。

    取值范围

    不涉及。

    默认取值

    不涉及。

    uploadId

    String

    参数解释

    整个分段上传任务的标识,请从初始化分段上传任务的返回结果中获取该值。

    约束限制

    不涉及。

    取值范围

    不涉及。

    默认取值

    不涉及。

  • 请求参数

  • 响应参数
    表10 响应参数说明

    参数

    参数类型

    描述

    resCode

    String

    参数解释

    返回码。

    取值范围

    如果返回“0”代表请求成功,其他错误码说明请参考错误码

    resMsg

    String

    参数解释

    返回消息。

    取值范围

    如果成功状态,通常会返回“Success”,其他情况会返回具体的错误信息。

  • 请求示例

    已创建好OBS类型连接器,连接器实例名称为“命名空间__TestOBS”,需要向该OBS桶的“a/b/c”路径下上传大文件。已有初始化分段上传任务和分段上传任务,标识“uploadId”为“0000017B76500F0662CABA7128913936”,调用如下请求,取消该分段上传任务。

    POST https://AstroZero域名/u-route/baas/sys/v1.1/connectors/obs/命名空间__TestOBS/abortupload?object=a/b/c/test3.mp4&uploadId=0000017B76500F0662CABA7128913936
  • 响应示例
    {
    	"resCode": "0",
    	"resMsg": "成功"
    }
support.huaweicloud.com/api-astrozero/astrozero_api_0090.html