异步断点续传上传

request

UploadFileRequest

是

参数解释：

上传对象请求参数，详见UploadFileRequest。

completeCallback

TaskCallback

<CompleteMultipartUploadResult, UploadFileRequest>

是

参数解释：

异步上传时，用于获取上传结果和异常的回调。

bucketName

String

必选

参数解释：

桶名。

约束限制：

• 桶的名字需全局唯一，不能与已有的任何桶名称重复，包括其他用户创建的桶。
• 桶命名规则如下：
  • 3～63个字符，数字或字母开头，支持小写字母、数字、“-”、“.”。
  • 禁止使用IP地址。
  • 禁止以“-”或“.”开头及结尾。
  • 禁止两个“.”相邻（如：“my..bucket”）。
  • 禁止“.”和“-”相邻（如：“my-.bucket”和“my.-bucket”）。
• 同一用户在同一个区域多次创建同名桶不会报错，创建的桶属性以第一次请求为准。

默认取值：

无

objectKey

String

必选

参数解释：

对象名。对象名是对象在存储桶中的唯一标识。对象名是对象在桶中的完整路径，路径中不包含桶名。

例如，您对象的访问地址为examplebucket.obs.cn-north-4.myhuaweicloud.com/folder/test.txt，对象名为folder/test.txt。

取值范围：

长度大于0且不超过1024的字符串。

默认取值：

无

objectMetadata

ObjectMetadata

可选

参数解释：

对象元数据，详见ObjectMetadata。

默认取值：

无

acl

AccessControlList

可选

参数解释：

创桶时可指定桶的ACL，您可以使用预定义的ACL，也可以自定义ACL，有关访问控制列表（Access Control List，ACL）功能的详细信息可参见ACL功能介绍。

取值范围：

• 如果使用预定义ACL，则可选配置项参见ACL预定义访问策略。
• 如果选择自定义ACL，则可以根据AccessControlList参数描述，自行给参数赋值。

默认取值：

AccessControlList.REST_CANNED_PRIVATE

sseKmsHeader

SseKmsHeader

可选

参数解释：

服务端加密头信息。详见SseKmsHeader。

默认取值：

无

sseCHeader

SseCHeader

可选

参数解释：

服务端加密头信息。详见SseCHeader。

默认取值：

无

enableCheckpoint

boolean

可选

参数解释：

是否开启断点续传模式。

取值范围：

true：开启断点续传模式。

false：关闭断点续传模式。

默认取值：

false

checkpointFile

String

可选

参数解释：

断点续传过程中，会生成一个进度记录文件，文件中会记录段的上传进度和段的相关信息。checkpointFile参数为该记录文件的文件路径。

约束限制：

仅在断点续传模式下有效。

默认取值：

当该值为空时，默认为待上传的本地文件的同级目录。

uploadFile

String

必选

参数解释：

待上传文件或文件夹的完整路径，如aa/bb.txt，或aa/。

默认取值：

无

extensionPermissionMap

Map<ExtensionObjectPermissionEnum, Set<String>>

可选

参数解释：

桶ACL的授权Map，您可以为一个或多个账号授予桶权限。Map的ExtensionObjectPermissionEnum用于指定权限，Map的Set<String>用于说明该权限授予的账号ID列表，即domain_id列表。

取值范围：

• 授予权限的范围详见ExtensionObjectPermissionEnum。
• 如何获取账号ID请参见如何获取账号ID和用户ID?

默认取值：

无

progressListener

ProgressListener

可选

参数解释：

设置数据传输监听器，用于获取上传进度。详见ProgressListener。

partSize

long

可选

参数解释：

分段大小。

取值范围：

100KB~5GB，单位：字节。

默认取值：

9MB

taskNum

int

可选

参数解释：

分段上传时的最大并发数。

取值范围：

1~10000，单位：个。

默认取值：

1，即不设置则默认单任务上传。

encodeHeaders

boolean

可选

参数解释：

是否开启OBS对请求头域的自动编码。

由于HTTP编码规范限制，无法发送非ASCII码字符，SDK会在发送请求时对您头域中的中文汉字进行url编码，发送编码后数据。如您设置的值content-disposition为attachment; filename="中文.txt"，则对象元数据中存储的信息为attachment; filename="%E4%B8%AD%E6%96%87.txt"。使用浏览器访问时浏览器将会自动解码。

取值范围：

true：启用SDK编码。

false：不启用SDK编码。

默认取值：

true

needCalculateCRC64

boolean

可选

参数解释：

是否自动计算待上传数据的crc64值并提交服务端校验。

约束限制：

不支持POSIX、SFS对象。

取值范围：

true：表示由SDK计算crc64并提交服务端校验。

false：不检验crc64。

默认取值：

false

onSuccess

void

result（泛型）

成功时执行的回调，参数是请求成功的结果。

onException

void

ObsException, request（泛型）

异常时执行的回调，参数是捕获的异常和出现异常的请求。

isTaskFinished

boolean

无

判断任务是否执行完毕

waitUntilFinished

void

无

阻塞当前线程，等待异步上传任务结束

cancel

boolean

无

取消异步上传任务，返回true时执行取消成功，false说明执行失败

getResult

java.util.Optional

<CompleteMultipartUploadResult>

无

阻塞当前线程，等待异步上传任务结束，然后返回任务执行结果, 上传失败时Optional.isPresent()为false

statusCode

int

参数解释：

HTTP状态码。

取值范围：

状态码是一组从2xx（成功）到4xx或5xx（错误）的数字代码，状态码表示了请求响应的状态。

完整的状态码列表请参见状态码。

默认取值：

无

responseHeaders

Map<String, Object>

参数解释：

响应消息头列表，由多个元组构成。元组中String代表响应消息头的名称，Object代表响应消息头的值。

默认取值：

无

bucketName

String

参数解释：

桶名。

约束限制：

• 桶的名字需全局唯一，不能与已有的任何桶名称重复，包括其他用户创建的桶。
• 桶命名规则如下：
  • 3～63个字符，数字或字母开头，支持小写字母、数字、“-”、“.”。
  • 禁止使用IP地址。
  • 禁止以“-”或“.”开头及结尾。
  • 禁止两个“.”相邻（如：“my..bucket”）。
  • 禁止“.”和“-”相邻（如：“my-.bucket”和“my.-bucket”）。
• 同一用户在同一个区域多次创建同名桶不会报错，创建的桶属性以第一次请求为准。

默认取值：

无

objectKey

String

参数解释：

对象名。对象名是对象在存储桶中的唯一标识。对象名是对象在桶中的完整路径，路径中不包含桶名。

例如，您对象的访问地址为examplebucket.obs.cn-north-4.myhuaweicloud.com/folder/test.txt，对象名为folder/test.txt。

取值范围：

长度大于0且不超过1024的字符串。

默认取值：

无

etag

String

参数解释：

对象的etag值，即Base64编码的128位MD5摘要。etag是对象内容的唯一标识，可以通过该值识别对象内容是否有变化。比如上传对象时etag为A，下载对象时etag为B，则说明对象内容发生了变化。etag只反映变化的内容，而不是其元数据。上传的对象或拷贝操作创建的对象，都有唯一的etag。

约束限制：

当对象是服务端加密的对象时，etag值不是对象的MD5值。

取值范围：

长度为32的字符串。

默认取值：

无

versionId

String

参数解释：

对象的版本号。如果桶的多版本状态为开启，则会返回对象的版本号。

取值范围：

长度为32的字符串。

默认取值：

无