阿里云-對象存儲服務OSS控制臺指南-D

1、對象存儲 OSS控制臺用戶指南OSS/控制臺用戶指南OSS/控制臺用戶指南 PAGE 29 PAGE 29控制臺用戶指南文檔概述阿里云 OSS（Object Storage Service）為您提供基于網絡的數(shù)據存取服務。通過使用 OSS，您可以通過網絡隨時存儲和調用包括文本、圖片、音頻、和視頻等在內的各種結構化或非結構化數(shù)據文件。REST APIOSSOSS OSS資源描述阿里云 OSS 快速入門資源描述阿里云 OSS 快速入門本文檔將向您介紹如何使用阿里云 OSS 管理控制臺完成入門任務。阿里云 OSS 開發(fā)人員指南本文檔為您講解阿里云 OSS 服務的核心概念、所有功能介紹與操作步驟，以及

2、如何使用 API 和SDK 的有效示例阿里云 OSS 控制臺用戶指南（本文檔）OSSOSS OSS 管理控制臺的所有操作阿里云 OSS 購買指南詳細介紹了阿里云 OSS 的價格與計量計費方式阿里云 OSS 最佳實踐詳細介紹阿里云 OSS 的各種使用場景與配置實踐阿里云 OSS API 手冊OSSREST API阿里云 OSS SDK 手冊介紹主流語言的 SDK 開發(fā)操作和參數(shù)阿里云 OSS 圖片服務手冊詳細探討了阿里云 OSS 提供的圖片處理服務的詳細內容與操作方式阿里云 OSS 遷移工具您可能需要將您本地或第三方云存儲服務上的文件同步到OSS上，阿里云為此提供了完善的遷移解決方案阿里云 OS

3、S 開發(fā)者論壇由開發(fā)人員組成的社區(qū)形式的論壇，您可以在這里討論和學習與阿里云 OSS 有關的技術問題登錄阿里云 OSS 管理控制臺使用阿里云 OSS 管理控制臺，您可以使用直觀的界面進行相應的操作。在登錄阿里云 OSS 管理控制臺之前，確保您已經注冊了阿里云賬號并完成實名認證。如果您還沒有創(chuàng)建阿里云賬號，系統(tǒng)會在您開通 OSS 時提示您 注冊賬號。操作步驟登錄阿里云官網；OSS立即開通；OSS管理控制臺，進入阿里云管理控制臺首頁，然后點擊下圖所示按鈕進入 OSS 管理控制臺界面。如果您已經 創(chuàng)建存儲空間，登錄阿里云 OSS 管理控制臺后默認打開存儲空間管理的頁面，如下圖所示。阿里云 OSS 管

4、理控制臺中包括下列各項操作：序號內容描述1Bucket 管理單擊此按鈕查看存儲空間列表，并可以進一步對存儲空間進行管理2資源監(jiān)控報表單擊此按鈕查看 OSS 基礎資源各項數(shù)據統(tǒng)計3圖片鑒黃單擊此按鈕跳轉到云盾頁面通過阿里綠網檢測您的OSS圖片4CDN 加速 OSS單擊此按鈕可對選定的存儲空間進行 CDN 加速5安全令牌快捷配置單擊此按鈕頁面將為您自動生成訪問OSS控制系統(tǒng)的配置，并創(chuàng)建一個可以生成 OSS 訪問令牌的密鑰6開發(fā)者資源單擊此按鈕查看 OSS 相關文檔、解決方案以及開發(fā)者工具等相關資源7Bucket 名稱單擊存儲空間名稱進行對應存儲桶的管理以及屬性設置8瀏覽單擊此按鈕進入存儲空間概覽

5、頁面9刪除單擊此按鈕刪除該存儲空間10設置單擊此按鈕設置該存儲空間屬性11AccessKeys單擊此按鈕進入密鑰管理頁面12資源包單擊此按鈕查看已購買的 OSS 資源包13刷新單擊此按鈕刷新當前存儲空間列表14新建 Bucket單擊此按鈕新建存儲空間管理存儲空間存儲空間概覽阿里云 OSS 中的所有文件都存儲在存儲空間中。存儲空間是您用來管理所存儲文件的單元，所有對象都必須隸屬于某個存儲空間。你可以設置存儲空間屬性來控制地域、文件的訪問控制、文件的生命周期等，這些屬性都 是作用在該存儲空間下所有的文件上的，因此用戶可以靈活創(chuàng)建不同的存儲空間來完成不同的管理功能。同一個存儲空間內部的空間是扁平的，

