ALIYUN::MNS::Subscription is used to subscribe an endpoint to an Alibaba Cloud Message Service (MNS) topic. For a subscription to be created, the owner of the endpoint must confirm the subscription.
Syntax
{
"Type": "ALIYUN::MNS::Subscription",
"Properties": {
"Endpoint": String,
"NotifyStrategy": String,
"FilterTag": String,
"NotifyContentFormat": String,
"SubscriptionName": String,
"TopicName": String
}
}
Properties
Property | Type | Required | Editable | Description | Constraint |
---|---|---|---|---|---|
TopicName | String | Yes | No | The name of the topic. |
The name must be unique to an Alibaba Cloud account in a region. The name can be up to 256 characters in length and can contain letters, digits, and hyphens (-). It must start with a letter. |
SubscriptionName | String | Yes | No | The name of the subscription. | The name can be up to 256 characters in length and can contain letters, digits, and hyphens (-). It must start with a letter. |
Endpoint | String | Yes | No | The endpoint that the subscriber uses to receive messages. | Valid values:
|
FilterTag | String | No | No | The message filtering tag in the created subscription. | The parameter value can be up to 16 characters in length. By default, no messages
are filtered.
Note Only messages with consistent tags are pushed.
|
NotifyStrategy | String | No | Yes | The retry policy that is applied when an error occurs during message delivery to the endpoint. | Valid values:
|
NotifyContentFormat | String | No | No | The format of the message content pushed to the endpoint. | Valid values:
|
Response parameters
Fn::GetAtt
SubscriptionUrl: the URL of the created subscription.
Examples
{
"ROSTemplateFormatVersion": "2015-09-01",
"Resources": {
"Topic": {
"Type": "ALIYUN::MNS::Topic",
"Properties": {
"TopicName": "test"
}
},
"Subscription": {
"Type": "ALIYUN::MNS::Subscription",
"Properties": {
"TopicName": "test",
"SubscriptionName": "test",
"Endpoint": "http://your-endpoint.com",
"FilterTag": "AFilterTag",
"NotifyStrategy": "BACKOFF_RETRY",
"NotifyContentFormat": "XML"
}
},
"Outputs": {
"SubscriptionUrl": {
"Value": { "Fn::GetAtt": ["Subscription", "SubscriptionUrl"] }
}
}
}
}