Vytvořit obor názvů

  • Článek

Důležité

Toto rozhraní API je zastaralé a vyřazené od 1. 11. 2021 a už by se nemělo používat.

Vytvoří nový obor názvů služby. Po vytvoření je manifest prostředku tohoto oboru názvů neměnný. Tato operace je idempotentní.

Identifikátor oboru názvů by měl dodržovat následující zásady vytváření názvů:

  1. Délka názvu je minimálně 6 a maximálně 50 znaků.

  2. Název odpovídá regex ^[a-zA-Z][a-zA-Z0-9-]*$ (název oboru názvů může obsahovat pouze písmena, čísla, pomlčky "-").

  3. Název nekončí na "-", "-sb" nebo "-mgmt".

  4. Název je k dispozici prostřednictvím volání zřizování, to znamená, že název musí být jedinečný v rámci Azure, aby se úspěšně vytvořil.

  5. Název musí začínat písmenem.

  6. Jako název oboru názvů je teď povolený identifikátor GUID.

Žádost

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
PUT https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{název oboru názvů} HTTP/1.1

Hlavičky požadavku

Následující tabulka popisuje požadované a volitelné hlavičky požadavků.

Hlavička požadavku Description
Typ obsahu Nastavte na application/atom+xml.
x-ms-version 2012-03-01

Požadavek také vyžaduje klientský certifikát. Tento certifikát se musí shodovat s certifikátem, který jste nahráli pro konkrétní předplatné.

Text požadavku

Popis oboru názvů. Viz Popis oboru názvů. Vyžaduje se pouze oblast . ostatní pole jsou volitelná.

Odpověď

Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.

Kódy odpovědí

Poznámka

Pokud vytvoříte obor názvů s názvem obsahujícím speciální nebo zakódované znaky (například test? Název=hodnota&", který se zakóduje do "test%3FName%3Dvalue%26"), vygeneruje se výjimka "(400) neplatný text požadavku".

Kód Description
200 Obor názvů byl vytvořen.
401 Chyba autorizace.
500 Vnitřní chyba.

Informace o stavových kódech najdete v tématu Stavové kódy a kódy chyb.

Hlavičky odpovědi

Odpověď na tuto operaci obsahuje následující hlavičky. Odpověď může také obsahovat další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Hlavička odpovědi Description
Typ obsahu application/atom+xml; type=entry; charset=utf-8

Text odpovědi

Vrátí se popis oboru názvů . Pokud v požadavku PUT chyběly některé vlastnosti popisu, můžou tyto vlastnosti obsahovat výchozí hodnoty.