Dela via

Skapa namnområde

  • Artikel

Viktigt

Det här API: et är föråldrat och har dragits tillbaka från och med den 11/1/2021 och bör inte längre användas.

Skapar ett nytt namnområde för tjänsten. När det här namnområdets resursmanifest har skapats är det oföränderligt. Den här åtgärden är idempotent.

Namnområdesidentifieraren bör följa följande namngivningskonventioner:

  1. Namnlängden är minst 6 och högst 50 tecken.

  2. Namnet matchar regex ^[a-zA-Z][a-zA-Z0-9-]*$ (namnområdets namn får endast innehålla bokstäver, siffror, bindestreck "-").

  3. Namnet slutar inte med "-", "-sb" eller "-mgmt".

  4. Namnet är tillgängligt via ett anrop till etablering, d.v.s. namnet måste vara unikt i Hela Azure för att kunna skapas.

  5. Namnet måste börja med en bokstav.

  6. Ett GUID tillåts nu som namnområdesnamn.

Förfrågan

Metod URI för förfrågan HTTP-version
PUT https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name} HTTP/1.1

Rubriker för begäran

I följande tabell beskrivs obligatoriska och valfria begärandehuvuden.

Begärandehuvud Description
Content-Type Ange till application/atom+xml.
x-ms-version 2012-03-01

Begäran kräver också ett klientcertifikat. Det här certifikatet måste matcha certifikatet som du laddade upp för den specifika prenumerationen.

Begärandetext

Namnområdesbeskrivningen. Se Namnområdesbeskrivning. Endast region krävs. de andra fälten är valfria.

Svarsåtgärder

Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.

Svarskoder

Anteckning

Om du skapar ett namnområde med ett namn som innehåller särskilda eller kodade tecken (till exempel "test? Name=value&", som kodas till "test%3FName%3Dvalue%26"), genereras ett "(400) ogiltigt begärandetext"-undantag.

Kod Description
200 Namnområde har skapats.
401 Auktoriseringsfel.
500 Internt fel.

Information om statuskoder finns i Status och Felkoder.

Svarsrubriker

Svaret för den här åtgärden innehåller följande rubriker. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.

Svarshuvud Description
Content-Type application/atom+xml; type=entry; charset=utf-8

Svarstext

Namnområdesbeskrivningen returneras. Om vissa beskrivningsegenskaper saknas i PUT-begäran kan dessa egenskaper innehålla standardvärden.