Enumeração

Artigo
08/05/2023

A operação de Deteção navega em espaços de nomes hierárquicos, enquanto a Enumeração permite-lhe listar todas as entidades de determinado tipo, numa vista simples. A enumeração é efetuada na coleção de recursos reservados ($Resources) especial que reside na raiz do espaço de nomes de serviço. Para as funcionalidades, a enumeração ocorre no que diz respeito ao endereço da coleção; por exemplo, "/subscriptions" ou "/rules" para subscrições e regras num tópico.

Pedir

Pode construir o pedido de Enumeração da seguinte forma.

Método	URI do pedido	Versão 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 suporta a paginação. Pode obter um intervalo de entidades no seu espaço de nomes de serviço. O parâmetro de consulta $skip indica quantas entradas o pedido deve ignorar ao devolver uma enumeração e $top quantas entradas devem ser devolvidas.

Cabeçalhos de Pedido

A tabela seguinte descreve os cabeçalhos de pedido obrigatórios e opcionais.

Cabeçalho do Pedido	Description
Autorização	Especifica um token de Assinatura de Acesso Partilhado (SAS) com direitos "Gerir". Veja Autenticação do Service Bus com Assinaturas de Acesso Partilhado para obter detalhes.

Corpo do Pedido

Nenhum.

Resposta

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

Códigos de Resposta

Código	Descrição
200	OK.
401	Não autorizado. O pedido não está autorizado.

Nota

É devolvido um feed vazio se não existirem entidades.

Para obter informações sobre códigos de estado, veja Códigos de Estado e erro.

Cabeçalhos de Resposta

A resposta para esta operação inclui os seguintes cabeçalhos. 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	Description
Tipo de conteúdo	Content-Type: application/atom+xml; type=entry

Corpo da Resposta

Após o êxito, é devolvido um feed Atom que contém múltiplas entradas Atom que listam todos os recursos disponíveis de um determinado tipo no espaço de nomes especificado. 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 os conteúdos possíveis do elemento {description}, consulte Descrição geral.

Partilhar via