Erstellen des Namespaces

  • Artikel

Wichtig

Diese API ist veraltet und seit dem 11.1.2021 eingestellt und sollte nicht mehr verwendet werden.

Erstellt einen neuen Dienstnamespace. Nach der Erstellung ist das Ressourcenmanifest des Namespaces unveränderlich. Dieser Vorgang ist idempotent.

Für den Namespacebezeichner sollten die folgenden Benennungskonventionen verwendet werden:

  1. Die Länge des Namens beträgt mindestens 6 und maximal 50 Zeichen.

  2. Der Name entspricht dem regulären Ausdruck ^[a-zA-Z][a-zA-Z0-9-]*$ (der Namespacename darf nur Buchstaben, Zahlen und Bindestriche "-") enthalten.

  3. Der Name endet nicht mit "-", "-sb" oder "-mgmt".

  4. Der Name ist über einen Aufruf der Bereitstellung verfügbar. Das heißt, der Name muss in Azure eindeutig sein, um erfolgreich erstellt zu werden.

  5. Der Name muss mit einem Buchstaben beginnen.

  6. Eine GUID ist nicht als Namespacename zulässig.

Anforderung

Methode Anforderungs-URI HTTP-Version
PUT https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{Namespacename} HTTP/1.1

Anforderungsheader

In der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben.

Anforderungsheader BESCHREIBUNG
Content-Type Wird auf application/atom+xml festgelegt.
x-ms-version 2012-03-01

Die Anforderung erfordert auch ein Clientzertifikat. Dieses Zertifikat muss mit dem Zertifikat übereinstimmen, das Sie für dieses bestimmte Abonnement hochgeladen haben.

Anforderungstext

Die Namespacebeschreibung. Weitere Informationen finden Sie unter Namespace Description. Nur Region ist erforderlich. Alle anderen Felder sind optional.

Antwort

Die Antwort enthält den HTTP-Statuscode und einen Satz von Antwortheadern.

Antwortcodes

Hinweis

Wenn Sie einen Namespace mit einem Namen erstellen, der Sonderzeichen oder codierte Zeichen enthält (Beispiel: "test?Name=value&", die zu "test%3FName%3Dvalue%26" codiert werden), wird die Ausnahme "400 (Ungültiger Anforderungstext)" generiert.

Code BESCHREIBUNG
200 Der Namespace wurde erstellt.
401 Autorisierungsfehler
500 Interner Fehler.

Informationen zu status Codes finden Sie unter Status- und Fehlercodes.

Antwortheader

Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann auch zusätzliche HTTP-Standardheader enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.

Antwortheader BESCHREIBUNG
Content-Type application/atom+xml; type=entry; charset=utf-8

Antworttext

Die Namespacebeschreibung wird zurückgegeben. Wenn einige Beschreibungseigenschaften in der PUT-Anforderung gefehlt haben, enthalten diese Eigenschaften möglicherweise Standardwerte.