建立容器
本文為機器翻譯文章。如需檢視英文版,請選取 [原文] 核取方塊。您也可以將滑鼠指標移到文字上,即可在快顯視窗顯示英文原文。
譯文
原文

建立容器

 

Create Container 作業會建立新的容器,以指定的帳戶。 如果具有相同名稱的容器已存在,作業將會失敗。

容器資源包含中繼資料和該容器的屬性。 它不包含容器的 blob 清單。

Create Container 要求可能會建構,如下所示。 建議使用 HTTPS。mycontainer 值只能包含小寫字元。 取代 myaccount 的儲存體帳戶名稱:

方法

要求 URI

HTTP 版本

PUT

https://myaccount.blob.core.windows.net/mycontainer?restype=container

HTTP/1.1

對模擬儲存體服務提出之要求時,指定將模擬器主機名稱和 Blob 服務的通訊埠為 127.0.0.1:10000, ,後面接著模擬儲存體帳戶名稱:

方法

要求 URI

HTTP 版本

PUT

http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container

HTTP/1.1

如需詳細資訊,請參閱 使用 Azure 儲存體模擬器進行開發和測試差異之間儲存體模擬器和 Azure 儲存體服務

可能要求 URI 上指定下列其他參數。

參數

描述

timeout

選擇性的。 timeout 參數以秒為單位。 如需詳細資訊,請參閱 設定 Blob 服務作業的逾時值

下表描述必要和選擇性要求標頭。

要求標頭

描述

Authorization

必要的。 指定驗證配置、 帳戶名稱和簽章。 如需詳細資訊,請參閱 Azure 儲存體服務的驗證

Datex-ms-date

必要的。 指定要求的國際標準時間 (UTC) 時間。 如需詳細資訊,請參閱 Azure 儲存體服務的驗證

x-ms-version

所需的所有已驗證要求。 指定要用於此要求之作業的版本。 如需詳細資訊,請參閱 Azure 儲存體服務版本控制

x-ms-meta-name:value

選擇性的。 與容器做為中繼資料相關聯的名稱 / 值組。

請注意,從 2009年-09-19 版開始,中繼資料名稱必須遵守的命名規則 C# 識別項

x-ms-blob-public-access 

選擇性的。 指定是否可公開存取容器中的資料,以及存取層級。 可能值包括:

  • container:指定的容器和 blob 資料的完整公開讀取權限。 用戶端可以列舉透過匿名要求,容器內的 blob,但無法列舉儲存體帳戶內的容器。

  • blob: 指定 blob 的公用讀取權限。 可以讀取此容器內的 blob 資料,透過匿名要求,但不是使用容器資料。 用戶端無法列舉透過匿名要求容器內的 blob。

如果此標頭未包含在要求中,容器資料是私用的帳戶擁有者。

x-ms-client-request-id

選擇性的。 具有 1 KB 的字元限制的儲存體分析記錄啟用時,會記錄在分析記錄檔中提供用戶端產生的不透明值。 用戶端活動與伺服器收到的要求產生關聯,強烈建議使用此標頭。 如需詳細資訊,請參閱 關於儲存體分析記錄Azure 記錄:使用記錄檔追蹤儲存體要求

Request Syntax: PUT https://myaccount.blob.core.windows.net/mycontainer?restype=container HTTP/1.1 Request Headers: x-ms-version: 2011-08-18 x-ms-date: Sun, 25 Sep 2011 22:50:32 GMT x-ms-meta-Name: StorageSample Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

回應包括 HTTP 狀態碼和一組回應標頭。

成功的作業會傳回狀態碼 201 (已建立)。

如需狀態碼的詳細資訊,請參閱 狀態和錯誤碼

這項作業的回應包括下列標頭。 回應也可能包括其他標準 HTTP 標頭。 所有標準標頭都符合 HTTP/1.1 通訊協定規格

回應標頭

描述

ETag

容器的 ETag。 如果要求版本為 2011年-08-18 或更新版本中,會加上引號的 ETag 值。

Last-Modified

傳回容器上次修改的時間與日期。 日期格式會依照 RFC 1123。 如需詳細資訊,請參閱 標頭中的日期/時間值表示方式

修改容器或其屬性或中繼資料的任何作業會更新上次修改的時間。 Blob 上的作業不會影響容器的上次修改的時間。

x-ms-request-id

此標頭可唯一識別,但可用於疑難排解要求的要求。 如需詳細資訊,請參閱 疑難排解應用程式開發介面作業 

x-ms-version

指出 Blob 服務用來執行要求的版本。 此標頭會傳回要求對 2009年-09-19 版及更新版本。

Date

UTC 日期/時間值,指出啟動回應的時間服務所產生的。

Response Status: HTTP/1.1 201 Created Response Headers: Transfer-Encoding: chunked Date: Sun, 25 Sep 2011 23:00:12 GMT ETag: “0x8CB14C3E29B7E82” Last-Modified: Sun, 25 Sep 2011 23:00:06 GMT x-ms-version: 2011-08-18 Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0

只有帳戶擁有者可以呼叫此作業。

容器會儲存體帳戶下方直接建立。 您不可以巢狀處理另一個容器下方。

您可以選擇建立儲存體帳戶的預設值或根容器。 根容器可能會從要求 blob 資源的 URL 推斷。 根容器可讓您能夠參考的 blob 儲存體帳戶階層最上層,而不需要參考容器名稱。

若要將根容器加入至儲存體帳戶中,建立名為容器 $root 建構要求,如下所示:

Request Syntax: PUT https://myaccount.blob.core.windows.net/$root?restype=container HTTP/1.1 Request Headers: x-ms-version: 2011-08-18 x-ms-date: Sun, 25 Sep 2011 22:50:32 GMT x-ms-meta-Name: StorageSample Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

您可以指定容器的中繼資料時,就會建立包含一或多個中繼資料標頭要求。 中繼資料標頭的格式是 x-ms-meta-name:value

如果正在使用相同名稱的容器刪除 Create Container 是呼叫,伺服器會傳回狀態碼 409 (衝突),並提供其他錯誤資訊,指出正在刪除容器。

顯示:
© 2016 Microsoft