Compartir a través de


Crear espacio de nombres

Importante

Esta API está obsoleta y retirada a partir del 11/1/2021 y ya no debe usarse.

Crea un nuevo espacio de nombres de servicio. Una vez creado, el manifiesto del recurso de espacio de nombres es inmutable. Esta operación es idempotente.

El identificador de espacio de nombres debe cumplir la siguiente convención de nomenclatura:

  1. La longitud del nombre es de 6 caracteres como mínimo y 50 como máximo.

  2. El nombre coincide con regex ^[a-zA-Z][a-zA-Z0-9-]*$ (el nombre de espacio de nombre solo puede contener letras, números y guiones “-“).

  3. El nombre no termina con "-", "-sb" o "-mgmt".

  4. El nombre está disponible a través de una llamada al aprovisionamiento, es decir, el nombre debe ser único en Azure para crearse correctamente.

  5. El nombre debe comenzar por una letra.

  6. Ahora se permite un GUID como nombre de espacio de nombres.

Solicitud

Método URI de solicitud Versión de HTTP
PUT https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name} HTTP/1.1

Encabezados de solicitud

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.

Encabezado de solicitud Descripción
Content-Type Establézcalo en aplicación/atom+xml.
x-ms-version 2012-03-01

La solicitud también requiere un certificado de cliente. Este certificado debe coincidir con el certificado que cargó para la suscripción concreta.

Cuerpo de la solicitud

Descripción del espacio de nombres. Consulte Descripción del espacio de nombres. Solo es obligatorio el campo Región; el resto son opcionales.

Response

La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.

Códigos de respuesta

Nota

Si crea un espacio de nombres con un nombre que contiene caracteres especiales o codificados (por ejemplo, "test?Name=value&"), que se codifica en "test%3FName%3Dvalue%26", se generará una excepción "(400) Cuerpo de solicitud no válido".

Código Descripción
200 Espacio de nombres creado.
401 Error de autorización.
500 Error interno.

Para obtener información sobre los códigos de estado, vea Códigos de estado y error.

Encabezados de respuesta

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir encabezados HTTP estándar adicionales. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.

Encabezado de respuesta Descripción
Content-Type aplicación/atom+xml; type=entry; charset=utf-8

Cuerpo de la respuesta

Se devuelve la Descripción del espacio de nombres . Si faltaran algunas propiedades de descripción de la solicitud PUT, podrían contener valores predeterminados.