ALIYUN::MNS::Subscription リソースタイプリファレンス - ROS

ALIYUN::MNS::Subscription は、サブスクライブされた Topic と、サブスクライバーがメッセージを受信するために使用するエンドポイントを含む、サブスクリプション関係を記述するために使用されます。

構文

{
  "Type": "ALIYUN::MNS::Subscription",
  "Properties": {
    "Endpoint": String, // エンドポイント
    "NotifyStrategy": String, // 通知戦略
    "FilterTag": String, // フィルタタグ
    "NotifyContentFormat": String, // 通知コンテンツフォーマット
    "SubscriptionName": String, // サブスクリプション名
    "TopicName": String, // Topic名
    "DlqPolicy": Map, // デッドレターキューポリシー
    "PushType": String // プッシュタイプ
  }
}

プロパティ

プロパティ	タイプ	必須	編集可能	説明	制約
TopicName	String	はい	いいえ	Topic の名前。	トピック名は、リージョン内のAlibaba Cloudアカウント内で一意である必要があります。名前は最大 256 文字で、文字、数字、およびハイフン（-）を含めることができます。文字で始まる必要があります。
SubscriptionName	String	はい	いいえ	サブスクリプションの名前。	名前は最大 256 文字で、文字、数字、およびハイフン (-) を含めることができます。文字で始まる必要があります。
Endpoint	String	はい	いいえ	サブスクライバーがメッセージを受信するために使用するエンドポイント。	有効な値： HttpEndpoint: このタイプのエンドポイントは、`http://` というプレフィックスが付いている必要があります。 QueueEndpoint: このタイプのエンドポイントは、`acs:mns:{REGION}:{AccountID}:queues/{QueueName}` 形式である必要があります。 MailEndpoint: このタイプのエンドポイントは、`mail:directmail:{MailAddress}` 形式である必要があります。 SmsEndpoint: このタイプのエンドポイントは、`sms:directsms:anonymous` または `sms:directsms:{Phone}` 形式である必要があります。
FilterTag	String	いいえ	いいえ	サブスクリプション内のメッセージフィルタリングタグ。	タグは最大 16 文字まで使用できます。デフォルトでは、メッセージはフィルタリングされません。説明同じタグを持つメッセージのみがプッシュされます。
NotifyStrategy	String	いいえ	はい	メッセージがエンドポイントに配信される際にエラーが発生した場合に適用されるリトライポリシー。	有効な値： BACKOFF_RETRY (デフォルト) EXPONENTIAL_DECAY_RETRY
NotifyContentFormat	String	いいえ	いいえ	エンドポイントにプッシュされるメッセージコンテンツの形式。	有効な値： XML (デフォルト) JSON SIMPLIFIED
DlqPolicy	Map	いいえ	はい	デッドレターポリシー。	詳細については、このトピックの「DlqPolicy プロパティ」セクションをご参照ください。
PushType	String	いいえ	いいえ	端末タイプ。	有効な値 http: HTTP サービス。 queue: キュー。 mpush: モバイルデバイス。 alisms: Alibaba Cloud ショートメッセージサービス (SMS)。 email: メール。

DlqPolicy 構文

"DlqPolicy": {
  "DeadLetterTargetQueue": String, // デッドレターメッセージ配信先キュー
  "Enabled": Boolean // 有効化フラグ
}

DlqPolicy プロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

DeadLetterTargetQueue

String

はい

デッドレターメッセージを配信するキュー。

なし。

Enabled

Boolean

はい

デッドレターメッセージの配信を有効にするかどうかを指定します。

なし。

戻り値

Fn::GetAtt

SubscriptionUrl: 作成されたサブスクリプションの URL。
SubscriptionName: 作成されたサブスクリプションの名前。
TopicName: Topic の名前。

例

YAML

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

JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
  },
  "Resources": {
    "Subscription": {
      "Type": "ALIYUN::MNS::Subscription",
      "Properties": {
        "TopicName": "TestTopic",
        "SubscriptionName": "TestSubscription",
        "Endpoint": "http://endpoint.com"
      }
    }
  },
  "Outputs": {
    "SubscriptionUrl": {
      "Description": "作成されたサブスクリプションの URL",
      "Value": {
        "Fn::GetAtt": [
          "Subscription",
          "SubscriptionUrl"
        ]
      }
    },
    "SubscriptionName": {
      "Description": "サブスクリプション名",
      "Value": {
        "Fn::GetAtt": [
          "Subscription",
          "SubscriptionName"
        ]
      }
    },
    "TopicName": {
      "Description": "Topic 名",
      "Value": {
        "Fn::GetAtt": [
          "Subscription",
          "TopicName"
        ]
      }
    }
  }
}

その他の例については、subscription.yml をご覧ください。例では、ALIYUN::MNS::Topic、ALIYUN::MNS::Queue、および ALIYUN::MNS::Subscription リソースタイプが使用されています。