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

Resource Orchestration Service:ALIYUN::AMQP::Queue

最終更新日:Jun 23, 2026

キューを作成します。

構文

{
  "Type": "ALIYUN::AMQP::Queue",
  "Properties": {
    "DeadLetterExchange": String,
    "MaximumPriority": Number,
    "InstanceId": String,
    "ExclusiveState": Boolean,
    "DeadLetterRoutingKey": String,
    "VirtualHost": String,
    "MaxLength": Number,
    "AutoDeleteState": Boolean,
    "QueueName": String,
    "MessageTTL": Number,
    "AutoExpireState": Number
  }
}

プロパティ

プロパティ名

タイプ

必須

更新可能

説明

制約

InstanceId

文字列

はい

いいえ

インスタンス ID。

なし

QueueName

文字列

はい

いいえ

キュー名。

キュー名は、次の要件を満たす必要があります。

  • 名前に使用できる文字は、英字、数字、ハイフン (-)、アンダースコア (_)、ピリオド (.)、番号記号 (#)、スラッシュ (/)、アットマーク (@) です。 長さは 1~255 文字です。

  • キューの作成後にキュー名を変更することはできません。 名前を変更するには、キューを削除して新しいキューを作成します。

VirtualHost

文字列

はい

いいえ

仮想ホストの名前。

名前に使用できる文字は、英字、数字、ハイフン (-)、アンダースコア (_)、ピリオド (.)、番号記号 (#)、スラッシュ (/)、アットマーク (@) です。

長さは 1~255 文字です。

AutoDeleteState

ブール値

いいえ

いいえ

キューを自動的に削除するかどうかを指定します。

有効値:

  • true:自動削除が有効になります。

    最後のコンシューマーがサブスクライブを解除すると、キューは自動的に削除されます。

  • false:キューは自動的に削除されません。

AutoExpireState

数値

いいえ

いいえ

キューの自動有効期限。

指定された時間内にアクセスされない場合、キューは自動的に削除されます。

説明

この機能は、このパラメーターを使用する前に有効にする必要があります。 この機能を有効にするには、チケットを送信してください。

DeadLetterExchange

文字列

いいえ

いいえ

デッドレターエクスチェンジ。

デッドレターエクスチェンジは、拒否されたメッセージを受信します。

コンシューマーがメッセージを拒否し、そのメッセージが再キューイングされない場合、ApsaraMQ for RabbitMQ はメッセージを指定されたデッドレターエクスチェンジにルーティングします。 その後、デッドレターエクスチェンジはメッセージをストレージ用のバインドされたキューにルーティングします。

DeadLetterRoutingKey

文字列

いいえ

いいえ

デッドレタールーティングキー。

キーに使用できる文字は、英字、数字、ハイフン (-)、アンダースコア (_)、ピリオド (.)、番号記号 (#)、スラッシュ (/)、アットマーク (@) です。

長さは 1~255 文字です。

ExclusiveState

ブール値

いいえ

いいえ

キューが排他であるかどうかを指定します。

有効値:

  • true:キューは排他です。

    排他キューは、それを宣言した接続によってのみ使用できます。 接続が閉じられると、自動的に削除されます。

  • false:キューは排他ではありません。

MaximumPriority

数値

いいえ

いいえ

優先度キュー機能はサポートされていません。

なし

MaxLength

数値

いいえ

いいえ

キューに格納できるメッセージの最大数。

このパラメーターは現在のバージョンではサポートされていません。

メッセージの最大数を超えると、キュー内の最も古いメッセージが削除されます。

MessageTTL

数値

いいえ

いいえ

キュー内のメッセージ TTL。

要件:

  • メッセージは、指定された TTL を超えてキューに保持されると期限切れになります。

  • TTL は 0 以上の整数である必要があります。 最大値は 1 日です。 単位はミリ秒です。 たとえば、TTL が 1000 の場合、メッセージは最大 1 秒間キューに保持できることを意味します。

戻り値

Fn::GetAtt

QueueName:キュー名。

例

YAML 形式

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  InstanceId:
    Type: String
    Description: インスタンス ID。
  VirtualHost:
    Type: String
    Description: 仮想ホストの名前。
  QueueName:
    Type: String
    Description: キュー名。
    MaxLength: 255
Resources:
  Queue:
    Type: ALIYUN::AMQP::Queue
    Properties:
      InstanceId:
        Ref: InstanceId
      VirtualHost:
        Ref: VirtualHost
      QueueName:
        Ref: QueueName
Outputs:
  QueueName:
    Description: キュー名。
    Value:
      Fn::GetAtt:
        - Queue
        - QueueName

JSON 形式

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "InstanceId": {
      "Type": "String",
      "Description": "インスタンス ID。"
    },
    "VirtualHost": {
      "Type": "String",
      "Description": "仮想ホストの名前。"
    },
    "QueueName": {
      "Type": "String",
      "Description": "キュー名。",
      "MaxLength": 255
    }
  },
  "Resources": {
    "Queue": {
      "Type": "ALIYUN::AMQP::Queue",
      "Properties": {
        "InstanceId": {
          "Ref": "InstanceId"
        },
        "VirtualHost": {
          "Ref": "VirtualHost"
        },
        "QueueName": {
          "Ref": "QueueName"
        }
      }
    }
  },
  "Outputs": {
    "QueueName": {
      "Description": "キュー名。",
      "Value": {
        "Fn::GetAtt": [
          "Queue",
          "QueueName"
        ]
      }
    }
  }
}