6、即沒有文件系統(tǒng)的目錄等概念，所有的文件都是直接隸屬于其對應的存 儲空間。但您可以使用文件夾對相關文件進行分組歸類管理。存儲空間概覽頁面包括以下內容。序號內容描述1Bucket 概覽單擊此按鈕查看該存儲空間的基本狀態(tài)介紹，包括資源使用情況，域名及基礎配置信息2Bucket 屬性單擊此按鈕查看并修改該存儲空間的屬性配置3Object 管理單擊此按鈕查看并管理該存儲空間內包含的文件和文件夾4碎片管理單擊此按鈕查看和刪除分片上傳產生的文件碎片5任務管理單擊此按鈕頁面將為您自動生成訪問OSS控制系統(tǒng)的配置，并創(chuàng)建一個可以生成 OSS 訪問令牌的密鑰6圖片處理單擊此按鈕查看通過瀏覽器上傳的文件是否上傳成功

7、7資源監(jiān)控單擊此按鈕查看 OSS 資源的瀏覽情況，請求次數(shù)等統(tǒng)計數(shù)據信息8OSS 域名查看該存儲空間的訪問域名以及自定義域名的綁定情況，可單擊對應的按鈕或鏈接綁定自定義域名9基礎配置查看該存儲空間基礎屬性配置信息，可單擊對應的按鈕或鏈接跳轉到存儲空間屬性管理頁面查看和修改屬性創(chuàng)建存儲空間在上傳任何文件到 OSS 之前，您需要首先創(chuàng)建存儲空間以用來存儲文件。存儲空間具有各種配置屬性，包括其地理區(qū)域、訪問權限以及其他元數(shù)據。操作步驟OSS單擊 Bucket Bucket，Bucket對話框將彈出。在 BucketName 框中，輸入存儲空間名稱。存儲空間的命名必須符合命名規(guī)范。所選定的存儲空間名稱

8、在阿里云 OSS 的所有現(xiàn)有存儲空間名稱中必須具有唯一性。創(chuàng)建后不支持更改存儲空間名稱。有關存儲空間命名的更多信息，請參閱阿里云 OSS 開發(fā)人員指南中的對應章節(jié)。ECSOSS，ECSOSS在 讀寫權限 框中，下拉選擇對應的權限。您可以在創(chuàng)建存儲空間后，通過設置存儲空間屬性修改對應的訪問權限。關于訪問權限的更多信息，請參閱阿里云OSS公共讀寫：任何人（包括匿名訪問）都可以對該存儲空間中的文件進行讀寫操作，所有這些操作產生的費用由該存儲空間的創(chuàng)建者承擔，請慎用該權限。公共讀：只有該存儲空間的創(chuàng)建者可以對該存儲空間內的文件進行寫操作，任何人（包括匿名訪問）可以對該存儲空間中的文件進行讀操作。私有：

9、只有該存儲空間的創(chuàng)建者可以對該存儲空間內的文件進行讀寫操作，其他人無法訪問該存儲空間內的文件。提交刪除存儲空間如果您不再需要存儲空間，請將其刪除以免進一步產生費用。刪除存儲空間之前請確保其中存儲的文件，包括 尚未完成的分片上傳文件產生的碎片文件全部清空，否則無法刪除存儲空間。如果想刪除存儲空間內部所有的 文件，推薦使用生命周期管理。操作步驟OSS鏈接。刪除該存儲空間。設置訪問權限OSSACL（Access Control List）權限控制方法，您可以在創(chuàng)建存儲空間的時候設置相應的存儲空間權限（ACL），也可以在創(chuàng)建之后修改 ACL。如果不設置 ACL，默認值為私有讀寫。OSS ACL 提供存

