為佇列和中繼資料命名

本主題描述為佇列和佇列中繼資料命名的規則。

佇列名稱

帳戶內的每個佇列都必須擁有唯一的名稱。 佇列名稱必須是有效的 DNS 名稱,而且建立後無法變更。 佇列名稱必須遵守下列規則:

  • 佇列名稱必須以字母或數字開頭,而且只能包含字母、數字和虛線 (-) 字元。

  • 佇列名稱中的第一個和最後一個字母必須是英數字。 虛線 (-) 字元不可做為第一個或最後一個字元。 佇列名稱中不可使用連續的虛線字元。

  • 佇列名稱中的所有字母都必須是小寫。

  • 佇列名稱的長度必須介於 3 至 63 個字元。

中繼資料名稱

佇列資源的中繼資料會儲存為名稱-值組。 從 REST API 2009-09-19 版開始,中繼資料名稱必須遵守 C# 識別碼的命名規則。 未遵守這些命名規則的現有中繼資料名稱可以在舊版佇列服務中使用,但無法在 2009-09-19 REST API 版或更新版本中使用。

中繼資料名稱會保留其建立時的大小寫,但在設定或讀取時並不區分大小寫。 如果針對單一資源提交兩個以上的同名中繼資料標頭,佇列服務會傳回狀態碼 400 (不正確的要求)。

另請參閱