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.