Создание пространства имен
Важно!
Этот API устарел и устарелс 11.01.2021 и больше не должен использоваться.
Создает новое пространство имен службы. После создания изменить манифест ресурсов этого пространства имен нельзя. Эта операция является идемпотентной.
В идентификаторе пространства имен должны соблюдаться следующие соглашения об именовании.
Длина имени — не менее 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/{name 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, эти свойства могут содержать значения по умолчанию.