All Products
Search
Document Center

Resource Orchestration Service:ALIYUN::AMQP::Queue

Last Updated:Jun 23, 2026

Membuat sebuah queue.

Sintaks

{
  "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
  }
}

Properti

Property Name

Type

Required

Update allowed

Description

Constraints

InstanceId

String

Yes

No

ID instans.

None

QueueName

String

Yes

No

Nama queue.

Nama queue harus memenuhi persyaratan berikut:

  • Nama dapat berisi huruf, angka, tanda hubung (-), garis bawah (_), titik (.), tanda pagar (#), garis miring (/), dan tanda at (@). Panjang nama harus antara 1 hingga 255 karakter.

  • Nama queue tidak dapat diubah setelah queue dibuat. Untuk mengganti nama, hapus queue tersebut dan buat yang baru.

VirtualHost

String

Yes

No

Nama vhost.

Nama dapat berisi huruf, angka, tanda hubung (-), garis bawah (_), titik (.), tanda pagar (#), garis miring (/), dan tanda at (@).

Panjangnya harus antara 1 hingga 255 karakter.

AutoDeleteState

Boolean

No

No

Menentukan apakah queue akan dihapus secara otomatis.

Nilai yang valid:

  • true: Penghapusan otomatis diaktifkan.

    Queue akan dihapus secara otomatis setelah konsumen terakhir berhenti berlangganan darinya.

  • false: Queue tidak dihapus secara otomatis.

AutoExpireState

Number

No

No

Waktu kedaluwarsa otomatis queue.

Queue akan dihapus secara otomatis jika tidak diakses dalam rentang waktu yang ditentukan.

Catatan

Fitur ini harus diaktifkan terlebih dahulu sebelum Anda dapat menggunakan parameter ini. Untuk mengaktifkannya, submit a ticket.

DeadLetterExchange

String

No

No

Dead-letter exchange.

Dead-letter exchange menerima pesan yang ditolak.

Jika konsumen menolak sebuah pesan dan pesan tersebut tidak dimasukkan kembali ke antrian, ApsaraMQ for RabbitMQ akan mengarahkan pesan tersebut ke dead-letter exchange yang ditentukan. Dead-letter exchange kemudian mengarahkan pesan tersebut ke queue yang terikat untuk disimpan.

DeadLetterRoutingKey

String

No

No

Dead-letter routing key.

Kunci dapat berisi huruf, angka, tanda hubung (-), garis bawah (_), titik (.), tanda pagar (#), garis miring (/), dan tanda at (@).

Panjangnya harus antara 1 hingga 255 karakter.

ExclusiveState

Boolean

No

No

Menentukan apakah exchange bersifat eksklusif.

Nilai yang valid:

  • true: Exchange bersifat eksklusif.

    Exchange eksklusif hanya dapat digunakan oleh Connection yang mendeklarasikannya. Exchange tersebut akan dihapus secara otomatis ketika Connection ditutup.

  • false: Exchange tidak eksklusif.

MaximumPriority

Number

No

No

Prioritas bukan merupakan fitur yang didukung.

None

MaxLength

Number

No

No

Jumlah maksimum pesan yang dapat disimpan dalam queue.

Parameter ini tidak didukung pada versi saat ini.

Jika jumlah maksimum pesan terlampaui, pesan paling awal dalam queue akan dihapus.

MessageTTL

Number

No

No

Waktu hidup (TTL) pesan dalam queue.

Persyaratan:

  • Pesan kedaluwarsa jika disimpan dalam queue lebih lama dari TTL yang ditentukan.

  • TTL harus berupa bilangan bulat non-negatif. Nilai maksimum adalah 1 hari. Satuannya adalah milidetik. Contohnya, TTL 1000 berarti pesan dapat disimpan dalam queue maksimal selama 1 detik.

Nilai kembalian

Fn::GetAtt

QueueName: Nama queue.

Contoh

YAML format

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  InstanceId:
    Type: String
    Description: ID instans.
  VirtualHost:
    Type: String
    Description: Nama virtual host.
  QueueName:
    Type: String
    Description: Nama queue.
    MaxLength: 255
Resources:
  Queue:
    Type: ALIYUN::AMQP::Queue
    Properties:
      InstanceId:
        Ref: InstanceId
      VirtualHost:
        Ref: VirtualHost
      QueueName:
        Ref: QueueName
Outputs:
  QueueName:
    Description: Nama queue.
    Value:
      Fn::GetAtt:
        - Queue
        - QueueName

JSON format

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "InstanceId": {
      "Type": "String",
      "Description": "ID instans."
    },
    "VirtualHost": {
      "Type": "String",
      "Description": "Nama virtual host."
    },
    "QueueName": {
      "Type": "String",
      "Description": "Nama queue.",
      "MaxLength": 255
    }
  },
  "Resources": {
    "Queue": {
      "Type": "ALIYUN::AMQP::Queue",
      "Properties": {
        "InstanceId": {
          "Ref": "InstanceId"
        },
        "VirtualHost": {
          "Ref": "VirtualHost"
        },
        "QueueName": {
          "Ref": "QueueName"
        }
      }
    }
  },
  "Outputs": {
    "QueueName": {
      "Description": "Nama queue.",
      "Value": {
        "Fn::GetAtt": [
          "Queue",
          "QueueName"
        ]
      }
    }
  }
}