Enumeração

Artigo
08/05/2023

A operação Descoberta navega em namespaces hierárquicos, enquanto Enumeração permite listar todas as entidades de um certo tipo, em uma vista plana. A enumeração é executada na coleção especial de recursos reservados ($Resources) que reside na raiz do namespace de serviço. Para recursos, a enumeração ocorre com relação ao endereço da coleção; por exemplo, “/subscriptions” ou “/rules” para assinaturas e regras em um tópico.

Solicitação

Você pode construir a solicitação Enumeração do modo a seguir.

Método	URI da solicitação	Versão de HTTP
GET	https://{serviceNamespace}.servicebus.windows.net/$Resources/{resourceCollection} ou https://{serviceNamespace}.servicebus.windows.net/{path}/Subscriptions ou https://{serviceNamespace}.servicebus.windows.net/{path}/Subscriptions/{subscription-name}/rules	HTTP/1.1

Parâmetros de consulta $skip e $top

A enumeração dá suporte à paginação. Você pode recuperar um intervalo de entidades no namespace de serviço. O parâmetro de consulta $skip indica quantas entradas a solicitação deve ignorar ao retornar uma enumeração e $top quantas entradas devem ser retornadas.

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". Consulte 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

Um feed vazio será retornado se não existir nenhuma entidade.

Para obter informações sobre status códigos, consulte Códigos de status e 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	Tipo de Conteúdo: application/atom+xml; type=entry

Corpo da resposta

Ao ser bem-sucedido, é retornado um feed Atom contendo várias entradas Atom, listando todos os recursos disponíveis de um certo tipo no namespace específico. Por exemplo:

<?xml version="1.0" encoding="utf-8" ?>  
<feed xmlns='http://www.w3.org/2005/Atom'>  
  <entry>  
    <id>https://{serviceNamespace}.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