:ListSubscriptionByTopic

Autorisation

Par défaut, seuls les comptes Alibaba Cloud peuvent appeler cette opération. Les utilisateurs RAM ne peuvent l'appeler qu'après avoir reçu les autorisations appropriées. Le tableau suivant décrit les informations d'autorisation liées à cette opération. Pour plus d'informations, consultez la rubrique Stratégies et exemples d'autorisation.

description

Si le nombre total de souscriptions dépasse la valeur du paramètre x-mns-ret-number spécifié dans la requête, le paramètre NextMarker indiquant la position de départ de la page suivante est renvoyé. Lors de l'envoi d'une nouvelle requête pour interroger les souscriptions restantes, vous devez définir le paramètre x-mns-marker sur la valeur renvoyée par le paramètre NextMarker.

Requête

Une requête se compose des éléments suivants :

• Ligne de requête

  GET /topics/$TopicName/subscriptions HTTP/1.1

• En-têtes de requête spécifiques à l'opération

  Paramètre	type	Obligatoire	Exemple	description
  x-mns-prefix	string	Non	topic	Préfixe des souscriptions à interroger.
  x-mns-marker	Integer	Non	10	Position de départ de la page suivante. Vous pouvez récupérer la valeur de ce paramètre à partir du paramètre NextMarker présent dans la réponse précédente.
  x-mns-ret-number	Integer	Non	2	Nombre maximal de résultats pouvant être renvoyés pour une seule requête. Plage de valeurs valides : 1 à 1000.

  Pour plus d'informations sur les autres en-têtes de requête, consultez la rubrique Paramètres communs.

• Corps de la requête

  Aucun.

Réponse

Une réponse se compose des éléments suivants :

• Code d'état HTTP

  HTTP/1.1 200 OK

• En-têtes de réponse spécifiques à l'opération

  Aucun.

• Corps de la réponse

  Le corps de la réponse est au format XML. Une liste de subscriptions est renvoyée ; chaque subscription inclut une subscription URL. Si le nombre total de souscriptions dépasse la valeur du paramètre x-mns-ret-number, le paramètre NextMarker indiquant la position de départ de la page suivante est renvoyé.

Exemples

Exemple de requête

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

Exemple de réponse réussie

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>