你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

创建命名空间

重要

此 API 已 过时，自2021 年 11 月 1 日停用，不应再使用。

创建新的服务命名空间。 创建之后，此命名空间的资源清单不可变。 此操作是幂等的。

命名空间标识符应遵循以下命名约定：

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 协议规范。

响应标头	说明
Content-Type	application/atom+xml; type=entry; charset=utf-8

响应正文

返回 命名空间说明 。 如果 PUT 请求中缺少某些描述属性，则这些属性可能包含默认值。