摘要：在大量公有云用戶多樣化的應(yīng)用場景中，對(duì)象存儲(chǔ)在性能高并發(fā)可用性穩(wěn)定性等方面得到了充分的驗(yàn)證。對(duì)象存儲(chǔ)目前為用戶提供個(gè)月免費(fèi)套餐，歡迎注冊體驗(yàn)。修改權(quán)限對(duì)象存儲(chǔ)的信息文件訪問受到權(quán)限控制。

QingStor? 對(duì)象存儲(chǔ)為用戶提供可無限擴(kuò)展的通用數(shù)據(jù)存儲(chǔ)服務(wù)，具有安全可靠、簡單易用、高性能、低成本等特點(diǎn)。

在大量公有云用戶多樣化的應(yīng)用場景中，QingStor? 對(duì)象存儲(chǔ)在性能（高并發(fā)）、可用性、穩(wěn)定性等方面得到了充分的驗(yàn)證。同時(shí)，QingStor? 對(duì)象存儲(chǔ)已經(jīng)在借貸寶、泰康人壽等多套私有云生產(chǎn)環(huán)境中部署上線，承擔(dān)了重要的存儲(chǔ)引擎角色，為客戶的互聯(lián)網(wǎng)業(yè)務(wù)提供強(qiáng)大助力。

現(xiàn)在 QingCloud 用戶可以在控制臺(tái)選擇北京 3 區(qū)（PEK3），通過圖形化界面來創(chuàng)建存儲(chǔ)空間( Bucket ) 并上傳文件，同時(shí)我們推薦大家通過 API、SDK 以及命令行工具來管理和使用 QingStorTM 對(duì)象存儲(chǔ)，下文會(huì)有具體介紹。

PS：QingStorTM 對(duì)象存儲(chǔ)目前為用戶提供 12 個(gè)月免費(fèi)套餐，歡迎注冊體驗(yàn)。

用戶登錄控制臺(tái)，選擇北京 3 區(qū)，就可以在 Bucket 列表頁點(diǎn)擊“新建 Bucket”按鈕，創(chuàng)建一個(gè)新的 Bucket。

由于 Bucket 名稱是 URL 域名的一部分，因此需要遵循標(biāo)準(zhǔn) URL 域名規(guī)范：只包含字母、數(shù)字、中劃線，以字母開始，以字母或數(shù)字結(jié)尾。創(chuàng)建時(shí)請注意長度范圍是 6 - 63，另外 Bucket 是全局唯一的，如果提交已存在的名稱，則提示創(chuàng)建失敗。

注解：新建的 Bucket 是私有的，如果想公開這個(gè) Bucket 的權(quán)限，可以在創(chuàng)建后設(shè)置。

對(duì)象存儲(chǔ)的 Bucket 信息、文件訪問受到權(quán)限控制。在控制臺(tái)中可以給 Bucket 設(shè)置 3 種級(jí)別的權(quán)限：

私有： 該 Bucket 及其文件相關(guān)的所有 API 接口只能被創(chuàng)建者訪問，如果想給特定用戶賦予 API 接口訪問權(quán)限，需要?jiǎng)?chuàng)建者調(diào)用 PUT Bucket ACL 接口進(jìn)行設(shè)置。

公開只讀： 所有人都可以訪問 Bucket 及其文件相關(guān)的 GET/HEAD 等類型 API 接口。

公開讀寫： 所有人都可以訪問 Bucket 及其文件相關(guān)的所有 API 接口。

注解：如果想指定特定用戶的訪問權(quán)限，可以調(diào)用 ACL 的 POST API 來設(shè)置。

如果一個(gè) Bucket 不再需要，用戶可以刪除 Bucket。刪除 Bucket 之前，需要首先清空所有的文件和文件夾，且一經(jīng)刪除無法恢復(fù)。

文件夾是特殊的文件，它的名稱也是 API 中 URL 的一部分，因此需要遵循 URL 的 pathname 部分的命名規(guī)范。

如果文件夾上傳了文件，那么文件夾不能直接刪除。用戶需要將文件夾中的文件都刪除后，再刪除文件夾。

用戶可以在控制臺(tái)向一個(gè) Bucket 或一個(gè)文件夾上傳文件。上傳文件時(shí)可以單選或多選文件，每次選擇文件限制在 10 個(gè)。如果要上傳的文件名已經(jīng)存在，上傳列表中會(huì)提示，上傳行為仍然繼續(xù)，并覆蓋已存在的文件。

上傳中的文件顯示上傳的速度、進(jìn)度，用戶可以取消一個(gè)上傳中的文件。文件上傳完成之后，在列表中保持一段時(shí)間后消失。可以在上傳列表中右鍵刪除一個(gè)文件記錄，或者清空所有文件記錄。文件上傳的過程中，可以關(guān)閉上傳窗口，再次點(diǎn)擊上傳文件按鈕時(shí)，會(huì)打開當(dāng)前上傳的文件進(jìn)度。

注解：控制臺(tái)限制了上傳單個(gè)文件的大小，超過 1GB 的文件，建議使用 API 或 SDK 來上傳。

用戶可以在控制臺(tái)下載文件，無論文件所屬的 Bucket 是私有還是公開訪問的。如果 Bucket 公開了讀權(quán)限，用戶可以從控制臺(tái)得到文件可訪問的 URL，并將 URL 分享給其他人。如果在控制臺(tái)下載文件，完成下載后，文件保存在瀏覽器設(shè)置的下載保存目錄。用戶也可以通過 API 或 SDK 下載文件，具體辦法請點(diǎn)擊閱讀原文。

