Membaca semua pendaftaran saluran

2023-05-26

Mengambil semua pendaftaran untuk saluran (misalnya, ChannelUri, token perangkat, registrationId GCM).

Minta

Metode	Meminta URI	Versi HTTP
GET	`https://{namespace}.servicebus.windows.net/{NotificationHub}/registrations/?$filter=ChannelUri eq '{channelUri}'&api-version=2015-01` atau `https://{namespace}.servicebus.windows.net/{NotificationHub}/registrations/?$filter=DeviceToken eq '{deviceToken}'&api-version=2015-01` atau `https://{namespace}.servicebus.windows.net/{NotificationHub}/registrations/?$filter=GcmRegistrationId eq '{gcmRegistrationId}'&api-version=2015-01`

Perhatikan poin berikut:

Panggilan ini mendukung parameter string kueri $top seperti yang ditentukan dalam OData.
Panggilan ini mendukung parameter string kueri ContinuationToken untuk melanjutkan enumerasi.
ChannelUri dikodekan url.
DeviceToken harus dalam format heksa atas.

Header permintaan

Tabel berikut ini menjelaskan header permintaan yang diperlukan dan opsional.

Meminta kop	Deskripsi
Authorization	Token SAS yang dihasilkan sebagaimana ditentukan dalam Autentikasi Tanda Tangan Akses Bersama dengan Azure Service Bus.
x-ms-version	2015-01

Isi permintaan

Tidak ada.

Respons

Respons mencakup kode status HTTP dan sekumpulan header respons.

Kode respons

Kode	Deskripsi
200	Pendaftaran berhasil diambil.
400	Permintaan Buruk. Hub pemberitahuan tidak mendukung kueri ini
401	Kegagalan otorisasi. Kunci akses salah.
403	Kuota terlampaui; permintaan ditolak karena tingkat operasi pendaftaran terlalu tinggi.

Untuk informasi tentang kode status, lihat Status dan Kode Kesalahan.

Header respons

Header respons	Deskripsi
Jenis konten	`application/atom+xml;type=entry;charset=utf-8`
X-MS-ContinuationToken	Berisi token untuk melanjutkan enumerasi pendaftaran, jika ada lebih banyak.

Isi Respons

Umpan atom yang membungkus daftar pendaftaran dalam format xml yang ditentukan dalam Buat Pendaftaran. Contohnya:

<?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>

Bagikan melalui