Creare lo spazio dei nomi

Importante

Questa API è obsoleta e ritirata a partire dal 11/1/2021 e non deve più essere usata.

Crea un nuovo spazio dei nomi del servizio. Dopo la creazione, il manifesto delle risorse dello spazio dei nomi non può essere modificato. Questa operazione è idempotente.

L'identificatore dello spazio dei nomi deve rispettare le convenzioni di denominazione seguenti:

  1. La lunghezza del nome deve essere compresa tra 6 e 50 caratteri.

  2. Il nome deve essere conforme ai criteri regex ^[a-zA-Z][a-zA-Z0-9-]*$ (il nome dello spazio dei nomi può contenere solo lettere, numeri e trattini "-").

  3. Il nome non termina con "-", "-sb" o "-mgmt".

  4. Il nome è disponibile tramite una chiamata al provisioning, ovvero il nome deve essere univoco in Azure per essere creato correttamente.

  5. Il nome deve iniziare con una lettera.

  6. Non è consentito usare un GUID come nome dello spazio dei nomi.

Richiesta

Metodo URI richiesta Versione HTTP
PUT https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{nome dello spazio dei nomi} HTTP/1.1

Intestazioni richiesta

Nella seguente tabella vengono descritte le intestazioni di richiesta obbligatorie e facoltative.

Intestazione della richiesta Descrizione
Content-Type Viene impostata su application/atom+xml.
x-ms-version 2012-03-01

La richiesta richiede anche un certificato client. Questo certificato deve corrispondere a quello caricato per la sottoscrizione specifica.

Corpo della richiesta

Descrizione dello spazio dei nomi. Vedere Descrizione dello spazio dei nomi. È richiesta solo la definizione dell'area. Gli altri campi sono facoltativi.

Risposta

Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.

Codici di risposta

Nota

Se si crea uno spazio dei nomi con un nome contenente caratteri speciali o codificati, ad esempio "test?Name=value&", che viene codificato in "test%3FName%3Dvalue%26", viene generata un'eccezione 400 di corpo della richiesta non valido.

Codice Descrizione
200 Spazio dei nomi creato.
401 Errore di autorizzazione.
500 Errore interno.

Per informazioni sui codici di stato, vedere Codici di stato e di errore.

Intestazioni della risposta

Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; La risposta potrebbe includere anche intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.

Intestazione di risposta Descrizione
Content-Type application/atom+xml; type=entry; charset=utf-8

Corpo della risposta

Viene restituita la descrizione dello spazio dei nomi . Se alcune proprietà della descrizione non sono presenti nella richiesta PUT, è possibile che tali proprietà contengano valori predefiniti.