全部产品
Search
文档中心

Resource Orchestration Service:ALIYUN::MNS::Queue

更新时间:Aug 02, 2025

ALIYUN::MNS::Queue digunakan untuk membuat Simple Message Queue (sebelumnya MNS) (SMQ) antrian. Antrian adalah alamat tujuan tempat pesan disimpan. Antrian dapat diklasifikasikan menjadi antrian standar dan antrian tertunda.

Jika properti DelaySeconds tidak ditentukan saat mengirim pesan, pesan yang dikirim ke antrian standar dapat langsung dikonsumsi. Namun, pesan yang dikirim ke antrian tertunda hanya dapat dikonsumsi setelah waktu tunda yang telah ditentukan.

Sintaksis

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

Properti

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Kendala

QueueName

String

Ya

Tidak

Nama antrian.

Nama harus unik dalam akun Alibaba Cloud di suatu wilayah.

Nama dapat memiliki panjang hingga 256 karakter dan dapat berisi huruf, angka, dan tanda hubung (-). Harus dimulai dengan huruf atau angka.

DelaySeconds

Integer

Tidak

Ya

Waktu tunda setelah semua pesan yang dikirim ke antrian dapat dikonsumsi.

Nilai valid: 0 hingga 604800 (7 hari).

Satuan: detik.

Nilai default: 0.

DlqPolicy

Map

Tidak

Ya

Kebijakan antrian pesan gagal.

Untuk informasi lebih lanjut, lihat Properti DlqPolicy.

MaximumMessageSize

Integer

Tidak

Ya

Ukuran maksimum pesan yang dapat dikirim ke antrian.

Nilai valid: 1024 (1 KB) hingga 65536 (64 KB).

Satuan: byte.

Nilai default: 65536 (64 KB).

MessageRetentionPeriod

Integer

Tidak

Ya

Masa hidup maksimum pesan dalam antrian. Setelah waktu yang ditentukan oleh properti ini habis, pesan akan dihapus, terlepas dari apakah pesan tersebut telah dikonsumsi.

Nilai valid: 60 (1 menit) hingga 604800 (7 hari).

Satuan: detik.

Nilai default: 345600 (4 hari).

VisibilityTimeout

Integer

Tidak

Ya

Durasi pesan tetap dalam keadaan Tidak Aktif setelah dikonsumsi dari antrian.

Nilai valid: 1 hingga 43200 (12 jam).

Satuan: detik.

Nilai default: 30.

PollingWaitSeconds

Integer

Tidak

Ya

Periode waktu maksimum permintaan ReceiveMessage dapat menunggu hingga pesan ada di antrian.

Nilai valid: 0 hingga 10.

Satuan: detik.

Nilai default: 0.

LoggingEnabled

Boolean

Tidak

Ya

Menentukan apakah fitur manajemen log diaktifkan.

Nilai valid:

  • true

  • false (default)

Tags

List

Tidak

Ya

Tag.

Untuk informasi lebih lanjut, lihat Properti Tags.

Sintaksis DlqPolicy

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

Properti DlqPolicy

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Kendala

MaxReceiveCount

Integer

Ya

Ya

Jumlah maksimum percobaan ulang.

Tidak ada.

DeadLetterTargetQueue

String

Ya

Ya

Antrian pesan gagal tempat pesan gagal dikirim.

Tidak ada.

Enabled

Boolean

Ya

Ya

Menentukan apakah pengiriman pesan gagal diaktifkan.

Tidak ada.

Sintaksis Tags

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

Properti Tags

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Kendala

Key

String

Ya

Tidak

Kunci tag.

Tidak ada.

Value

String

Ya

Tidak

Nilai tag.

Tidak ada.

Nilai kembali

Fn::GetAtt

  • QueueUrl: URL antrian.

  • ARN.WithSlash: Nama Sumber Daya Alibaba Cloud (ARN) dari antrian.

  • QueueName: Nama antrian.

Contoh

ROSTemplateFormatVersion: '2015-09-01'
Parameters: {}
Resources:
  Queue:
    Type: ALIYUN::MNS::Queue
    Properties:
      QueueName: TestQueue
      MessageRetentionPeriod: 345600
Outputs:
  QueueName:
    Description: Nama antrian
    Value:
      Fn::GetAtt:
        - Queue
        - QueueName
  ARN:
    Description: ARN untuk ALIYUN::ROS::CustomResource
    Value:
      Fn::GetAtt:
        - Queue
        - ARN
  ARN.WithSlash:
    Description: 'ARN: acs:mns:$region:$accountid:/queues/$queueName'
    Value:
      Fn::GetAtt:
        - Queue
        - ARN.WithSlash
  QueueUrl:
    Description: URL antrian yang dibuat
    Value:
      Fn::GetAtt:
        - Queue
        - QueueUrl
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
  },
  "Resources": {
    "Queue": {
      "Type": "ALIYUN::MNS::Queue",
      "Properties": {
        "QueueName": "TestQueue",
        "MessageRetentionPeriod": 345600
      }
    }
  },
  "Outputs": {
    "QueueName": {
      "Description": "Nama antrian",
      "Value": {
        "Fn::GetAtt": [
          "Queue",
          "QueueName"
        ]
      }
    },
    "ARN": {
      "Description": "ARN untuk ALIYUN::ROS::CustomResource",
      "Value": {
        "Fn::GetAtt": [
          "Queue",
          "ARN"
        ]
      }
    },
    "ARN.WithSlash": {
      "Description": "ARN: acs:mns:$region:$accountid:/queues/$queueName",
      "Value": {
        "Fn::GetAtt": [
          "Queue",
          "ARN.WithSlash"
        ]
      }
    },
    "QueueUrl": {
      "Description": "URL antrian yang dibuat",
      "Value": {
        "Fn::GetAtt": [
          "Queue",
          "QueueUrl"
        ]
      }
    }
  }
}

Untuk lebih banyak contoh, kunjungi subscription.yml. Pada contoh tersebut, jenis sumber daya ALIYUN::MNS::Topic, ALIYUN::MNS::Queue, dan ALIYUN::MNS::Subscription digunakan.