Criar Espaço de Nomes
Importante
Esta API é obsoleta e descontinuada a partir de 11/01/2021 e já não deve ser utilizada.
Cria um novo espaço de nomes de serviço. Uma vez criado, o manifesto de recursos deste espaço de nomes é imutável. Esta operação é idempotente.
O identificador do espaço de nomes deve cumprir as seguintes convenções de nomenclatura:
O comprimento do nome é, pelo menos, 6 e, no máximo, 50 carateres.
O nome corresponde a regex ^[a-zA-Z][a-zA-Z0-9-]*$ (o nome do espaço de nomes só pode conter Letras, números, hífenes "-").
O nome não termina com "-", "-sb" ou "-mgmt".
O nome está disponível através de uma chamada para aprovisionamento, ou seja, o nome tem de ser exclusivo em todo o Azure para ser criado com êxito.
O nome tem de começar com uma letra.
Um GUID é agora permitido como o nome do espaço de nomes.
Pedir
| Método | URI do pedido | Versão HTTP |
|---|---|---|
| PUT | https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name} | HTTP/1.1 |
Cabeçalhos de Pedido
A tabela seguinte descreve os cabeçalhos de pedido obrigatórios e opcionais.
| Cabeçalho do Pedido | Description |
|---|---|
| Content-Type | Definido como aplicação/atom+xml. |
| x-ms-version | 2012-03-01 |
O pedido também requer um certificado de cliente. Este certificado tem de corresponder ao certificado que carregou para essa subscrição específica.
Corpo do Pedido
A descrição do espaço de nomes. Veja Descrição do Espaço de Nomes. Apenas a Região é necessária; os outros campos são opcionais.
Resposta
A resposta inclui um código de estado HTTP e um conjunto de cabeçalhos de resposta.
Códigos de Resposta
Nota
Se criar um espaço de nomes com um nome que contenha carateres especiais ou codificados (por exemplo, "teste? Name=value&", que é codificado para "test%3FName%3Dvalue%26"), é gerada uma exceção "(400) corpo de pedido inválido".
| Código | Descrição |
|---|---|
| 200 | Espaço de nomes criado. |
| 401 | Falha de autorização. |
| 500 | Erro interno. |
Para obter informações sobre códigos de estado, veja Códigos de Estado e erro.
Cabeçalhos de Resposta
A resposta para esta operação inclui os seguintes cabeçalhos. A resposta também pode incluir cabeçalhos HTTP padrão adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.
| Cabeçalho de Resposta | Description |
|---|---|
| Content-Type | application/atom+xml; type=entry; charset=utf-8 |
Corpo da Resposta
A Descrição do Espaço de Nomes é devolvida. Se algumas propriedades de descrição estiverem em falta no pedido PUT, estas propriedades poderão conter valores predefinidos.