对象存储服务 OBS-分段上传-上传段(Go SDK):请求参数说明
请求参数说明
参数名称 |
参数类型 |
是否必选 |
描述 |
---|---|---|---|
input |
必选 |
参数解释: 上传段请求参数。详情参见UploadPartInput。 |
|
extensions |
可选 |
参数解释: 拓展配置项。通过调用拓展配置项为对应请求配置额外的拓展请求头,详情参见extensionOptions。 |
参数名称 |
参数类型 |
是否必选 |
描述 |
---|---|---|---|
Bucket |
string |
必选 |
参数解释: 桶名。 约束限制:
默认取值: 无 |
Key |
string |
必选 |
参数解释: 对象名。对象名是对象在存储桶中的唯一标识。对象名是对象在桶中的完整路径,路径中不包含桶名。 例如,您对象的访问地址为examplebucket.obs.cn-north-4.myhuaweicloud.com/folder/test.txt 中,对象名为folder/test.txt。 取值范围: 长度大于0且不超过1024的字符串。 默认取值: 无 |
PartNumber |
int |
必选 |
参数解释: 段号。 取值范围: 取值范围是[1,10000]的非负整数。 默认取值: 无 |
UploadId |
string |
必选 |
参数解释: 分段上传任务的ID。任务ID可以通过初始化分段上传任务生成。 约束限制: 取值范围: 长度为32的字符串,例如: 000001648453845DBB78F2340DD460D8。 默认取值: 无 |
ContentMD5 |
string |
可选 |
参数解释: 待上传对象数据的MD5值(经过Base64编码),提供给OBS服务端,校验数据完整性。 取值范围: 按照RFC 1864标准计算出消息体的MD5摘要字符串,即消息体128-bit MD5值经过base64编码后得到的字符串。 示例:n58IG6hfM7vqI4K0vnWpog==。 默认取值: 无 |
SseHeader |
可选 |
参数解释: 服务端加密头信息,选择SSE-C加密方式,则详见SseCHeader。 |
|
Body |
io.Reader |
可选 |
参数解释: 待上传对象的数据流。 取值范围: 0~48.8TB,单位:字节。 默认取值: 无 |
SourceFile |
string |
可选 |
参数解释: 待上传对象的源文件路径。 默认取值: 无 |
Offset |
int64 |
可选 |
参数解释: 源文件中某一分段的起始偏移大小。 取值范围: 非负整数,小于待上传对象的大小,单位:字节。 默认取值: 0 |
PartSize |
int64 |
可选 |
参数解释: 当前段的长度。 约束限制:
取值范围: 100KB~5GB,单位:字节。 默认取值: 102400字节 |
参数名称 |
参数类型 |
是否必选 |
描述 |
---|---|---|---|
Encryption |
string |
作为请求参数时必选 |
参数解释: 表示服务端加密是SSE-C方式。对象使用SSE-C加密方式。 取值范围: 可选值:AES256,即选择SSE-C方式加密对象。 默认取值: 无 |
Key |
string |
作为请求参数时必选 |
参数解释: SSE-C方式下加密使用的密钥,该密钥用于加密对象。 约束限制: 该头域由256bit的密钥经过Base64编码得到,示例:K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw= 默认取值: 无 |
KeyMD5 |
string |
作为请求参数时可选 |
参数解释: SSE-C方式下加密使用密钥的MD5值,该值用于验证密钥传输过程中是否出错。 约束限制: 由密钥值经过MD5加密再经过Base64编码后得到,示例:4XvB3tbNTN+tIEVa0/fGaQ== 默认取值: 无 |