與刪除文件夾類似，刪除文件后無法恢復(fù)，因此需要謹(jǐn)慎執(zhí)行該操作。文件可以批量刪除，選擇多個(gè)文件，在更多操作中選擇刪除即可。

單個(gè)文件的復(fù)制和剪切： 右鍵點(diǎn)擊文件，選擇復(fù)制或剪切，移動(dòng)到目標(biāo) Bucket 或者文件夾下，在更多操作中選擇粘貼。

多個(gè)文件的復(fù)制和剪切： 勾選要復(fù)制或者剪切的文件，在更多操作中選擇復(fù)制或者剪切，移動(dòng)到目標(biāo) Bucket 或者文件夾下，在更多操作中選擇粘貼。

注解：暫時(shí)不支持文件夾的復(fù)制和剪切。復(fù)制操作可以執(zhí)行多次，剪切操作只能執(zhí)行一次。復(fù)制和剪切都會(huì)覆蓋目標(biāo)路徑下的同名文件。

Bucket 的監(jiān)控項(xiàng)分為 3 大類：流量、存儲(chǔ)、API，每一類的監(jiān)控內(nèi)容說明如下：

外網(wǎng)出流量：從公網(wǎng)下載 Bucket 中的文件所產(chǎn)生的流量。

外網(wǎng)進(jìn)流量：從公網(wǎng)上傳文件到 Bucket 所產(chǎn)生的流量。

Zone 內(nèi)出流量：從青云平臺(tái)與 Bucket 相同區(qū)域的資源下載 Bucket 文件所產(chǎn)生的流量。

Zone 內(nèi)進(jìn)流量：從青云平臺(tái)與 Bucket 相同區(qū)域上傳文件到 Bucket 所產(chǎn)生的流量。

存儲(chǔ)空間：Bucket 所有文件占用的存儲(chǔ)空間大小。

外網(wǎng)讀請求：從公網(wǎng)調(diào)用該 Bucket 讀相關(guān)的 API 的次數(shù)，如 HEAD/GET。

外網(wǎng)寫請求：從公網(wǎng)調(diào)用該 Bucket 寫相關(guān)的 API 的次數(shù)，如 PUT/DELETE。

Zone 內(nèi)讀請求：從青云平臺(tái)與 Bucket 相同區(qū)域調(diào)用該 Bucket 讀相關(guān)的 API 的次數(shù)。

Zone 內(nèi)寫請求：從青云平臺(tái)與 Bucket 相同區(qū)域用該 Bucket 寫相關(guān)的 API 的次數(shù)。

每類監(jiān)控項(xiàng)可分別查詢最近一天、最近一個(gè)月、最近 6 個(gè)月的監(jiān)控信息。用曲線圖來展示時(shí)間區(qū)間內(nèi)的變化值，并將監(jiān)控點(diǎn)的具體數(shù)值呈現(xiàn)在表格中。監(jiān)控項(xiàng)可以在頁面右側(cè)選擇切換。

QingStor? SDK Python 包含在 QingCloud SDK Python 之中，使用 qingcloud-sdk 前請先在控制臺(tái)申請 access key，申請后便可以自由使用了。

發(fā)起請求前首先建立連接:

>>> import qingcloud.qingstor
>>> conn = qingcloud.qingstor.connect("pek3a.qingstor.com",  "access key id", "secret access key")

上面代碼中得到的 conn 是 QSConnection 的實(shí)例，在接下來的教程中會(huì)繼續(xù)用它創(chuàng)建 Bucket 對(duì)象和初始化 multipart 上傳。

創(chuàng)建存儲(chǔ)空間, 需要指定空間名稱:

>>> bucket = conn.create_bucket("mybucket")

此時(shí)得到的 Bucket 實(shí)例將被后續(xù)用來創(chuàng)建 key 對(duì)象，用以操作存儲(chǔ)空間中的對(duì)象。

使用 Bucket 實(shí)例創(chuàng)建一個(gè) Object 對(duì)象:

>>> key = bucket.new_key("myobject")

此時(shí)得到的 key 實(shí)例代表一個(gè)對(duì)象，我們接下來將用它上傳一個(gè)文件到存儲(chǔ)空間。

>>> with open("/tmp/myfile") as f:
>>> key.send_file(f)

刪除存儲(chǔ)空間中的對(duì)象:

>>> bucket.delete_key("myobject")

QingStor? 對(duì)象存儲(chǔ)命令行工具 (Command Line Interface) 是與QingStor? 對(duì)象存儲(chǔ)服務(wù)交互的命令行接口，通過命令行可以完成和使用對(duì)象存儲(chǔ) API 一樣的操作。

注解：使用 qingcloud-cli 必需一個(gè)配置文件，配置自身的 qy_access_key_id 和 qy_secret_access_key 以及 zone 。比如：
 >>>qy_access_key_id: "QINGCLOUDACCESSKEYID" 
 >>>qy_secret_access_key: "QINGCLOUDSECRETACCESSKEYEXAMPLE"
 >>>zone: "pek3a"
配置文件默認(rèn)放在 ~/.qingcloud/config.yaml ，也可在每次執(zhí)行命令時(shí)以參數(shù) -f /path/to/config 方式來指定。

使用 QingCloud CLI 操作QingStor? 對(duì)象存儲(chǔ)非常簡單，創(chuàng)建/刪除 Bucket 可以使用：

 >>> qingcloud qs create-bucket 
 >>> qingcloud qs delete-bucket 

PS：QingStorTM 對(duì)象存儲(chǔ)目前為用戶提供 12 個(gè)月免費(fèi)套餐，歡迎大家注冊體驗(yàn)。

點(diǎn)擊鏈接創(chuàng)建你的第一個(gè) QingStor Bucket 吧。