Leer todos los registros de un canal

Recupera todos los registros de un canal (por ejemplo, el URI del canal, el token del dispositivo y el identificador del registro de GCM).

Solicitud

Método	URI de solicitud	Versión de HTTP
GET	https://{namespace}.servicebus.windows.net/{NotificationHub}/registrations/?$filter=ChannelUri eq '{channelUri}'&api-version=2015-01 or https://{namespace}.servicebus.windows.net/{NotificationHub}/registrations/?$filter=DeviceToken eq '{deviceToken}'&api-version=2015-01 or https://{namespace}.servicebus.windows.net/{NotificationHub}/registrations/?$filter=GcmRegistrationId eq '{gcmRegistrationId}'&api-version=2015-01

Tenga en cuenta los siguientes puntos:

• Esta llamada es compatible con el parámetro de cadena de consulta $top según se especifica en OData.
• Esta llamada admite un parámetro de cadena de consulta ContinuationToken para continuar la enumeración.
• ChannelUri tiene codificación URL.
• DeviceToken debe tener formato hexadecimal en mayúsculas.

Encabezados de solicitud

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

Encabezado de solicitud	Descripción
Authorization	Token de SAS generado tal y como se especifica en Autenticación de firma de acceso compartido con Service Bus.
x-ms-version	2015-01

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	Registros recuperados correctamente.
400	Solicitud incorrecta. Los centros de notificaciones no admiten esta consulta
401	Error de autorización. La clave de acceso era incorrecta.
403	Cuota superada; solicitud rechazada porque la tasa de operaciones de registro es demasiado alta.

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

Encabezados de respuesta

Encabezado de respuesta	Descripción
Content-type	application/atom+xml;type=entry;charset=utf-8
X-MS-ContinuationToken	Contiene el token para continuar la enumeración de los registros, en caso de que haya más.

Response body

Fuente Atom que encapsula la lista de registros en el formato xml especificado en Crear registro. Por ejemplo:

<?xml version="1.0" encoding="utf-8" ?>
<feed xmlns="http://www.w3.org/2005/Atom">
  <title type="/{NotificationTopic}/channels/{channel hash}" />
  <id> https://{tenant}.windows.net/{NotificationTopic}/channels/{channel hash}</id>
  <updated>2012-08-17T17:32:00Z</updated>
  <entry xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" m:etag="W/&quot;1234567890&quot;">
    <id>https://{tenant}.windows.net/{NotificationTopic}/registrations/{registrationId}</id>
    <title type="text"> /{NotificationTopic}/registrations/{registrationId}</title>
    <updated>2012-08-17T17:32:00Z</updated>
    <content type="application/xml">
    <WindowsRegistrationDescription xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect">
            <ETag>{ETag}</ETag>
        <ExpirationTime>2012-07-16T19:20+01:00</ExpirationTime>
        <RegistrationId>{RegistrationId}</RegistrationId>
            <Tags>myTag, myOtherTag</Tags>
            <ChannelUri>{ChannelUri}</ChannelUri>
        </WindowsRegistrationDescription>
    </content>
  </entry>
  <entry>
    …
  </entry>
</feed>