Tworzenie przestrzeni nazw

  • Artykuł

Ważne

Ten interfejs API jest przestarzały i wycofany od 11.1.2021 r. i nie powinien być już używany.

Tworzy nową przestrzeń nazw usługi. Po utworzeniu manifest zasobu tej przestrzeni nazw jest niezmienny. Ta operacja jest idempotentna.

Identyfikator przestrzeni nazw powinien być zgodny z następującymi konwencjami nazewnictwa:

  1. Długość nazwy wynosi co najmniej 6 i co najwyżej 50 znaków.

  2. Nazwa odpowiada regex ^[a-zA-Z][a-zA-Z0-9-]*$ (nazwa przestrzeni nazw może zawierać tylko litery, cyfry, łączniki "-").

  3. Nazwa nie kończy się ciągiem "-", "-sb" lub "-mgmt".

  4. Nazwa jest dostępna za pośrednictwem wywołania aprowizacji, czyli nazwy musi być unikatowa na platformie Azure, aby pomyślnie ją utworzyć.

  5. Nazwa musi zaczynać się literą.

  6. Identyfikator GUID jest teraz dozwolony jako nazwa przestrzeni nazw.

Żądanie

Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
PUT https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name} HTTP/1.1

Nagłówki żądań

W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań.

Nagłówek żądania Opis
Content-Type Ustaw na wartość application/atom+xml.
x-ms-version 2012-03-01

Żądanie wymaga również certyfikatu klienta. Ten certyfikat musi być zgodny z certyfikatem przekazanym dla tej konkretnej subskrypcji.

Treść żądania

Opis przestrzeni nazw. Zobacz Opis przestrzeni nazw. Wymagany jest tylko region ; pozostałe pola są opcjonalne.

Reakcja

Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.

Kody odpowiedzi

Uwaga

Jeśli przestrzeń nazw zostanie utworzona z nazwą zawierającą znaki specjalne lub zakodowane (na przykład "test? Name=value&", który jest kodowany do "test%3FName%3Dvalue%26"), jest generowany wyjątek "(400) nieprawidłowa treść żądania".

Kod Opis
200 Utworzono przestrzeń nazw.
401 Niepowodzenie autoryzacji.
500 Błąd wewnętrzny.

Aby uzyskać informacje o kodach stanu, zobacz Kody stanu i błędów.

Nagłówki odpowiedzi

Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP. Wszystkie nagłówki standardowe są zgodne ze specyfikacją protokołu HTTP/1.1.

Nagłówek odpowiedzi Opis
Content-Type application/atom+xml; type=entry; charset=utf-8

Treść odpowiedzi

Zwracany jest opis przestrzeni nazw . Jeśli w żądaniu PUT brakuje właściwości opisu, te właściwości mogą zawierać wartości domyślne.