共用方式為


建立命名空間

重要

2021 年 11 月 1 日起,此 API 已過時且已淘汰,不應再使用。

建立新的服務命名空間。 此命名空間的資源資訊清單在建立之後將永遠不變。 這是一個等冪作業。

命名空間識別碼應遵循下列命名慣例:

  1. 名稱長度至少必須為 6 個字元,且最多為 50 個字元。

  2. 名稱符合規則運算式 ^[a-zA-Z][a-zA-Z0-9-]*$ (命名空間名稱只能包含字母、數字及連字號 “-“)。

  3. 名稱結尾不是 “-”、“-sb” 或 “-mgmt”。

  4. 名稱可透過對布建的呼叫取得,也就是說,名稱在 Azure 中必須是唯一的,才能成功建立。

  5. 名稱開頭必須是字母。

  6. 不允許使用 GUID 做為命名空間名稱。

要求

方法 要求 URI HTTP 版本
PUT https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name} HTTP/1.1

要求標頭

下表描述必要的和選用的要求標頭。

要求標頭 描述
Content-Type 設定為 application/atom+xml
x-ms-version 2012-03-01

要求也需要客戶端憑證。 此憑證必須符合您針對該特殊訂閱所上傳的憑證。

要求本文

命名空間描述。 請參閱 命名空間描述。 只有地區是必要項;其他欄位均為選用。

回應

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

回應碼

注意

如果您利用含有特殊或已編碼字元的名稱建立命名空間 (例如「test?Name=value&」,這會編碼為「test%3FName%3Dvalue%26」),即會產生「(400) 無效的要求主體」例外狀況。

程式碼 描述
200 已建立命名空間。
401 授權失敗。
500 內部錯誤。

如需狀態代碼的相關信息,請參閱 狀態和錯誤碼

回應標頭

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

回應標頭 Description
Content-Type application/atom+xml; type=entry; charset=utf-8

回應本文

會傳回 命名空間描述 。 如果 PUT 要求中遺漏了某些描述屬性,這些可能會包含預設值。