ListTopic

Description

This API is used to list the topics of an account. Querying by page is supported. To acquire a list of topics based on a specific prefix, set the x-mns-prefix parameter when calling this API.

Tips:

If the total number of topics returned for the current request exceeds the x-mns-ret-number value, the returned XML results include NextMarker to indicate the starting position of the next page, and this value is assigned to the x-mns-marker parameter in the next request to display the next page.

Request

A request includes the following parts:

Request line

GET /topics HTTP/1.1
Special request header

Parameter name	Description	Required/Optional
x-mns-marker	Starting position of the next page, which is acquired from NextMarker on the previous page	Optional
x-mns-ret-number	Maximum number of subscriptions returned for a single request, which is an integer in the range of 1 to 1,000. The default value is 1,000.	Optional
x-mns-prefix	Search for the topic names starting with the specified prefix	Optional

For details about other parameters, refer to **Call Method/Public Parameters**.

Request Body

None

Response

The response message includes three parts: return status line, HTTP header, and message body.

HTTP Status Code

HTTP/1.1 200 OK
Special response header

None. For details, refer to Call method/Public parameters.
Response Body

The returned results are in XML format. The top-layer Topics element contains multiple Topic elements, and each Topic element contains the TopicURL element indicating the URL of the topic.If the number of returned queues exceeds the x-mns-ret-number value, the NextMarker element is included to indicate the starting position of the next page.

Request example:

GET /topics HTTP/1.1
x-mns-ret-number:2
Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
Date: Tue, 08 Dec 2015 05:59:22 GMT
Authorization: NS15B4D3461F177624206A:ytChIeJt2klpvFxGCgVsPNI015k=
x-mns-version: 2015-06-06

Response example:

    HTTP/1.1 200 OK
    x-mns-request-id:566671BAB2B71C9C16000019 
    x-mns-version: 2015-06-06
    <?xml version="1.0" encoding="utf-8"?>
    <Topics xmlns="http://mns.aliyuncs.com/doc/v1/">
        <Topic>
            <TopicURL>http://$AccountId.mns.cn-hangzhou.aliyuncs.com/topics/$TopicName1</TopicURL>
        </Topic>
        <Topic>
            <TopicURL>http://$AccountId.mns.cn-hangzhou.aliyuncs.com/topics/$TopicName2</TopicURL>
        </Topic>
        <NextMarker>OTczNjU4MTcvYmRwejd6NXluby8yNjg0Mi9UZXN0VG9waWMtMy8w</NextMarker>
    </Topics>