Compartilhar via


Criar ID de registro

 

Retorna uma ID de registro (sem criar um registro). Você pode usar a ID de registro gerado para criar um registro usando o Criar ou atualizar registro método.

Solicitação

Método URI de solicitação Versão de HTTP
POST https://{namespace}.ServiceBus.Windows.NET/{NotificationHub}/registrationIDs/?API-Version=2015-01 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 de solicitação Descrição
Content-Type application/atom+xml;type=entry;charset=utf-8
Autorização Token gerado conforme especificado autenticação SAS com Barramento do Serviço, ou Barramento do Serviço autenticação e autorização com Access Control do Active Directory do Microsoft Azure (também conhecido como Access Control Service ou ACS).
x-ms-version 2015-01

Corpo da solicitação

Nenhuma.

Resposta

A resposta inclui um código de status HTTP e um conjunto de cabeçalhos de resposta.

Códigos de resposta

Código Descrição
201 Registro criado com sucesso.
400 Corpo da solicitação inválido. O registro não pode ser criado devido a uma solicitação com defeito.
401 Falha de autorização. A tecla de acesso estava incorreta.
403 Cota excedida; há registros demais nesse namespace. Registro não criado.
403 Solicitação rejeitada, pois a classificação de operações de registro é alta demais.

Para obter informações sobre códigos de status, consulte Status e códigos de erro.

Cabeçalhos de resposta

Cabeçalho de resposta Descrição
Content-type application/atom+xml;type=entry;charset=utf-8
Local do conteúdo A localização do registro no formato:

 https://{namespace}.servicebus.windows.net/{NotificationHub}/registrations/<registrationId>
ETag {weak ETag}

Corpo da resposta

Nenhuma.