10、儲空間級別的權限訪問控制，存儲空間目前有三種訪問權限：公共讀寫：任何人（包括匿名訪問）都可以對該存儲空間中的文件進行讀寫操作，所有這些操作產生 的費用由該存儲空間的創(chuàng)建者承擔，請慎用該權限。公共讀：只有該存儲空間的創(chuàng)建者可以對該存儲空間內的文件進行寫操作，任何人（包括匿名訪問）可以對該存儲空間中的文件進行讀操作。私有：只有該存儲空間的創(chuàng)建者可以對該存儲空間內的文件進行讀寫操作，其他人無法訪問該存儲空 間內的文件。操作步驟OSS單擊目標存儲空間的名稱進入存儲空間管理頁面。單擊 Bucket 屬性 讀寫權限（ACL）設置?？蛑?，下拉選擇該存儲空間的讀寫權限。保存對存儲空間讀寫權限的修改。靜態(tài)網站托

11、管您可以通過使用控制臺將自己的存儲空間配置成靜態(tài)網站托管模式，并通過存儲空間域名訪問該靜態(tài)網站。如果默認頁面為空，則表示不啟用靜態(tài)網頁托管。CNAME直接訪問靜態(tài)網站根域名或者該域名下任何一個以/URL其他詳細信息可以參考產品文檔中 靜態(tài)網頁托管。操作步驟OSS單擊目標存儲空間的名稱進入存儲空間管理頁面。單擊 Bucket Website。默認首頁 框中用來設置索引頁面（相當于網站的index.html），僅支持使用當前存儲空間內已存儲html404404html 格式以及圖片的文件，如果為空則不啟用默認 404 頁設置。保存靜態(tài)網頁信息。日志設置您可以利用管理控制臺為存儲空間啟用和禁用日志記

12、錄。您可以在已啟用日志記錄的同一存儲空間中存儲日志，也可以另外創(chuàng)建新存儲空間來存儲日志。有關存儲桶日志記錄格式等詳細信息，請參閱阿里云對象存儲 OSS 開發(fā)人員指南中的對應章節(jié)。操作步驟OSS單擊目標存儲空間的名稱進入存儲空間管理頁面。單擊 Bucket Logging。在 日志存儲位置 框中，下拉選擇選擇存儲日志記錄的存儲空間名稱，只能選擇同一用戶下同一數(shù)據中心的存儲空間。選擇 不存儲 則直接禁用日志記錄功能。保存日志設置信息。日志記錄命名規(guī)則存儲訪問日志記錄的對象命名規(guī)則示例如下: -YYYY-MM-DD-HH-MM-SS-：用戶指定的日志前綴：源存儲空間名稱該日志創(chuàng)建時的北京時間，顯示內

13、容為年-月-日-小時-分-秒，字母 位數(shù)與最終呈現(xiàn)數(shù)字位數(shù)一致：OSS 系統(tǒng)生成的字符串例如一個實際用于存儲 OSS 訪問日志的對象名稱如下： MyLog-OSS-example-2015-09-10-04-00-00-0000 其中，MyLog- 為用戶指定的日志前綴，oss-example 是源存儲空間的名稱，2015-09-10-04-00-00 是該日志被創(chuàng)建時的北京時間，0000 是 OSS 系統(tǒng)生成的字符串。防盜鏈設置OSS 是按使用量收費的服務，為了減少您存儲于 OSS 的數(shù)據被其他人盜鏈而產生額外費用，OSS 支持設置基HTTPheaderrefererrefererrefer

14、er操作步驟OSS單擊目標存儲空間的名稱進入存儲空間管理頁面。單擊 Bucket 屬性 防盜鏈設置。添加白名單網址并設置是否允許其為空。保存對防盜鏈的設置。舉例對于一個名為 test-1-001 的存儲空間，設置其 referer 白名單為 HYPERLINK / 。則只有 referer 為 HYPERLINK / 的請求才能訪問 oss-example 這個存儲空間中的對象。域名管理您在存儲空間上傳的對象后，可獲取的對象地址包含兩個部分：OSS 域名地址（.）加對象文件名。為了避免業(yè)務中可能涉及的跨域或者安全問題，建議您采用 使用自定義域名方式訪問OSS；域名綁定成功后，為了使用域名正常訪

15、問 OSS，還需要添加 CNAME 記錄指向存儲空間對應的外網域名。您綁定的域名需在工信部備案，否則域名訪問將會受到影響。20OSStest-1-001 位于杭州節(jié)點，對象文件名稱為 test001.jpg，綁定的自定義域名為 ，則該對象訪問地址為：未綁定之前：/test001.jpg綁定成功后：/test001.jpg綁定域名操作步驟OSS單擊目標存儲空間的名稱進入存儲空間管理頁面。單擊 Bucket 屬性 域名管理。添加域名，頁面將顯示。在對話框中輸入要綁定的域名名稱。單擊 下一步。添加 CNAME 記錄 頁面將顯示。如果該域名已經被其他用戶惡意綁定，可以通過添加域名 TXT 記錄的方式驗

