建立命名空間
重要
自 2021 年 11 月 1 日起，此 API 已過時且已淘汰，不應再使用。
建立新的服務命名空間。 此命名空間的資源資訊清單在建立之後將永遠不變。 這是一個等冪作業。
命名空間識別碼應遵循下列命名慣例：
名稱長度至少必須為 6 個字元，且最多為 50 個字元。
名稱符合規則運算式 ^[a-zA-Z][a-zA-Z0-9-]*$ (命名空間名稱只能包含字母、數字及連字號 “-“)。
名稱結尾不是 “-”、“-sb” 或 “-mgmt”。
名稱可透過對布建的呼叫取得，也就是說，名稱在 Azure 中必須是唯一的，才能成功建立。
名稱開頭必須是字母。
不允許使用 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 要求中遺漏了某些描述屬性，這些可能會包含預設值。