閱讀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-阿裏雲