全部产品
Search
文档中心

Resource Orchestration Service:ALIYUN::MNS::Subscription

更新时间:Jun 26, 2025

ALIYUN::MNS::Subscription digunakan untuk menggambarkan hubungan langganan, termasuk topik yang dilanggan dan titik akhir yang digunakan oleh subscriber untuk menerima pesan.

Sintaksis

{
  "Type": "ALIYUN::MNS::Subscription",
  "Properties": {
    "Endpoint": String,
    "NotifyStrategy": String,
    "FilterTag": String,
    "NotifyContentFormat": String,
    "SubscriptionName": String,
    "TopicName": String,
    "DlqPolicy": Map,
    "PushType": String
  }
}

Properti

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

TopicName

String

Ya

Tidak

Nama dari topik.

Nama topik harus unik dalam satu akun Alibaba Cloud di suatu wilayah.

Nama dapat memiliki panjang hingga 256 karakter dan dapat berisi huruf, angka, dan tanda hubung (-). Nama harus dimulai dengan huruf.

SubscriptionName

String

Ya

Tidak

Nama dari langganan.

Nama dapat memiliki panjang hingga 256 karakter dan dapat berisi huruf, angka, dan tanda hubung (-). Nama harus dimulai dengan huruf.

Endpoint

String

Ya

Tidak

Titik akhir yang digunakan oleh subscriber untuk menerima pesan.

Nilai valid:

  • HttpEndpoint: Jenis titik akhir ini harus diawali dengan http://.

  • QueueEndpoint: Jenis titik akhir ini harus dalam format acs:mns:{REGION}:{AccountID}:queues/{QueueName}.

  • MailEndpoint: Jenis titik akhir ini harus dalam format mail:directmail:{MailAddress}.

  • SmsEndpoint: Jenis titik akhir ini harus dalam format sms:directsms:anonymous atau sms:directsms:{Phone}.

FilterTag

String

Tidak

Tidak

Tag penyaringan pesan dalam langganan.

Tag dapat memiliki panjang hingga 16 karakter. Secara default, tidak ada pesan yang disaring.

Catatan

Hanya pesan dengan tag yang sama yang akan didorong.

NotifyStrategy

String

Tidak

Ya

Kebijakan ulang yang diterapkan ketika terjadi kesalahan saat pengiriman pesan ke titik akhir.

Nilai valid:

  • BACKOFF_RETRY (default)

  • EXPONENTIAL_DECAY_RETRY

NotifyContentFormat

String

Tidak

Tidak

Format konten pesan yang didorong ke titik akhir.

Nilai valid:

  • XML (default)

  • JSON

  • SIMPLIFIED

DlqPolicy

Map

Tidak

Ya

Kebijakan surat mati.

Untuk informasi lebih lanjut, lihat bagian "Properti DlqPolicy" dari topik ini.

PushType

String

Tidak

Tidak

Jenis terminal.

Nilai valid:

  • http: Layanan HTTP.

  • queue: antrian.

  • mpush: perangkat seluler.

  • alisms: Alibaba Cloud Short Message Service (SMS).

  • email: email.

Sintaksis DlqPolicy

"DlqPolicy": {
  "DeadLetterTargetQueue": String,
  "Enabled": Boolean
}

Properti DlqPolicy

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

DeadLetterTargetQueue

String

Ya

Ya

Antrian untuk mengirimkan pesan surat mati.

Tidak ada.

Enabled

Boolean

Ya

Ya

Menentukan apakah akan mengaktifkan pengiriman pesan surat mati.

Tidak ada.

Nilai kembali

Fn::GetAtt

  • SubscriptionUrl: URL dari langganan yang dibuat.

  • SubscriptionName: nama dari langganan yang dibuat.

  • TopicName: nama dari topik.

Contoh

ROSTemplateFormatVersion: '2015-09-01'
Parameters: {}
Resources:
  Subscription:
    Type: ALIYUN::MNS::Subscription
    Properties:
      TopicName: TestTopic
      SubscriptionName: TestSubscription
      Endpoint: http://endpoint.com
Outputs:
  SubscriptionUrl:
    Description: URL of created subscription
    Value:
      Fn::GetAtt:
        - Subscription
        - SubscriptionUrl
  SubscriptionName:
    Description: Subscription name
    Value:
      Fn::GetAtt:
        - Subscription
        - SubscriptionName
  TopicName:
    Description: Topic name
    Value:
      Fn::GetAtt:
        - Subscription
        - TopicName
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
  },
  "Resources": {
    "Subscription": {
      "Type": "ALIYUN::MNS::Subscription",
      "Properties": {
        "TopicName": "TestTopic",
        "SubscriptionName": "TestSubscription",
        "Endpoint": "http://endpoint.com"
      }
    }
  },
  "Outputs": {
    "SubscriptionUrl": {
      "Description": "URL of created subscription",
      "Value": {
        "Fn::GetAtt": [
          "Subscription",
          "SubscriptionUrl"
        ]
      }
    },
    "SubscriptionName": {
      "Description": "Subscription name",
      "Value": {
        "Fn::GetAtt": [
          "Subscription",
          "SubscriptionName"
        ]
      }
    },
    "TopicName": {
      "Description": "Topic name",
      "Value": {
        "Fn::GetAtt": [
          "Subscription",
          "TopicName"
        ]
      }
    }
  }
}

Untuk lebih banyak contoh, kunjungi subscription.yml. Dalam contoh-contoh tersebut, jenis sumber daya ALIYUN::MNS::Topic, ALIYUN::MNS::Queue, dan ALIYUN::MNS::Subscription digunakan.