すべてのプロダクト
Search
ドキュメントセンター

Resource Orchestration Service:DATASOURCE::MNS::Subscriptions

最終更新日:Jan 16, 2025

DATASOURCE::MNS::Subscriptions は、サブスクリプションに関する情報を照会するために使用されます。

構文

{
  "Type": "DATASOURCE::MNS::Subscriptions",
  "Properties": {
    "SubscriptionName": String,
    "TopicName": String,
    "RefreshOptions": String
  }
}

プロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

SubscriptionName

String

いいえ

はい

サブスクリプション名。

なし。

TopicName

String

はい

はい

トピック名。

なし。

RefreshOptions

String

いいえ

はい

スタックが更新されたときのデータソースリソースの更新ポリシー。

有効な値:

  • Never(デフォルト): スタックが更新されたときにデータソースリソースを更新しません。

  • Always: スタックが更新されたときにデータソースリソースを更新します。

戻り値 (Fn::GetAtt)

  • SubscriptionIds: サブスクリプションの ID。

  • Subscriptions: サブスクリプションの詳細。

プロパティ

タイプ

説明

制約

SubscriptionIds

List

サブスクリプションの ID。

なし。

Subscriptions

List

サブスクリプションの詳細。

なし。

SubscriptionName

String

サブスクリプション名。

サブスクリプション名は最大 256 文字で、文字、数字、およびハイフン (-) を含めることができます。文字で始まる必要があります。

SubscriptionURL

String

サブスクリプションの URL。

なし。

Endpoint

String

メッセージを受信するために使用されるエンドポイント。

有効な値:

  • HttpEndpoint: このタイプのエンドポイントは http:// で始まる必要があります。

  • QueueEndpoint: このタイプのエンドポイントは acs:mns:{REGION}:{AccountID}:queues/{QueueName} 形式である必要があります。

  • MailEndpoint: このタイプのエンドポイントは mail:directmail:{MailAddress} 形式である必要があります。

  • SmsEndpoint: このタイプのエンドポイントは sms:directsms:anonymous または sms:directsms:{Phone} 形式である必要があります。

TopicOwner

String

サブスクライブされたトピックの所有者。

なし。

NotifyStrategy

String

システムがエンドポイントにメッセージをプッシュするときにエラーが発生した場合に適用される再試行ポリシー。

有効な値:

  • BACKOFF_RETRY (デフォルト)

  • EXPONENTIAL_DECAY_RETRY

再試行ポリシーの詳細については、「NotifyStrategy」をご参照ください。

NotifyContentFormat

String

システムがエンドポイントにプッシュするメッセージの形式。

有効な値:

  • XML (デフォルト)

  • JSON

  • SIMPLIFIED

CreateTime

String

サブスクリプションが作成された時刻。

なし。

LastModifyTime

String

サブスクリプションが最後に変更された時刻。

なし。

TopicName

String

サブスクライブされたトピックの名前。

なし。

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "SubscriptionName": {
      "Type": "String",
      "Description": "Subscription name."  // サブスクリプション名
    }
  },
  "Resources": {
    "Subscriptions": {
      "Type": "DATASOURCE::MNS::Subscriptions",
      "Properties": {
        "SubscriptionName": {
          "Ref": "SubscriptionName"
        }
      }
    }
  },
  "Outputs": {
    "Subscriptions": {
      "Description": "The list of subscriptions.", // サブスクリプションのリスト
      "Value": {
        "Fn::GetAtt": [
          "Subscriptions",
          "Subscriptions"
        ]
      }
    },
    "SubscriptionIds": {
      "Description": "The list of subscription names.", // サブスクリプション名のリスト
      "Value": {
        "Fn::GetAtt": [
          "Subscriptions",
          "SubscriptionIds"
        ]
      }
    }
  }
}
ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  SubscriptionName:
    Type: String
    Description: Subscription name. # サブスクリプション名
Resources:
  Subscriptions:
    Type: DATASOURCE::MNS::Subscriptions
    Properties:
      SubscriptionName:
        Ref: SubscriptionName
Outputs:
  Subscriptions:
    Description: The list of subscriptions. # サブスクリプションのリスト
    Value:
      Fn::GetAtt:
        - Subscriptions
        - Subscriptions
  SubscriptionIds:
    Description: The list of subscription names. # サブスクリプション名のリスト
    Value:
      Fn::GetAtt:
        - Subscriptions
        - SubscriptionIds