16、證域名所有權，來強制綁定域名，同時解除此域名與之前存儲空間的綁定關系。根據您的域名情況選擇自動添加或者手動添加方式。如果該域名屬于下面幾種情況，可以選擇系統(tǒng)幫您自動添加。CNAME該域名未在阿里云解析做解析：系統(tǒng)會自動在云解析處添加對應的 CNAME 記錄，但需要用戶將域名的 DNS 更改為阿里云解析，具體步驟，可參閱下方域名解析操作步驟。如果域名已經在其他賬號的阿里云解析處做解析，只能通過手動添加的方式添加 CNAME 記錄。完成域名綁定。驗證域名所有權操作步驟等待系統(tǒng)根據您的信息生成對應的 TXT 記錄。登陸您的域名解析商處添加對應的 TXT 記錄。驗證TXT域名解析操作步驟進入阿里云管理

17、控制臺界面。進入域名解析列表頁面。鏈接。添加解析。新添加的解析記錄會顯示在記錄最上方。記錄類型 選擇 CNAME記錄。填寫對應的存儲空間外網域名。單擊保存完成域名解析?？缬蛸Y源共享OSS 提供 HTML5 協(xié)議中的跨域資源共享 CORS 設置，幫助用戶實現(xiàn)跨域訪問。當 OSS 收到一個跨域請求（或者 OPTIONS 請求），會讀取存儲空間對應的 CORS 規(guī)則，然后進行相應的權限檢查。OSS 會依次檢查每一條規(guī)則，使用第一條匹配的規(guī)則來允許請求并返回對應的 header。如果所有規(guī)則都匹配失敗，則不附加任何CORS 相關的 header。操作步驟OSS單擊目標存儲空間的名稱進入存儲空間管理頁面

18、。單擊 Bucket 屬性 CORS 設置。單擊 添加規(guī)則，CORS 規(guī)則對話框將彈出。在對話框中配置對應的規(guī)則。每個存儲空間最多可以配置 10 條規(guī)則。來源（Allowed Origin）：指定允許的跨域請求的來源。允許多條匹配規(guī)則，以回車為間隔。每個匹配規(guī)則允許使用最多一個*通配符Method：指定允許的跨域請求方法AllowedHeader：header。允許多條匹配規(guī)則，以回車為間隔。每個匹配規(guī)則使用最多一個*通配符ExposeHeader：指定允許用戶從應用程序中訪問的響應頭（JavascriptXMLHttpRequest 對象)緩存時間：指定瀏覽器對特定資源的預?。∣PTIONS

19、）請求返回結果的緩存時間單擊 確定 保存該規(guī)則。同時也可以針對已經配置的規(guī)則進行修改或者刪除。生命周期管理您可以通過控制臺定義和管理存儲空間的生命周期配置規(guī)則。您可以為存儲桶中所有對象或對象的某個子集（通過指定關鍵詞名稱前綴）定義規(guī)則，由于配置的規(guī)則會自動應用于所有符合該規(guī)則的對象，所以您可以利 用生命周期管理進行文件的批量管理和自動碎片刪除等操作。對于規(guī)則匹配的對象，系統(tǒng)會保證在在生效日期兩日內將數(shù)據清除。應用生命周期規(guī)則而批量刪除的數(shù)據將無法恢復,請謹慎配置該規(guī)則。添加規(guī)則操作步驟OSS單擊目標存儲空間的名稱進入存儲空間管理頁面。單擊 Bucket LifeCycle。單擊 添加規(guī)則，Li

