Criar um Namespace
Importante
Essa API está obsoleta e desativada a partir de 11/1/2021 e não deve mais ser usada.
Cria um novo namespace de serviço. Depois de criada, o manifesto do recurso do namespace é imutável. Essa operação é idempotente.
O identificador do namespace deve estar de acordo com as convenções de nomenclatura a seguir:
O nome deve ter no mínimo seis e no máximo 50 caracteres.
O nome deve corresponder à expressão regular ^[a-zA-Z][a-zA-Z0-9-]*$ (o nome do namespace só pode conter letras, números e hifens “-“).
O nome não termina com "-", "-sb" ou "-mgmt".
O nome está disponível por meio de uma chamada para provisionamento, ou seja, o nome deve ser exclusivo no Azure para ser criado com êxito.
O nome deve começar com uma letra.
Agora é permitido usar um GUID como o nome do namespace.
Solicitação
| Método | URI da solicitação | Versão HTTP |
|---|---|---|
| PUT | https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name} | HTTP/1.1 |
Cabeçalhos de solicitação
A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.
| Cabeçalho da solicitação | Descrição |
|---|---|
| Tipo de conteúdo | Definido como application/atom+xml. |
| x-ms-version | 2012-03-01 |
A solicitação também requer um certificado de cliente. Esse certificado deve corresponder ao carregado para uma assinatura específica.
Corpo da solicitação
A descrição do namespace. Confira Descrição do Namespace. Somente a região é obrigatória. Os outros campos são opcionais.
Resposta
A resposta inclui um código de status HTTP e um conjunto de cabeçalhos de resposta.
Códigos de resposta
Observação
Se você criar um namespace com um nome contendo caracteres especiais ou codificados (por exemplo, "test?Name=value&", que é codificado para "test%3FName%3Dvalue%26"), uma exceção "(400) corpo da solicitação inválido" é gerada.
| Código | Descrição |
|---|---|
| 200 | Namespace criado. |
| 401 | Falha de autorização. |
| 500 | Erro interno. |
Para obter informações sobre códigos de status, consulte Códigos de status e de erro.
Cabeçalhos de resposta
A resposta para esta operação inclui os cabeçalhos a seguir. 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 | Descrição |
|---|---|
| Tipo de conteúdo | application/atom+xml; type=entry; charset=utf-8 |
Corpo da resposta
A Descrição do Namespace é retornada . Se algumas propriedades da descrição estiverem ausentes na solicitação PUT, essas propriedades poderão conter valores padrão.