阅读371 返回首页    go 阿里云

查看对象列表__管理文件_开发人员指南_对象存储 OSS-阿里云

查看对象列表即列出您在Bucket中上传的文件（Object），您可以通过OSS的接口调用一次性得到某一Bucket下最多1000个的Object列表。通过下面的四个参数，您可以完成多种拓展功能：

名称 作用
Delimiter 用于对Object名字进行分组的字符。所有名字包含指定的前缀且第一次出现Delimiter字符之间的Object作为一组元素: CommonPrefixes。
Marker 设定结果从Marker之后按字母排序的第一个开始返回。
MaxKeys 限定此次返回Object的最大数，如果不设定，默认为100，MaxKeys取值不能大于1000。
Prefix 限定返回的Object key必须以Prefix作为前缀。注意使用prefix查询时，返回的key中仍会包含Prefix。

文件夹模拟功能

OSS服务是没有文件夹这个概念的，所有元素都是以Object来存储。创建模拟文件夹本质上来说是创建了一个size为0的Object。对于这个Object照样可以上传下载，只是控制台会对以“/”结尾的Object以文件夹的方式展示。所以您可以使用上述方式来实现创建模拟文件夹。

您可以通过 Delimiter 和 Prefix 参数的配合模拟出文件夹功能。Delimiter 和 Prefix 的组合效果是这样的：

  • 如果把 Prefix 设为某个文件夹名，就可以罗列以此 Prefix 开头的文件，即该文件夹下递归的所有的文件和子文件夹（目录）。文件名在Contents中显示。
  • 如果再把 Delimiter 设置为 “/” 时，返回值就只罗列该文件夹下的文件和子文件夹（目录），该文件夹下的子文件名（目录）返回在 CommonPrefixes 部分，子文件夹下递归的文件和文件夹不被显示。
  1. 举个例子：
  2. 假如在OSS的Bucket：oss-sample下有如下Object：
  4. 文件D
  5. 目录A/文件C
  6. 目录A/文件D
  7. 目录A/目录B/文件B
  8. 目录A/目录B/目录C/文件A
  9. 目录A/目录C/文件A
  10. 目录A/目录D/文件B
  11. 目录B/文件A
  13. 1. 列出第一层目录和文件
  14. 根据API中请求约定，需要设置Prefix为“”，Delimiter为"/":
  15. 返回结果如下：
  16. <?xml version="1.0" encoding="UTF-8"?>
  17. <ListBucketResult>
  18.   <Name>oss-sample</Name>
  19.   <Prefix></Prefix>
  20.   <Marker></Marker>
  21.   <MaxKeys>1000</MaxKeys>
  22.   <Delimiter>/</Delimiter>
  23.   <IsTruncated>false</IsTruncated>
  24.   <Contents>
  25.     <Key>文件D</Key>
  26.     <LastModified>2015-11-06T10:07:11.000Z</LastModified>
  27.     <ETag>"8110930DA5E04B1ED5D84D6CC4DC9080"</ETag>
  28.     <Type>Normal</Type>
  29.     <Size>3340</Size>
  30.     <StorageClass>Standard</StorageClass>
  31.     <Owner>
  32.       <ID>oss</ID>
  33.       <DisplayName>oss</DisplayName>
  34.     </Owner>
  35.   </Contents>
  36.   <CommonPrefixes>
  37.     <Prefix>目录A/</Prefix>
  38.   </CommonPrefixes>
  39.   <CommonPrefixes>
  40.     <Prefix>目录B/</Prefix>
  41.   </CommonPrefixes>
  42. </ListBucketResult>
  44. 可以看到：
  45. Contents返回的是第一层的文件：“文件D”。
  46. CommonPrefixes返回的是第一层的目录：“目录A/” 和 “目录B/”，而“目录A/” 和 “目录B/”下的文件名不显示。
  48. 2. 列出第二层目录A底下的目录和文件
  49. 根据API中请求约定，需要设置Prefix为“目录A”，Delimiter为"/":
  50. 返回结果如下：
  52. <?xml version="1.0" encoding="UTF-8"?>
  53. <ListBucketResult>
  54.   <Name>oss-sample</Name>
  55.   <Prefix>目录A/</Prefix>
  56.   <Marker></Marker>
  57.   <MaxKeys>1000</MaxKeys>
  58.   <Delimiter>/</Delimiter>
  59.   <IsTruncated>false</IsTruncated>
  60.   <Contents>
  61.     <Key>目录A/文件C</Key>
  62.     <LastModified>2015-11-06T09:36:00.000Z</LastModified>
  63.     <ETag>"B026324C6904B2A9CB4B88D6D61C81D1"</ETag>
  64.     <Type>Normal</Type>
  65.     <Size>2</Size>
  66.     <StorageClass>Standard</StorageClass>
  67.     <Owner>
  68.       <ID>oss</ID>
  69.       <DisplayName>oss</DisplayName>
  70.     </Owner>
  71.   </Contents>
  72.   <Contents>
  73.     <Key>目录A/文件D</Key>
  74.     <LastModified>2015-11-06T09:36:00.000Z</LastModified>
  75.     <ETag>"B026324C6904B2A9CB4B88D6D61C81D1"</ETag>
  76.     <Type>Normal</Type>
  77.     <Size>2</Size>
  78.     <StorageClass>Standard</StorageClass>
  79.     <Owner>
  80.       <ID>oss</ID>
  81.       <DisplayName>oss</DisplayName>
  82.     </Owner>
  83.   </Contents>
  84.   <CommonPrefixes>
  85.     <Prefix>目录A/目录B/</Prefix>
  86.   </CommonPrefixes>
  87.   <CommonPrefixes>
  88.     <Prefix>目录A/目录C/</Prefix>
  89.   </CommonPrefixes>
  90.   <CommonPrefixes>
  91.     <Prefix>目录A/目录D/</Prefix>
  92.   </CommonPrefixes>
  93. </ListBucketResult>
  95. 可以看到：
  96. Contents返回的是第二层的文件：“目录A/文件C”，“目录A/文件D”。
  97. CommonPrefixes返回的是第一层的目录：“目录A/目录B/”，“目录A/目录C/”和“目录A/目录D/”。而目录下的文件名不会被显示。

功能使用参考

最后更新：2016-11-23 16:04:09

  上一篇：go 设置对象/文件元信息__管理文件_开发人员指南_对象存储 OSS-阿里云
  下一篇：go 拷贝对象__管理文件_开发人员指南_对象存储 OSS-阿里云