Descoberta de entidades

Artigo
07/19/2023

Descobrindo as entidades de mensagens.

Solicitação

Você pode construir a solicitação Descoberta de Entidades do modo a seguir.

Método	URI da solicitação	Versão de HTTP
GET	https://{serviceNamespace}.servicebus.windows.net/{path}	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
Autorização	Especifica um token SAS (Assinatura de Acesso Compartilhado) com direitos de "Gerenciar". Confira Autenticação do Barramento de Serviço com Assinaturas de Acesso Compartilhado para obter detalhes.

Corpo da solicitação

Nenhum.

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
200	OK.
401	Não autorizado. A solicitação não foi autorizada.

Observação

Para que a solicitação HTTP GET seja interpretada como uma operação de "Descoberta", o nome especificado pela URL não pode estar ocupado. Se o nome estiver ocupado, a solicitação HTTP GET é interpretada como uma operação "Get".

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 padrão HTTP 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	Content-Type: application/atom+xml; type=entry

Corpo da resposta

Ao ser bem-sucedido, um feed Atom listando os filhos imediatos do nó atual é retornado. Por exemplo:

<?xml version="1.0" encoding="utf-8" ?>  
<feed xmlns='http://www.w3.org/2005/Atom'>  
  <entry>  
    <id>https://{serviceNamespace}.servicebus.Windows.net/{path}</id>  
    <published>{createdTime}</published>  
    <updated>{lastUpdatedTime}</updated>  
    <link rel='self'>https://{serviceNamespace}.servicebus.Windows.net/{path}</link>  
    <content type='application/xml'>  
      {description}
    </content>  
  </entry>  
</feed>

Para obter o conteúdo possível do elemento {description}, consulte Visão geral.

Compartilhar via