20、fecycle規(guī)則設置對話框將彈出。在對話框中配置對應的規(guī)則。狀態(tài)：指定本條規(guī)則的狀態(tài)，分別表示啟用該規(guī)則和停用該規(guī)則。策略：選擇匹配對象策略，可以選擇直接匹配到整個存儲空間，也可以按照對象名稱前綴匹配。假設您在存儲空間中存儲了圖片對象，這些對象使用 img/ 作為名稱前綴，要對這些文件進行生命周期管理，則在此鍵入 img/。刪除Object：過期日期：刪除最后修改時間為指定日期之前的所有文件。如設置時間為2012-12-21，最后修 改日期為2012-12-21之前的對象會被后端程序掃描刪除。過期天數(shù)：設置對象文件保留天數(shù)，以該文件最后修改時間的天數(shù)為起始計算，超過設定天數(shù) 302016-1

21、-1131 號被后端程序掃描刪除。刪除碎片：過期日期：刪除初始化時間為指定日期之前的所有分塊上傳事件。如設置時間為2012-12- 21，在2012-12-21之前初始化的分塊上傳事件會被后端程序掃描刪除。過期天數(shù)：設置分塊上傳事件保留天數(shù)，以該事件初始化時為起始計算，超過設定天數(shù)時即執(zhí) 302016-1-1131單擊 確定 保存設定的規(guī)則。 規(guī)則保存成功后，您可以在策略列表中查看已設置的生命周期規(guī)則，并進行相應的 編輯 或者 刪除 操作?？鐓^(qū)域復制當前跨區(qū)域同步可以支持異名存儲空間的同步，如果您擁有兩個分屬不同區(qū)域的存儲空，您可以使用控制臺配 置同步將源存儲空間的數(shù)據實時同步到目標存儲空間。

22、目前只支持北京和上海之間設置跨區(qū)域復制。操作步驟OSS單擊目標存儲空間的名稱進入存儲空間管理頁面。單擊 Bucket 屬性 跨區(qū)域復制。開啟同步，對話窗將彈出。選取目標存儲空間所在的地域及存儲空間名稱。并選擇是否要同步歷史數(shù)據。數(shù)據同步的兩個存儲空間必須分屬兩個區(qū)域，同區(qū)域的存儲空間之間不能進行數(shù)據同步。 開啟跨區(qū)域同步的兩個存儲空間都不能同時與其他任何存儲空間存在互相同步的關系。 歷史數(shù)據同步時，從源存儲空間復制的對象可能會覆蓋目標存儲空間中同名的對象，復制之前請確保數(shù)據 的一致性。3-5由于存儲空間跨區(qū)域復制采用異步復制，數(shù)據復制到目標存儲空間需要的時間取決于數(shù)據的大 小，通常幾分鐘到幾小

23、時不等。管理回源規(guī)則回源設置對于獲取數(shù)據的請求實現(xiàn)了以多種方式進行回源讀取的回應，滿足用戶對于數(shù)據熱遷移、特定請求的 重定向等需求。主要分為鏡像方式和重定向的方式。您可以最多配置 5 條回源規(guī)則，系統(tǒng)將按規(guī)則順序依次執(zhí)行。操作步驟OSS單擊目標存儲空間的名稱進入存儲空間管理頁面。單擊 Bucket 屬性 回源設置。添加規(guī)則，回源規(guī)則設置對話框將彈出。配置對應的規(guī)則。單擊 確定 保存設定的規(guī)則。 規(guī)則保存成功后，您可以在策略列表中查看已設置的回源規(guī)則，并進行編輯或者刪除的操作。管理文件文件概覽在OSS服務中，用戶操作的基本數(shù)據單元是 object（對象），單個對象的大小限制為48.8TB，一個存

24、儲空間中可以有無限量的對象。您在特定的地域中創(chuàng)建存儲空間后，上傳到該存儲空間的對象將一直留在該地域，除非您特意將其傳輸?shù)搅硪?地域。在某個阿里云 OSS 地域存儲的對象會以物理的形式保留在該地域。阿里云 OSS 不會保留副本或將其移動到其他任何地域。但是，只要您具有必要的權限，就可以從任何地方訪問這些對象。您必須先擁有存儲空間寫入權限，才能將對象文件上傳到阿里云 OSS 中。上傳的對象在控制臺上對用戶展現(xiàn)形式為文件或文件夾，如下圖所示。本部分內容將向您介紹如何使用控制臺創(chuàng)建、管理和刪除文件及文件夾。上傳文件OSS500 MB500 MB，SDKAPIOSS操作步驟OSS單擊您要向其中上傳文件的

