Erstellen des Namespaces
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:
Die Länge des Namens beträgt mindestens 6 und maximal 50 Zeichen.
Der Name entspricht dem regulären Ausdruck ^[a-zA-Z][a-zA-Z0-9-]*$ (der Namespacename darf nur Buchstaben, Zahlen und Bindestriche "-") enthalten.
Der Name endet nicht mit "-", "-sb" oder "-mgmt".
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.
Der Name muss mit einem Buchstaben beginnen.
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.