：ListSubscriptionByTopic

Otorisasi

Secara default, hanya akun Alibaba Cloud yang dapat memanggil operasi ini. Pengguna RAM hanya dapat memanggil operasi ini setelah diberikan izin terkait. Tabel berikut menjelaskan informasi otorisasi dari operasi ini. Untuk informasi lebih lanjut, lihat Kebijakan izin dan contoh.

Deskripsi

Jika jumlah total langganan melebihi nilai parameter x-mns-ret-number yang ditentukan dalam permintaan, parameter NextMarker yang menunjukkan posisi awal halaman berikutnya akan dikembalikan. Saat mengirim permintaan lain untuk meminta langganan yang tersisa, Anda harus mengatur parameter x-mns-marker ke nilai yang dikembalikan oleh parameter NextMarker.

Permintaan

Sebuah permintaan terdiri dari bagian-bagian berikut:

• Baris permintaan

  GET /topics/$TopicName/subscriptions HTTP/1.1

• Header permintaan spesifik operasi

  Parameter	Tipe	Diperlukan	Contoh	Deskripsi
  x-mns-prefix	String	Tidak	topik	Awalan dari langganan yang akan diminta.
  x-mns-marker	Integer	Tidak	10	Posisi awal halaman berikutnya. Anda dapat mengambil nilai parameter ini dari parameter NextMarker dalam respons sebelumnya.
  x-mns-ret-number	Integer	Tidak	2	Jumlah maksimum hasil yang dapat dikembalikan untuk satu permintaan. Nilai valid: 1 hingga 1.000.

  Untuk informasi lebih lanjut tentang header permintaan lainnya, lihat Parameter umum.

• Badan permintaan

  Tidak ada.

Respons

Sebuah respons terdiri dari bagian-bagian berikut:

• Kode status HTTP

  HTTP/1.1 200 OK

• Header respons spesifik operasi

  Tidak ada.

• Badan respons

  Badan respons dalam format XML. Daftar subscriptions dikembalikan dan setiap subscription mencakup URL langganan. Jika jumlah total langganan melebihi nilai parameter x-mns-ret-number, parameter NextMarker yang menunjukkan posisi awal halaman berikutnya akan dikembalikan.

Contoh

Contoh permintaan

GET /topics/$TopicName/subscriptions HTTP/1.1
x-mns-marker: 10
x-mns-ret-number:2
Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
Date: Tue, 08 Dec 2015 06:16:18 GMT
Authorization: MNS 15B4D3461F177624206A:dXSLY5yGG8Ri5f26ZEmxMCq1****
x-mns-version: 2015-06-06

Contoh respons sukses

HTTP/1.1 200 OK
x-mns-request-id:566675B2B2B71C9C1600****
x-mns-version: 2015-06-06

<?xml version="1.0" encoding="utf-8"?>
<Subscriptions xmlns="http://mns.aliyuncs.com/doc/v1/">
    <Subscription>
        <SubscriptionURL>http://$AccountId.mns.cn-hangzhou.aliyuncs.com/$TopicName/subscriptions/$SubscriptionName1</SubscriptionURL>
    </Subscription>
    <Subscription>
        <SubscriptionURL>http://$AccountId.mns.cn-hangzhou.aliyuncs.com/$TopicName/subscriptions/$SubscriptionName2</SubscriptionURL>
    </Subscription>
    <NextMarker>OTczNjU4MTcvYmRwejd6NXluby8yNjg0Mi9+fn5FI1Rlc3RUb3BpYy0xI2JkcHo3ejV5bm8jVGVzdFN1Yi0zLzA=</NextMarker>
</Subscriptions>