25、存儲空間名稱，打開該存儲空間管理頁面。單擊 Object 管理，進入該存儲空間內所有文件管理頁面。上傳文件，打開文件選擇對話框。打開按鈕可查看已上傳的文件。新建文件夾OSSOSS0 并以/結尾的對象用于同類文件的歸類操作和批處理，同時控制臺默認將以/結尾的對象作為文件夾形式展現(xiàn)。該對象同樣可以上傳及下載。用戶可以在 OSS 控制臺中，采用同 Windows 文件夾的OSS注意：對于任何一個以/結尾的對象，不論該對象是否存有數(shù)據，在控制臺中都是以文件夾的方式顯示，用戶只能通過 API 或 SDK 的方式來下載該對象。 對模擬文件夾具體的實現(xiàn)與操作可以參考：API：GetBucketSDK：Jav

26、aSDK-Object中文件夾模擬功能操作步驟OSS單擊目標存儲空間名稱，打開該存儲空間管理頁面。單擊 Object 管理，進入該存儲空間內所有文件管理頁面。新建文件夾對話框?？蛑墟I入該文件夾名稱。保存已創(chuàng)建的文件夾。搜索文件本部分介紹如何使用阿里云 OSS 管理控制臺在存儲空間或文件夾中搜索具有相同的名稱前綴的對象。按名稱前綴進行搜索時，搜索字符串將區(qū)分大小寫，并且不能包含正斜杠/字符。搜索的范圍限定為當前存儲 空間的根級別或當前文件夾中的對象（不包括子文件夾及其所包含的對象）。有關阿里云 OSS 如何使用正斜杠/字符的信息，請參閱有關文件夾的相關說明。操作步驟OSS單擊要搜索的存儲空間名稱

27、，打開該存儲空間管理頁面。單擊 Object 管理，進入該存儲空間內所有文件管理頁面。aliyun按鈕開始搜索。系統(tǒng)將列出存儲在存儲空間的根目錄級別且前綴為 aliyun 的對象和文件夾的名稱。如果要在某個文件夾中進行搜索，打開該文件夾后，在搜索框中鍵入要搜索的前綴內容進行搜索。系統(tǒng)將列出存儲在該 文件夾的根級別且前綴為搜索內容的對象和文件夾的名稱。獲取文件訪問地址您已經將文件上傳到存儲空間中，現(xiàn)在您可以通過獲取已上傳文件的地址進行文件的分享和下載。操作步驟OSS單擊目標文件所在的存儲空間名稱，打開存儲空間管理頁面。單擊 Object 管理，打開文件管理頁面。URL注意：如您的存儲空間的讀寫權

28、限為 私有，則在您獲取文件訪問URL時需設置鏈接有效時間。您可單擊 獲取URL 獲取文件鏈接。URL簽名的鏈接有效時間是基于NTP計算的。您可以將此鏈接給與任何訪問者，訪問者可以在有效時間內，通過此鏈接訪問該文件。存儲空間為私有權限 URL方式生成的。復制文件鏈接給與訪問者進行瀏覽或者下載。注意：如果您的存儲空間未綁定域名，則訪問該文件鏈接默認為下載該文件，而不能直接瀏覽 該文件。設置文件HTTP頭您可以通過 OSS 控制臺單個或批量設置 HTTP 頭。使用控制臺批量設置 HTTP 頭，限制數(shù)量為 1000 個文件。API：通過CopyObjectobjectSDK：Java SDK-Obje

29、ct中 拷貝Object操作步驟OSS單擊目標文件所在的存儲空間名稱，打開存儲空間管理頁面。單擊 Object 管理，打開文件管理頁面。單擊目標文件對應的 設置 HTTP 頭 鏈接，設置 HTTP 頭 對話框將彈出。如要批量設置 HTTP 頭，您可以勾選多個文件后單擊 批量設置 HTTP 頭。輸入需要設置的相關信息。保存設置信息。刪除文件如果您不再需要存儲所上傳的文件，請將其刪除以免進一步產生費用。您可以通過 OSS 控制臺刪除單個文件或批量刪除文件。控制臺批量刪除文件，僅限制數(shù)量為 1000 個文件。如果想更靈活的選擇刪除的文件，實現(xiàn)更大批量的刪除，您可以參考下列操作。詳細內容請參閱阿里云 OSS 開發(fā)人員指南中的對應章節(jié)。API：DeleteObject和De