分段上传-合并段(Python SDK)

bucketName

str

必选

参数解释：

桶名。

约束限制：

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

默认取值：

无

objectKey

str

必选

参数解释：

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

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

取值范围：

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

默认取值：

无

uploadId

str

必选

参数解释：

分段上传任务的ID，例如：000001648453845DBB78F2340DD460D8

取值范围：

长度为32的字符串。

默认取值：

无

completeMultipartUploadRequest

CompleteMultipartUploadRequest

必选

参数解释：

合并段请求参数。详见CompleteMultipartUploadRequest。

isAttachCrc64

bool

可选

参数解释：

是否根据每个段的crc64值计算整个对象的crc64值。

约束限制：

• 不支持POSIX、SFS对象。
• 需要在CompleteMultipartUploadRequest中传入每个段的crc64值与大小，并且所有段都需要在上传段时校验crc64。

取值范围：

• True表示由SDK计算整个对象的crc64并提交服务端校验。
• False不检验crc64。

默认取值：

False

extensionHeaders

dict

可选

参数解释：

接口的拓展头域。

取值范围：

参考自定义头域。

默认取值：

无

encoding_type

str

可选

参数解释：

对响应中的key进行指定类型的编码。如果key包含xml 1.0标准不支持的控制字符，可通过设置该参数对响应中的key进行编码。

取值范围：

可选值为url。

默认取值：

无，不设置则不编码。

parts

list of CompletePart

必选

参数解释：

待合并的段列表。详见CompletePart。

partNum

int

必选

参数解释：

段号。

取值范围：

[1,10000]

默认取值：

无

etag

str

必选

参数解释：

段的ETag值。分段的base64编码的128位MD5摘要。

取值范围：

长度为32的字符串。

默认取值：

无

crc64

int

或

str

或

long

可选

参数解释：

段的crc64值。根据ECMA-182标准计算得出的64位CRC。

约束限制：

不支持POSIX、SFS对象。

取值范围：

根据ECMA-182标准计算得出的64位CRC。

默认取值：

无

size

int

可选

参数解释：

段大小。

约束限制：

当传入crc64值时，该值必传。

取值范围：

100KB~5GB，单位字节。

默认取值：

无

GetResult

参数解释：

SDK公共结果对象。

status

int

参数解释：

HTTP状态码。

取值范围：

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

默认取值：

无

reason

str

参数解释：

HTTP文本描述。

默认取值：

无

errorCode

str

参数解释：

OBS服务端错误码，当status参数小于300时为空。

默认取值：

无

errorMessage

str

参数解释：

OBS服务端错误描述，当status参数小于300时为空。

默认取值：

无

requestId

str

参数解释：

OBS服务端返回的请求ID。

默认取值：

无

indicator

str

参数解释：

OBS服务端返回的错误定位码。

默认取值：

无

hostId

str

参数解释：

请求的服务端ID，当status参数小于300时为空。

默认取值：

无

resource

str

参数解释：

发生错误时相关的桶或对象，当status参数小于300时为空。

默认取值：

无

header

list

参数解释：

响应消息头列表，由多个元组构成。每个元组均包含两个元素，代表响应头的键值对。

默认取值：

无

body

object

参数解释：

操作成功后的结果数据，当status大于300时为空。该值根据调用接口的不同而不同，参见“桶相关接口”章节和“对象相关接口”章节的详细描述。

默认取值：

无

CompleteMultipartUploadResponse

参数解释：

合并段响应结果。详见CompleteMultipartUploadResponse。

etag

str

参数解释：

合并段后根据各个段的ETag值计算出的结果，是对象内容的唯一标识。

约束限制：

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

取值范围：

长度为32的字符串。

默认取值：

无1

bucket

str

参数解释：

合并段所在的桶的桶名。

约束限制：

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

默认取值：

无

key

str

参数解释：

合并段后得到的对象名。

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

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

取值范围：

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

默认取值：

无

location

str

参数解释：

合并段后得到的对象的url。

例如：https://example-Bucket.obs.regions.myhuaweicloud.com/example-Object

默认取值：

无

versionId

str

参数解释：

合并段后得到的对象版本号。

取值范围：

长度为32的字符串。

默认取值：

无

sseKms

str

参数解释：

SSE-KMS方式的算法。

取值范围：

kms，即以SSE-KMS方式加密对象。

默认取值：

无

sseKmsKey

str

参数解释：

SSE-KMS加密方式下使用的KMS主密钥的ID值。

取值范围：

有效值支持两种格式：

1. regionID:domainID(账号ID):key/key_id
2. key_id

其中：

• regionID是使用密钥所属region的ID，可在地区和终端节点页面获取；
• domainID是使用密钥所属账号的账号ID，获取方法参见如何获取账号ID和用户ID?(Python SDK)；
• key_id是从数据加密服务创建的密钥ID，获取方法请参见查看密钥。

默认取值：

• 如果用户没有提供该头域，那么默认的主密钥将会被使用。
• 如果默认主密钥不存在，将默认创建并使用。

sseC

str

参数解释：

SSE-C方式的算法。

取值范围：

AES256。

默认取值：

无

sseCKeyMd5

str

参数解释：

SSE-C方式下加密使用密钥的MD5值，该值用于验证密钥传输过程中是否出错。

约束限制：

由密钥值经过MD5加密再经过Base64编码后得到，示例：4XvB3tbNTN+tIEVa0/fGaQ==

默认取值：

无

objectUrl

str

参数解释：

合并段后得到的对象的全路径。

默认取值：

无

encoding_type

str

参数解释：

用于指定对响应中的Key进行指定类型的编码。如果Key包含xml 1.0标准不支持的控制字符，可通过设置该参数对响应中的Key进行编码。

取值范围：

可选值为url。

默认取值：

无，不设置则不编码。