Tworzenie przestrzeni nazw
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:
Długość nazwy wynosi co najmniej 6 i co najwyżej 50 znaków.
Nazwa odpowiada regex ^[a-zA-Z][a-zA-Z0-9-]*$ (nazwa przestrzeni nazw może zawierać tylko litery, cyfry, łączniki "-").
Nazwa nie kończy się ciągiem "-", "-sb" lub "-mgmt".
Nazwa jest dostępna za pośrednictwem wywołania aprowizacji, czyli nazwy musi być unikatowa na platformie Azure, aby pomyślnie ją utworzyć.
Nazwa musi zaczynać się literą.
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.