喜讯：国内、香港、海外云服务器租用特惠活动，2核/4G/10M仅需31元每月，点击抢购>>>
点击这里注册天翼云特邀VIP帐号，立即体验天翼云对象存储>>>
天翼云对象存储（经典版）I型API参考-GET Bucket (List Objects)
此操作用来返回Bucket中部分或者全部（最多1000）的Object信息。用户可以在请求元素中设置选择条件来获取Bucket中的Object的子集。
请求语法
GET / HTTP/1.1 Host: BucketName.oos-cn.ctyunapi.cn Date: date Authorization: signatureValue |
请求参数
名称 | 描述 | 是否必须 |
BucketName | 存储桶名称 类型：字符串。 | 是 |
delimiter | 分隔符，一个用来对关键字们进行分组的字符。所有的关键字都包含delimiter和prefix间的相同子串，prefix之后第一个遇到delimiter的字符串都会加到一个叫CommonPrefix的组中。如果没有特别定义prefix，所有的关键字都会被返回，但不会有CommonPrefix。delimiter 只支持”/”，不支持其他分隔符。 类型：字符串 | 否 |
marker | 分页标识。还有需要返回的用户时，上条响应结果中会返回该参数。查看未显示项时，请求参数中需要携带此参数。 类型：字符串。 取值：与上条响应中返回的结果值相同。 | 否 |
max-keys | 设置响应中最多返回的条数。如果存在超出您指定的返回项，则IsTruncated响应元素为true，表示需要再次发送请求查看未显示的项。查看未显示的项时，需要携带响应参数Marker的值。 类型：整型。 取值：1~1000，默认值为100。 | 否 |
prefix | 前缀用来限制返回的结果必须以这个前缀开始，可以通过前缀将bucket分为若干个组。 | 否 |
encoding-type | 指定响应中Delimiter、Marker、Prefix、NextMarker、Key、CommonPrefixes.Prefix的编码类型。如果Delimiter、Marker、Prefix、NextMarker、Key、CommonPrefixes.Prefix包含xml 1.0标准不支持的控制字符，可通过设置该参数对响应中的Delimiter、Marker、Prefix、NextMarker、Key、CommonPrefixes.Prefix进行编码。 类型：字符串。 取值：url，字母不区分大小写。 | 否 |
响应结果
名称 | 描述 |
ListBucketResult | 包含响应的容器。 类型：容器 子节点：Name、Prefix、Marker、MaxKeys、EncodingType、Delimiter、IsTruncated、NextMarker、Contents、CommonPrefixes |
Name | Bucket的名称。 类型：字符串 父节点：ListBucketResult |
Prefix | 关键字以特定的前缀开始。 类型：字符串 父节点：ListBucketResult |
Marker | 标记从哪个位置开始罗列出bucket中的object。 类型：字符串 父节点：ListBucketResult |
MaxKeys | 响应中最多返回的条数。 类型：字符串 父节点：ListBucketResult |
EncodingType | Delimiter、Marker、Prefix、NextMarker、Key的编码类型。 类型：字符串 父节点：ListBucketResult |
Delimiter | 分隔符。 类型：字符串 父节点：ListBucketResult |
IsTruncated | 通过是（True）或否（false）来表示返回的结果是否为所有要求的结果。 类型：Boolean 父节点：ListBucketResult |
NextMarker | 若IsTruncated返回true，用户可以将NextMarker的值设置为下次请求中的marker参数，以便获取后续对象。 类型：字符串 父节点：ListBucketResult |
Contents | 每个Object返回的元数据。 类型：容器 父节点：ListBucketResult 子节点：Key，LastModified，Etag，Size，StorageClass |
Key | 对象的关键字。 类型：字符串 父节点：Contents |
LastModified | 记录的对象最后一次被修改的日期和时间。 类型：字符串 父节点：Contents |
ETag | 通过MD5的方式计算出标签，ETag主要用来反映对象内容的信息发生了改变，并不反映元数据的变化。 类型：字符串 父节点：Contents |
Size | 记录对象object的大小。 类型：字符串 父节点：Contents |
StorageClass | 存储类型：
类型：字符串 父节点：Contents |
CommonPrefixes | 当定义delimiter之后，返回结果中会包含CommonPrefixes，CommonPrefix中包含以prefix开头，delimiter结束的字符串组合，比如prefix是note/,同时delimiter是斜杠（/），结果中的note/summer/july/lotus.jpg将返回note/summer/，其余结果将按照maxkey要求返回。 类型：容器 父节点：ListBucketResult 子节点：Prefix |
CommonPrefixes.Prefix | <
湘公网安备43019002001857号
备案号：
客服1 