Queries the parameters of a subscription.

Request

Each request consists of the following parts:

  • Request line

    GET /topics/$TopicName/subscriptions/$SubscriptionName HTTP/1.1

  • Operation-specific request headers

    None. For more information about common request headers, see Common parameters.

  • Request Body

    None.

Response

Each response consists of the following parts:

  • HTTP Status Code

    HTTP/1.1 200 OK

  • Operation-specific response headers

    None. For more information about common response headers, see Common parameters.

  • Response Body
    Parameter Description
    SubscriptionName The name of the subscription.
    Subscriber The account ID of the subscriber.
    TopicOwner The account ID of the topic owner.
    TopicName The name of the topic.
    Endpoint The endpoint to which the messages are pushed.
    NotifyStrategy The retry policy that is applied when an error occurs during message delivery to the endpoint.
    NotifyContentFormat The content format of the messages that are pushed to the endpoint.
    FilterTag The tag that is used to filter messages. Only the messages that are attached with the specified tag can be pushed.
    CreateTime The time when the subscription was created. The value is a timestamp that follows the UNIX time format. It is the number of seconds that have elapsed since 00:00:00 Thursday, January 1, 1970.
    LastModifyTime The time when the subscription was last modified. The value is a timestamp that follows the UNIX time format. It is the number of seconds that have elapsed since 00:00:00 Thursday, January 1, 1970.

Examples

Sample requests

GET /topics/$TopicName/subscriptions/$SubscriptionName HTTP/1.1
Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
Date: Tue, 08 Dec 2015 06:09:58 GMT
Authorization: MNS 15B4D3461F177624206A:GvaApggLQfMu6B6W5sbF6HEjV6Y=
x-mns-version: 2015-06-06

Sample success responses

HTTP/1.1 200 OK
Content-Type=text/xml;utf-8
Content-Length:451
x-mns-request-id:56667436B2B71C9C16000029
x-mns-version: 2015-06-06

<? xml version="1.0" encoding="utf-8"? >
<Subscription xmlns="http://mns.aliyuncs.com/doc/v1">
    <CreateTime>1449554806</CreateTime>
    <Endpoint>http://company.com</Endpoint>
    <FilterTag>important</FilterTag>
    <LastModifyTime>1449554962</LastModifyTime>
    <NotifyContentFormat>XML</NotifyContentFormat>
    <NotifyStrategy>BACKOFF_RETRY</NotifyStrategy>
    <SubscriptionName>$SubscriptionName</SubscriptionName>
    <Subscriber>$Subscriber</Subscriber>
    <TopicName>$TopicName</TopicName>
    <TopicOwner>$TopicOwner</TopicOwner>
</Subscription>        

Special error

Error code Error message HTTP status code
SubscriberNotExist The subscription you provided does not exist. 404