Créer l'espace de noms
Important
Cette API est obsolète et mise hors service à partir du 1/11/2021 et ne doit plus être utilisée.
Crée un espace de noms de service. Une fois créé, le manifeste de ressources de cet espace de noms est immuable. Cette opération est idempotente.
L'identificateur d'espace de noms doit respecter les conventions d'affectation de noms suivantes :
Le nom doit inclure entre 6 et 50 caractères.
Le nom doit correspondre au regex ^[a-zA-Z][a-zA-Z0-9-]*$ (le nom de l'espace de noms ne peut contenir que des lettres, des chiffres et des tirets « - »).
Le nom ne se termine pas par « - », « -sb » ou « -mgmt ».
Le nom est disponible via un appel à l’approvisionnement, c’est-à-dire que le nom doit être unique dans Azure pour être créé avec succès.
Le nom doit commencer par une lettre.
Un GUID est désormais autorisé en tant que nom d'espace de noms.
Requête
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| PUT | https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{nom de l’espace de noms} | HTTP/1.1 |
En-têtes de requête
Le tableau suivant décrit les en-têtes de demande obligatoires ou facultatifs.
| En-tête de requête | Description |
|---|---|
| Content-Type | Définissez sur application/atom+xml. |
| x-ms-version | 2012-03-01 |
La demande nécessite également un certificat client. Ce certificat doit correspondre à celui que vous avez téléchargé pour cet abonnement.
Corps de la demande
Description de l'espace de noms. Consultez Description de l’espace de noms. Seul le champ Région est obligatoire. Les autres champs sont facultatifs.
response
La réponse inclut un code d'état HTTP et un ensemble d'en-têtes de réponse.
Codes de réponse
Notes
Si vous créez un espace de noms avec un nom contenant des caractères spéciaux ou codés (par exemple, « test?Name=value& », qui est codé « test%3FName%3Dvalue%26 »), une exception « (400) invalid request body » est générée.
| Code | Description |
|---|---|
| 200 | Espace de noms créé. |
| 401 | Échec de l'autorisation. |
| 500 | Erreur interne. |
Pour plus d’informations sur les codes status, consultez Codes d’état et d’erreur.
En-têtes de réponse
La réponse de l'opération inclut les en-têtes suivants. La réponse peut également inclure des en-têtes HTTP standard supplémentaires. Tous les en-têtes standard sont conformes à la spécification du protocole HTTP/1.1.
| En-tête de réponse | Description |
|---|---|
| Content-Type | application/atom+xml; type=entry; charset=utf-8 |
Corps de la réponse
La description de l’espace de noms est retournée. S'il manquait des propriétés de description dans la demande PUT, ces propriétés pourraient contenir des valeurs par défaut.