:ListSubscriptionByTopic

認証

デフォルトでは、Alibaba Cloud アカウントのみがこの操作を呼び出すことができます。RAM ユーザーは、関連する権限が付与された後にのみ、この操作を呼び出すことができます。次の表に、この操作の認証情報を示します。詳細については、「アクセス許可ポリシーと例」をご参照ください。

説明

サブスクリプションの総数がリクエストで指定された x-mns-ret-number パラメーターの値を超える場合、次のページの開始位置を示す NextMarker パラメーターが返されます。残りのサブスクリプションを照会するために別のリクエストを送信する場合は、x-mns-marker パラメーターを NextMarker パラメーターの戻り値に設定する必要があります。

リクエスト

リクエストは次の部分で構成されます。

• リクエスト行

  GET /topics/$TopicName/subscriptions HTTP/1.1

• 操作固有のリクエストヘッダー

  パラメーター	タイプ	必須	例	説明
  x-mns-prefix	String	いいえ	topic	照会するサブスクリプションのプレフィックス。
  x-mns-marker	Integer	いいえ	10	次のページの開始位置。前のレスポンスの NextMarker パラメーターからこのパラメーターの値を取得できます。
  x-mns-ret-number	Integer	いいえ	2	1 回のリクエストで返される最大結果数。 有効な値：1 ～ 1000。

  その他のリクエストヘッダーの詳細については、「共通パラメーター」をご参照ください。

• リクエスト本文

  なし。

レスポンス

レスポンスは次の部分で構成されます。

• HTTP ステータスコード

  HTTP/1.1 200 OK

• 操作固有のレスポンスヘッダー

  なし。

• レスポンス本文

  レスポンス本文は XML 形式です。 subscriptions のリストが返され、各 subscription には subscription URL が含まれます。 サブスクリプションの総数が x-mns-ret-number パラメーターの値を超える場合、次のページの開始位置を示す NextMarker パラメーターが返されます。

例

リクエストの例

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

成功レスポンスの例

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>