Simple Message Queue (旧称：MNS) (SMQ) キューを作成するために ALIYUN::MNS::Queue を使用します - Resource Orchestration Service

ALIYUN::MNS::Queue は、Simple Message Queue (旧 MNS) (SMQ) キューを作成するために使用されます。キューは、メッセージが格納される宛先アドレスです。キューは、標準キューと遅延キューに分類できます。

DelaySeconds プロパティがメッセージ送信時に指定されていない場合、標準キューに送信されたメッセージはすぐにコンシュームできますが、遅延キューに送信されたメッセージはプリセットされた遅延時間の経過後にのみコンシュームできます。

構文

{
  "Type": "ALIYUN::MNS::Queue",
  "Properties": {
    "PollingWaitSeconds": Integer,
    "LoggingEnabled": Boolean,
    "MessageRetentionPeriod": Integer,
    "MaximumMessageSize": Integer,
    "DelaySeconds": Integer,
    "VisibilityTimeout": Integer,
    "QueueName": String,
    "DlqPolicy": Map,
    "Tags": List
  }
}

プロパティ

プロパティ	タイプ	必須	編集可能	説明	制約
QueueName	String	はい	いいえ	キューの名前。	名前は、リージョン内の Alibaba Cloud アカウント内で一意である必要があります。名前は最大 256 文字で、文字、数字、およびハイフン (-) を含めることができます。文字または数字で始まる必要があります。
DelaySeconds	Integer	いいえ	はい	キューに送信されたすべてのメッセージをコンシュームできるようになるまでの遅延時間。	有効な値: 0 ～ 604800 (7 日間)。単位: 秒。デフォルト値: 0。
DlqPolicy	Map	いいえ	はい	デッドレターポリシー。	詳細については、「DlqPolicy プロパティ」をご参照ください。
MaximumMessageSize	Integer	いいえ	はい	キューに送信できるメッセージの最大サイズ。	有効な値: 1024 (1 KB) ～ 65536 (64 KB)。単位: バイト。デフォルト値: 65536 (64 KB)。
MessageRetentionPeriod	Integer	いいえ	はい	キュー内のメッセージの最大存続期間。このプロパティで指定された時間が経過すると、メッセージがコンシュームされているかどうかに関係なく、メッセージは削除されます。	有効な値: 60 (1 分) ～ 604800 (7 日間)。単位: 秒。デフォルト値: 345600 (4 日間)。
VisibilityTimeout	Integer	いいえ	はい	メッセージがキューからコンシュームされた後、非アクティブ状態が維持される期間。	有効な値: 1 ～ 43200 (12 時間)。単位: 秒。デフォルト値: 30。
PollingWaitSeconds	Integer	いいえ	はい	ReceiveMessage リクエストが、メッセージがキューに入るまで待機できる最大時間。	有効な値: 0 ～ 10。単位: 秒。デフォルト値: 0。
LoggingEnabled	Boolean	いいえ	はい	ログ管理機能を有効にするかどうかを指定します。	有効な値: true false (デフォルト)
Tags	List	いいえ	はい	タグ。	詳細については、「Tags プロパティ」をご参照ください。

DlqPolicy 構文

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

DlqPolicy プロパティ

プロパティ	タイプ	必須	編集可能	説明	制約
MaxReceiveCount	Integer	はい	はい	最大再試行回数。	なし。
DeadLetterTargetQueue	String	はい	はい	配信不能メッセージが配信される配信不能キュー。	なし。
Enabled	Boolean	はい	はい	配信不能メッセージの配信を有効にするかどうかを指定します。	なし。

Tags 構文

"Tags": [{
  "Key": String,
  "Value": String
}]

Tags プロパティ

プロパティ	タイプ	必須	編集可能	説明	制約
Key	String	はい	いいえ	タグキー。	なし。
Value	String	はい	いいえ	タグ値。	なし。

戻り値

Fn::GetAtt

QueueUrl: キューの URL。
ARN.WithSlash: キューの Alibaba Cloud リソースネーム (ARN)。
QueueName: キューの名前。

例

YAML

ROSTemplateFormatVersion: '2015-09-01'
Parameters: {}
Resources:
  Queue:
    Type: ALIYUN::MNS::Queue
    Properties:
      QueueName: TestQueue
      MessageRetentionPeriod: 345600
Outputs:
  QueueName:
    Description: Queue name
    Value:
      Fn::GetAtt:
        - Queue
        - QueueName
  ARN:
    Description: The ARN for ALIYUN::ROS::CustomResource
    Value:
      Fn::GetAtt:
        - Queue
        - ARN
  ARN.WithSlash:
    Description: 'The ARN: acs:mns:$region:$accountid:/queues/$queueName'
    Value:
      Fn::GetAtt:
        - Queue
        - ARN.WithSlash
  QueueUrl:
    Description: URL of created queue
    Value:
      Fn::GetAtt:
        - Queue
        - QueueUrl

JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
  },
  "Resources": {
    "Queue": {
      "Type": "ALIYUN::MNS::Queue",
      "Properties": {
        "QueueName": "TestQueue",
        "MessageRetentionPeriod": 345600
      }
    }
  },
  "Outputs": {
    "QueueName": {
      "Description": "Queue name",
      "Value": {
        "Fn::GetAtt": [
          "Queue",
          "QueueName"
        ]
      }
    },
    "ARN": {
      "Description": "The ARN for ALIYUN::ROS::CustomResource",
      "Value": {
        "Fn::GetAtt": [
          "Queue",
          "ARN"
        ]
      }
    },
    "ARN.WithSlash": {
      "Description": "The ARN: acs:mns:$region:$accountid:/queues/$queueName",
      "Value": {
        "Fn::GetAtt": [
          "Queue",
          "ARN.WithSlash"
        ]
      }
    },
    "QueueUrl": {
      "Description": "URL of created queue",
      "Value": {
        "Fn::GetAtt": [
          "Queue",
          "QueueUrl"
        ]
      }
    }
  }
}

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