列举桶内多版本对象(Python SDK)

bucketName

str

必选

参数解释：

桶名。

约束限制：

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

默认取值：

无

version

Versions

可选

参数解释：

列举多版本对象的起始位置，返回的对象列表将是对象名按照字典序排序后该参数以后的所有对象。

约束限制：

该字段仅用于多版本列举。

取值范围：

参考Versions。

默认取值：

无

extensionHeaders

dict

可选

参数解释：

接口的拓展头域。

取值范围：

参考自定义头域。

默认取值：

无

prefix

str

可选

参数解释：

限定返回的对象名必须带有prefix前缀。

取值范围：

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

默认取值：

无

key_marker

str

可选

参数解释：

列举多版本对象的起始位置，返回的对象列表将是对象名按照字典序排序后该参数以后的所有对象。

约束限制：

该字段仅用于多版本列举。

取值范围：

上次请求返回体的nextKeyMarker值。

默认取值：

无

max_keys

int

或

str

可选

参数解释：

列举多版本对象的最大数目，返回的对象列表将是按照字典顺序的最多前max_keys个对象。

取值范围：

1~1000，当超出范围时，按照默认的1000进行处理。

默认取值：

1000

delimiter

str

可选

参数解释：

将对象名进行分组的分隔符。如果指定了prefix，从prefix到第一次出现delimiter间具有相同字符串的对象名会被分成一组，形成一条CommonPrefix；如果没有指定prefix，从对象名的首字符到第一次出现delimiter间具有相同字符串的对象名会被分成一组，形成一条CommonPrefix。

例如，桶中有3个对象，分别为abcd、abcde、bbcde。如果指定delimiter为d，prefix为a，abcd、abcde会被分成一组，形成一条前缀为abcd的CommonPrefix；如果只指定delimiter为d，abcd、abcde会被分成一组，形成一条前缀为abcd的CommonPrefix，而bbcde会被单独分成一组，形成一条前缀为bbcd的CommonPrefix。

对于并行文件系统，不携带此参数时默认列举是递归列举此目录下所有内容，会列举子目录。在大数据场景下（目录层级深、目录下文件多）的列举，建议设置[delimiter=/]，只列举当前目录下的内容，不列举子目录，提高列举效率。

取值范围：

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

默认取值：

无

version_id_marker

str

可选

参数解释：

与key_marker配合使用，返回的对象列表将是对象名和版本号按照字典序排序后该参数以后的所有对象。key_marker指定对象名，version_id_marker指定该对象的具体版本号，两者共同确定对象版本。

约束限制：

• 该字段只适用于多版本列举场景。
• 如果version_id_marker不是key_marker的一个版本号，则该参数无效。

取值范围：

对象的版本号，即上次请求返回体的nextVersionIdMarker值。

默认取值：

无

encoding_type

str

可选

参数解释：

对响应中的部分元素进行指定类型的编码。如果 delimiter、key_marker、prefix、nextKeyMarker 和 key 包含 xml 1.0 标准不支持的控制字符，可通过设置 encoding_type 对响应中的 delimiter、key_marker、prefix（包括 commonPrefixes 中的 Prefix）、nextKeyMarker 和 key 进行编码。

取值范围：

可选值为url。

默认取值：

无，不设置则不编码。

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

默认取值：

无

ObjectVersions

参数解释：

列举桶内多版本对象响应结果。

head

ObjectVersionHead

参数解释：

列举桶内多版本对象响应头信息。

取值范围：

参考ObjectVersionHead。

versions

list of ObjectVersion

参数解释：

桶内多版本对象列表。

取值范围：

参考ObjectVersion。

markers

list of ObjectDeleteMarker

参数解释：

桶内多版本删除标记列表。

取值范围：

参考ObjectDeleteMarker。

commonPrefixs

list of CommonPrefix

参数解释：

当请求中设置了delimiter分组字符时，返回按delimiter分组后的对象名称前缀的列表。

取值范围：

参考CommonPrefix。

encoding_type

str

参数解释：

对响应中的部分元素进行指定类型的编码。如果 delimiter、key_marker、prefix、nextKeyMarker 和 key 包含 xml 1.0 标准不支持的控制字符，可通过设置 encoding_type 对响应中的 delimiter、key_marker、prefix（包括 commonPrefixes 中的 Prefix）、nextKeyMarker 和 key 进行编码。

取值范围：

可选值为url。

默认取值：

无，不设置则不编码。

name

str

参数解释：

桶名。

约束限制：

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

默认取值：

无

location

str

参数解释：

桶所在的区域。

约束限制：

该参数定义了桶将会被创建在哪个区域，如果使用的终端节点是obs.myhuaweicloud.com，可以不携带此参数；如果使用的终端节点不是obs.myhuaweicloud.com，则必须携带此参数。

取值范围：

当前有效的OBS区域和终端节点的更多信息，请参考地区和终端节点。终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以向企业管理员获取区域和终端节点信息。

默认取值：

终端节点为obs.myhuaweicloud.com且用户未设定区域时，默认为华北-北京一（cn-north-1）。

delimiter

str

参数解释：

将对象名进行分组的分隔符。如果指定了prefix，从prefix到第一次出现delimiter间具有相同字符串的对象名会被分成一组，形成一条commonPrefix；如果没有指定prefix，从对象名的首字符到第一次出现delimiter间具有相同字符串的对象名会被分成一组，形成一条commonPrefix。

