All Products
Search
Document Center

Simple Message Queue (formerly MNS):CreateQueue

Last Updated:Jul 08, 2026

Membuat antrian.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

mns:CreateQueue

create

*Antrian.

acs:mns:{#regionId}:{#accountId}:/queues/{#QueueName}

  • mns:EnableLogging
None

Parameter permintaan

Parameter

Type

Required

Description

Example

QueueName

string

Yes

Nama antrian.

06273500-249F-5863-121D-74D51123****

MaximumMessageSize

integer

No

Ukuran maksimum body Paket yang dapat dikirim ke antrian. Unit: bytes.

Nilai valid: 1024 hingga 65536.

Nilai default: 65536.

65536

MessageRetentionPeriod

integer

No

Durasi maksimum penyimpanan Paket di antrian. Setelah durasi yang ditentukan berlalu sejak waktu Paket dikirim ke antrian, Paket akan dihapus terlepas dari apakah Paket telah dikonsumsi atau belum. Unit: detik.

Nilai valid: 60 hingga 604800.

Nilai default: 345600.

345600

VisibilityTimeout

integer

No

Durasi Paket yang dikonsumsi tetap dalam status Inactive setelah berubah dari status Active. Unit: detik.

Nilai valid: 1 hingga 43200.

Nilai default: 30.

60

PollingWaitSeconds

integer

No

Waktu tunggu maksimum untuk permintaan ReceiveMessage saat antrian kosong. Unit: detik.

Nilai valid: 0 hingga 30.

Nilai default: 0.

0

EnableLogging

boolean

No

Apakah akan mengaktifkan fitur manajemen log. Nilai valid:

  • true: Diaktifkan.

  • false: Dinonaktifkan.

Nilai default: false.

true

DelaySeconds

integer

No

Periode penundaan untuk semua Paket yang dikirim ke antrian. Paket yang dikirim ke antrian hanya dapat dikonsumsi setelah periode penundaan yang ditentukan oleh parameter ini berlalu. Unit: detik.

Nilai valid: 0 hingga 604800.

Nilai default: 0.

0

Tag

array<object>

No

Daftar tag Sumber daya.

object

No

Nilai tag yang sesuai dengan kunci tag.

Key

string

No

Kunci tag.

tag1

Value

string

No

Nilai tag.

test

DlqPolicy

object

No

Kebijakan dead-letter.

Enabled

boolean

No

Apakah akan mengaktifkan pengiriman Paket dead-letter.

true

DeadLetterTargetQueue

string

No

Antrian target untuk pengiriman Paket dead-letter.

deadLetterQueue

MaxReceiveCount

integer

No

Jumlah maksimum pengiriman Paket.

3

QueueType

string

No

Tipe antrian. Nilai valid:

  • normal: antrian standar.

  • fifo: antrian FIFO.

normal

TenantRateLimitPolicy

object

No

Kebijakan pembatasan laju.

Enabled

boolean

No

Apakah akan mengaktifkan pembatasan laju. Nilai valid:

  • true

  • false

false

MaxReceivesPerSecond

integer

No

Jumlah maksimum penerimaan per detik.

1000

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

06273500-249F-5863-121D-74D51123E62C

Code

integer

Kode tanggapan.

200

Status

string

Status tanggapan.

Success

Message

string

Paket tanggapan.

operation success

Success

boolean

Indikator keberhasilan permintaan.

true

Data

object

Data tanggapan.

Code

integer

Kode tanggapan.

200

Message

string

Paket tanggapan.

Success

boolean

Indikator keberhasilan permintaan.

true

Contoh

Respons sukses

JSONformat

{
  "RequestId": "06273500-249F-5863-121D-74D51123E62C",
  "Code": 200,
  "Status": "Success",
  "Message": "operation success",
  "Success": true,
  "Data": {
    "Code": 200,
    "Message": "无",
    "Success": true
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.