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的字符串。

默认取值：

无

说明：

对象链接地址格式为：https://桶名.域名/文件夹目录层级/对象名。如果该对象存在于桶的根目录下，则链接地址将不需要有文件夹目录层级。

partNumber

int

必选

参数解释：

段号。

取值范围：

[1,10000]

默认取值：

无

uploadId

str

必选

参数解释：

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

取值范围：

长度为32的字符串。

默认取值：

无

copySource

str

必选

参数解释：

指定源桶、源对象和源对象版本号（可为空）的参数，格式：源桶名/源对象名?versionId=源对象版本号。

约束限制：

桶的名字需全局唯一，不能与已有的任何桶名称重复，包括其他用户创建的桶。
桶命名规则如下：

3～63个字符，数字或字母开头，支持小写字母、数字、“-”、“.”。
禁止使用IP地址。
禁止以“-”或“.”开头及结尾。
禁止两个“.”相邻（如：“my..bucket”）。
禁止“.”和“-”相邻（如：“my-.bucket”和“my.-bucket”）。

同一用户在同一个区域多次创建同名桶不会报错，创建的桶属性以第一次请求为准。
对象名是对象在存储桶中的唯一标识。对象名是对象在桶中的完整路径，路径中不包含桶名。

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

默认取值：

无

copySourceRange

str

可选

参数解释：

指定复制源对象的范围。例如：0-999，即对象的第1个字节到1000字节。

取值范围：

取值区间：[0，对象长度-1]，格式：x-y，即对象的第x+1字节到第y+1字节。

约束限制：

如果range的最大长度超出对象长度-1，仍旧取对象长度-1。

默认取值：

无

destSseHeader

SseCHeader

或

SseKmsHeader

可选

参数解释：

服务端加密头域，用于加密目标对象。详见SseCHeader或SseKmsHeader

sourceSseHeader

SseCHeader

可选

参数解释：

服务端解密头域，用于解密源对象。详见SseCHeader

encryption

str

必选

参数解释：

以SSE-C方式加密对象。

取值范围：

AES256，即高级加密标准（Advanced Encryption Standard，AES）。

默认取值：

无

key

str

必选

参数解释：

SSE-C方式下加密的密钥，与加密方式对应，如encryption=‘AES256’，name密钥就是由AES256加密算法得到的密钥。

取值范围：

长度为32字符串。

默认取值：

无

encryption

str

必选

参数解释：

以SSE-KMS方式加密对象。

取值范围：

可选值：kms，即选择SSE-KMS方式加密对象。

默认取值：

无

key

str

可选

参数解释：

SSE-KMS方式下加密的主密钥。

取值范围：

支持两种格式的密钥描述方式：

regionID:domainID(租户ID):key/key_id
key_id

其中：

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

默认取值：

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

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时为空。该值根据调用接口的不同而不同，参见“桶相关接口”章节和“对象相关接口”章节的详细描述。

默认取值：

无

CopyPartResponse

参数解释：

复制段响应结果。详见CopyPartResponse。

etag

str

参数解释：

段的base64编码的128位MD5摘要。ETag是段内容的唯一标识，可以通过该值识别段内容是否有变化。

取值范围：

长度为32的字符串。

默认取值：

无

lastModified

str

参数解释：

对象的最近一次修改时间。

约束限制：

日期格式为GMT的格式。 例如：Wed, 25 Mar 2020 02:39:52 GMT。

默认取值：

无

sseKms

str

参数解释：

表示服务端加密是SSE-KMS方式。对象使用SSE-KMS方式加密。

取值范围：

可选值：kms，即选择SSE-KMS方式加密对象。

默认取值：

无

sseKmsKey

str

参数解释：

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

取值范围：

有效值支持两种格式：

regionID:domainID(帐号ID):key/key_id
key_id

其中：

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

默认取值：

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

sseC

str

参数解释：

使用SSE-C方式加解密对象时，选择的加解密算法。

取值范围：

支持的值为AES256，即高级加密标准（Advanced Encryption Standard，AES）。

默认取值：

无

sseCKeyMd5

str

参数解释：

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

约束限制：

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

默认取值：

无