Multipart Upload 操作_问答-阿里云开发者社区

初始化 Multipart Upload 任务

请求参数（InitiateMultipartUploadRequest）

变量名	类型	描述
vaultId	String	待新建任务的Vault的ID
partSize	long	分块的字节大小
description	String	Archive的描述字段

接口定义/** * 初始化Multipart上传任务同步接口 * @param initiateMultipartUploadRequest 初始化Multipart上传任务请求对象 * @return * @throws OASClientException * @throws OASServerException */ public InitiateMultipartUploadResult initiateMultipartUpload( InitiateMultipartUploadRequest initiateMultipartUploadRequest) throws OASClientException, OASServerException; /** * 初始化Multipart上传任务异步接口 * @param initiateMultipartUploadRequest 初始化Multipart上传任务请求对象 * @param handler 异步请求处理器 * @return * @throws OASClientException * @throws OASServerException */ public <T> ListenableFuture<T> initiateMultipartUploadAsync( InitiateMultipartUploadRequest initiateMultipartUploadRequest, AsyncHandler<T> handler) throws OASClientException, OASServerException;

响应结果（InitiateMultipartUploadResult）

变量名	类型	描述
location	String	成功新建的任务的URI
uploadId	String	成功新建的任务的ID

获取 Multipart Upload任务列表

请求参数（ListMultipartUploadsRequest）

变量名	类型	描述
vaultId	String	待查询的Vault的ID
limit	int	返回列表的最大长度
marker	String	列表的起始标识

接口定义/** * 获取Multipart上传任务列表同步接口 * @param listMultipartUploadsRequest 获取Multipart上传任务列表请求对象 * @return * @throws OASClientException * @throws OASServerException */ public ListMultipartUploadsResult listMultipartUploads( ListMultipartUploadsRequest listMultipartUploadsRequest) throws OASClientException, OASServerException; /** * 获取Multipart上传任务列表异步接口 * @param listMultipartUploadsRequest 获取Multipart上传任务列表请求对象 * @param handler 异步请求处理器 * @return * @throws OASClientException * @throws OASServerException */ public <T> ListenableFuture<T> listMultipartUploadsAsync( ListMultipartUploadsRequest listMultipartUploadsRequest, AsyncHandler<T> handler) throws OASClientException, OASServerException;

响应结果（ListMultipartUploadsResult）

变量名	类型	描述
marker	String	下一次列表查询的起始标识
uploadList	List<MultipartUploadDescriptor>	Mulitpart Upload的JSON描述列表

删除 Multipart Upload 任务

请求参数（CancelMultipartUploadRequest）

变量名	类型	描述
vaultId	String	待删除的任务所属Vault的ID。
uploadId	String	待删除的任务的ID。

接口定义/** * 删除Multipart上传任务同步接口 * @param cancelMultipartUploadRequest 删除Multipart上传任务请求对象 * @return * @throws OASClientException * @throws OASServerException */ public OASResult cancelMultipartUpload( CancelMultipartUploadRequest cancelMultipartUploadRequest) throws OASClientException, OASServerException; /** * 删除Multipart上传任务异步接口 * @param cancelMultipartUploadRequest 删除Multipart上传任务请求对象 * @param handler 异步请求处理器 * @return * @throws OASClientException * @throws OASServerException */ public <T> ListenableFuture<T> cancelMultipartUploadAsync( CancelMultipartUploadRequest cancelMultipartUploadRequest, AsyncHandler<T> handler) throws OASClientException, OASServerException;

响应结果（OASResult）

Part上传

请求参数（UploadPartRequest）

变量名	类型	描述
vaultId	String	待上传的任务所属Vault的ID
uploadId	String	待上传的Part所属任务的ID
file	File	待上传的文件，与stream为二选一参数，两者均设置时结果不确定
stream	InputStream	待上传的流，与file为二选一参数，两者均设置时结果不确定
range	Range	待上传的Part对应整个文件的字节范围
contentEtag	String	校验字段
treeEtag	String	哈希树校验信息

接口定义/** * 上传Part同步接口 * @param uploadPartRequest 上传Part请求对象 * @return * @throws OASClientException * @throws OASServerException */ public OASResult uploadPart(UploadPartRequest uploadPartRequest) throws OASClientException, OASServerException; /** * 上传Part异步接口 * @param uploadPartRequest 上传Part请求对象 * @param handler 异步请求处理器 * @return * @throws OASClientException * @throws OASServerException */ public <T> ListenableFuture<T> uploadPartAsync( UploadPartRequest uploadPartRequest, AsyncHandler<T> handler) throws OASClientException, OASServerException;

响应结果（OASResult）

参考OASResult结构

获取 Part 列表

请求参数（ListPartsRequest）

变量名	类型	描述
vaultId	String	待查询的任务所属Vault的ID
uploadId	String	待查询的任务的ID
limit	int	返回列表的最大长度
marker	String	列表的起始标识

接口定义/** * 获取Part列表同步接口 * @param listPartsRequest 获取Part列表请求对象 * @return * @throws OASClientException * @throws OASServerException */ public ListPartsResult listParts(ListPartsRequest listPartsRequest) throws OASClientException, OASServerException; /** * 获取Part列表异步接口 * @param listPartsRequest 获取Part列表请求对象 * @param handler 异步请求处理器 * @return * @throws OASClientException * @throws OASServerException */ public <T> ListenableFuture<T> listPartsAsync( ListPartsRequest listPartsRequest, AsyncHandler<T> handler) throws OASClientException, OASServerException;

响应结果（ListPartsResult）

变量名	类型	描述
marker	String	下一次列表查询的起始标识
descriptor	MultipartUploadDescriptor	Mulitpart Upload任务的JSON描述

Part 合并

请求参数（CompleteMultipartUploadRequest）

变量名	类型	描述
vaultId	String	待合并的任务所属Vault的ID
uploadId	String	待合并的任务的ID
size	long	文件的字节大小
treeEtag	String	哈希树校验字段

接口定义/** * Part合并同步接口 * @param completeMultipartUploadRequest Part合并请求对象 * @return * @throws OASClientException * @throws OASServerException */ public CompleteMultipartUploadResult completeMultipartUpload( CompleteMultipartUploadRequest completeMultipartUploadRequest) throws OASClientException, OASServerException; /** * Part合并异步接口 * @param completeMultipartUploadRequest Part合并请求对象 * @param handler 异步请求处理器 * @return * @throws OASClientException * @throws OASServerException */ public <T> ListenableFuture<T> completeMultipartUploadAsync( CompleteMultipartUploadRequest completeMultipartUploadRequest, AsyncHandler<T> handler) throws OASClientException, OASServerException;

响应结果

变量名

类型

描述

[tr=rgb(239, 251, 255)][td]location String成功上传的Archive的URI archiveIdString成功上传的Archive的ID

Multipart Upload 操作

相关文章

相关电子书