例如，桶中有3个对象，分别为abcd、abcde、bbcde。如果指定delimiter为d，prefix为a，abcd、abcde会被分成一组，形成一条前缀为abcd的commonPrefix；如果只指定delimiter为d，abcd、abcde会被分成一组，形成一条前缀为abcd的commonPrefix，而bbcde会被单独分成一组，形成一条前缀为bbcd的commonPrefix。

对于并行文件系统，不携带此参数时默认列举是递归列举此目录下所有内容，会列举子目录。在大数据场景下（目录层级深、目录下文件多）的列举，建议设置[delimiter=/]，只列举当前目录下的内容，不列举子目录，提高列举效率。

取值范围：

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

默认取值：

无

prefix

str

参数解释：

限定返回的对象名必须带有prefix前缀。

例如，假设您拥有以下对象：logs/day1、logs/day2、logs/day3和ExampleObject.jpg。如果您将logs/指定为前缀，将返回以字符串“logs/”开头的三个对象。如果您指定空的前缀且请求中没有其他过滤条件，将返回桶中的所有对象。

取值范围：

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

默认取值：

无

keyMarker

str

参数解释：

列举多版本对象的起始位置，与请求中的该参数对应。

约束限制：

仅用于多版本列举。

取值范围：

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

默认取值：

无

versionIdMarker

str

参数解释：

表示列举多版本对象的起始位置（versionId标识），与请求中的该参数对应。

约束限制：

仅用于多版本列举。

取值范围：

长度为32的字符串。

nextKeyMarker

str

参数解释：

下次列举多版本对象请求的起始位置。

取值范围：

字符串，下一次请求起始位置的对象名

nextVersionIdMarker

str

参数解释：

下次列举多版本对象请求的起始位置（versionId标识），与nextKeyMarker配合使用。

取值范围：

长度为32的字符串。

maxKeys

int

参数解释：

列举对象的最大数目，返回的对象列表将是按照字典顺序的最多前max_keys个对象。

取值范围：

1~1000，当超出范围时，按照默认的1000进行处理。

默认取值：

1000

isTruncated

bool

参数解释：

表明本次请求是否返回了全部结果。

取值范围：

• True表示没有返回全部结果。
• False表示已返回了全部结果。

encoding_type

str

参数解释：

对响应中的部分元素进行指定类型的编码。如果 delimiter、key_marker、prefix、nextKeyMarker 和 key 包含 xml 1.0 标准不支持的控制字符，可通过设置 encoding_type 对响应中的 delimiter、key_marker、prefix（包括 commonPrefixes 中的 Prefix）、nextKeyMarker 和 key 进行编码。

取值范围：

可选值为url。

默认取值：

无，不设置则不编码。

key

str

参数解释：

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

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

取值范围：

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

默认取值：

无

versionId

str

参数解释：

对象的版本号。

取值范围：

长度为32的字符串。

默认取值：

无

lastModified

str

参数解释：

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

约束限制：

日期格式为ISO8601的格式。 例如：2018-01-01T00:00:00.000Z，表示最后一次修改时间为2018-01-01T00:00:00.000Z。

默认取值：

无

etag

str

参数解释：

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

约束限制：

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

取值范围：

长度为32的字符串。

默认取值：

无

size

int

参数解释：

对象数据的长度。

取值范围：

0~48.8TB，单位：字节。

默认取值：

无

owner

Owner

参数解释：

对象的所有者。

取值范围：

参考Owner。

storageClass

str

参数解释：

对象的存储类型。

取值范围：

• 当对象存储类型是标准存储时，该值为空。
• 可选择的存储类型参见存储类型。

isLatest

bool

参数解释：

标识对象是否是最新的版本。

取值范围：

• True 代表是最新版本。
• False 代表非最新版本。

默认取值：

无

isAppendable

bool

参数解释：

对象是否可被追加上传。

默认取值：

无

key

str

参数解释：

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

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

取值范围：

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

默认取值：

无

versionId

str

参数解释：

对象的版本号。

取值范围：

长度为32的字符串。

默认取值：

无

isLatest

bool

参数解释：

标识对象是否是最新的版本。

取值范围：

• True 代表是最新版本。
• False 代表非最新版本。

默认取值：

无

lastModified

str

参数解释：

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

约束限制：

日期格式为ISO8601的格式。 例如：2018-01-01T00:00:00.000Z，表示最后一次修改时间为2018-01-01T00:00:00.000Z。

默认取值：

无

owner

Owner

参数解释：

对象的所有者。

取值范围：

参考Owner。

owner_id

str

作为请求参数时必选

参数解释：

所有者的账号ID，即domain_id。

取值范围：

如何获取账号ID请参见如何获取账号ID和用户ID?

默认取值：

无

owner_name

str

作为请求参数时可选

参数解释：

所有者的账号用户名。

取值范围：

如何获取账号用户名请参见如何获取用户名?

默认取值：

无

prefix

str

参数解释：

当请求中设置了delimiter分组字符时，返回按delimiter分组后的对象名称前缀列表。

取值范围：

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

默认取值：

无

STANDARD

标准存储

参数解释：

标准存储拥有低访问时延和较高的吞吐量，适用于有大量热点对象（平均一个月多次）或小对象（<1MB），且需要频繁访问数据的业务场景。

WARM

低频访问存储

参数解释：

低频访问存储适用于不频繁访问（平均一年少于12次）但在需要时也要求能够快速访问数据的业务场景。

COLD

归档存储

参数解释：

归档存储适用于很少访问（平均一年访问一次）数据的业务场景。

DEEP_ARCHIVE

深度归档存储（受限公测）

参数解释：

深度归档存储适用于长期不访问（平均几年访问一次）数据的业务场景。