Enumeración

La operación Discovery navega por los espacios de nombres jerárquicos, mientras que Enumeration le permite obtener una lista con todas las entidades de un cierto tipo en una vista plana. La enumeración se realiza en la colección de recursos reservados especiales ($Resources) que reside en la raíz del espacio de nombres del servicio. En cuanto a las características, enumeration ocurre en relación a la dirección de la colección; por ejemplo, "/subscriptions" o "/rules" para las suscripciones y para las reglas en un tema.

Request

Puede construir la solicitud Enumeration como se indica a continuación.

Método	URI de solicitud	Versión HTTP
GET	https://{serviceNamespace}.servicebus.windows.net/$Resources/{resourceCollection} o https://{serviceNamespace}.servicebus.windows.net/{path}/Subscriptions o https://{serviceNamespace}.servicebus.windows.net/{path}/Subscriptions/{subscription-name}/rules	HTTP/1.1

Parámetros de consulta $skip y $top

La enumeración admite la paginación. Puede recuperar un intervalo de entidades en el espacio de nombres del servicio. El parámetro de consulta $skip indica cuántas entradas debe omitir la solicitud al devolver una enumeración y $top cuántas entradas se devolverán.

Encabezados de solicitud

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.

Encabezado de solicitud	Descripción
Authorization	Especifica un token de firma de acceso compartido (SAS) con derechos "Administrar". Consulte Autenticación de Service Bus con firmas de acceso compartido para más información.

Cuerpo de la solicitud

Ninguno.

Response

La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.

Códigos de respuesta

Código	Descripción
200	Aceptar.
401	No autorizado. La solicitud no está autenticada.

Nota

Se devuelve una fuente vacía si no existe ninguna entidad.

Para obtener información sobre los códigos de estado, vea Códigos de estado y error.

Encabezados de respuesta

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.

Encabezado de respuesta	Descripción
Tipo de contenido	Content-Type: application/atom+xml; type=entry

Cuerpo de la respuesta

Cuando se realiza correctamente, se devuelve una fuente Atom que contiene varias entradas Atom con un listado de todos los recursos de un tipo dado disponibles en el espacio de nombres proporcionado. Por ejemplo:

<?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 obtener el contenido posible del elemento {description}, vea Información general.