Compartilhar via


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:

  1. O nome deve ter no mínimo seis e no máximo 50 caracteres.

  2. 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 “-“).

  3. O nome não termina com "-", "-sb" ou "-mgmt".

  4. 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.

  5. O nome deve começar com uma letra.

  6. 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.