最近更新时间：2021-12-24
使用ListObjects接口返回指定Bucket下object的列表。
目前只支持Amazon S3对应的V1版本list。
GET / HTTP/1.1 Host: examplebucket.region.unicloudsrv.com Date: GMT date Authorization: authorization string |
参数 | 描述 |
delimiter | 文件路径分割符，通常是/。 |
marker | 指定显示开始时的字符串。 |
max-keys | 指定在响应体中返回的最多的项目数量。 |
prefix | 限定响应结果列表使用的前缀，正如你在电脑中使用的文件夹一样。 |
参数 | 描述 |
Contents | 每一个对象返回的元数据。 |
CommonPrefixes | 当用户指定分隔符后，会返回他们的公共前缀。实际上，公共前缀包括的值类似于文件目录中的同一个目录下的子目录。值的数量不能超过最大数量。 |
Delimiter | 分隔符，用于分割参数。分割后便于确定公共前缀。 |
DisplayName | 对象的名称。 |
Encoding-Type | 响应中对对象名称的编码方式。 |
ETag | 使用对象MD5摘要的实体标签。仅取决于对象的内容。 |
ID | 对象拥有者的用户ID。 |
IsTruncated | 是否被截断。如果对象列表记录数超过了设定的最大值，那么将会被截断。 |
LastModified | 最后一次被改动的时间和日期。 |
Marker | 指定列举指定空间中对象的起始位置。按照字母排序方式返回结果，将从给定的 marker 开始返回列表。 |
MaxKeys | 响应体中返回的最大记录数。默认为1000。 |
Name | 用户空间的名称。 |
NextMarker | 当用户空间中对象列表记录数超过了最大值，会标记列表被截断(IsTruncated=true)，同时返回下个记录的位置信息。用户在下次list objects的时候，可以使用该值作为marker参数。 |
Owner | 用户空间拥有者信息。 |
Size | 对象的大小。 |
GET /?prefix=N&marker=Ned&max-keys=40 HTTP/1.1 Host: test.oss-cn-north-1.unicloudsrv.com Date: Wed， 01 Mar 2006 12:00:00 GMT Authorization: authorization string |
HTTP/1.1 200 OK x-amz-id-2: gyB+3jRPnrkN98ZajxHXr3u7EFM67bNgSAxexeEHndCX/7GRnfTXxReKUQF28IfP x-amz-request-id: 3B3C7C725673C630 Date: Wed， 01 Mar 2006 12:00:00 GMT Content-Type: application/xml Content-Length: 302 Connection: close < ?xml version="1.0" encoding="UTF-8"? > < ListBucketResult xmlns="http://oss-cn-north-1.unicloudsrv.com/doc/2006-03-01/" > < Name >quotes< /Name > < Prefix >N< /Prefix > < Marker >Ned< /Marker > < MaxKeys >40< /MaxKeys > < IsTruncated >false< /IsTruncated > < Contents > < Key >Nelson< /Key > < LastModified >2006-01-01T12:00:00.000Z< /LastModified > < ETag >"828ef3fdfa96f00ad9f27c383fc9ac7f"< /ETag > < Size >5< /Size > < StorageClass >STANDARD< /StorageClass > < Owner > < ID >bcaf161ca5fb16fd081034f< /ID > < DisplayName >webfile< /DisplayName > < /Owner > < /Contents > < Contents > < Key >Neo< /Key > < LastModified >2006-01-01T12:00:00.000Z< /LastModified > < ETag >"828ef3fdfa96f00ad9f27c383fc9ac7f"< /ETag > < Size >4< /Size > < StorageClass >STANDARD< /StorageClass > < Owner > < ID >bcaf1ffd86a5fb16fd081034f< /ID > < DisplayName >webfile< /DisplayName > < /Owner > < /Contents > < /ListBucketResult > |
