CreateQueue - Simple Message Queue (formerly MNS)

Operasi CreateQueue digunakan untuk membuat sebuah queue.

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

*Queue

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

mns:EnableLogging

None

Parameter permintaan

Parameter	Type	Required	Description	Example
QueueName	string	Yes	Nama queue.	06273500-249F-5863-121D-74D51123****
MaximumMessageSize	integer	No	Panjang maksimum isi pesan yang dapat dikirim ke queue. Nilai yang valid: 1024 hingga 65536. Satuan: byte. Nilai default: 65536.	65536
MessageRetentionPeriod	integer	No	Masa hidup (TTL) maksimum untuk sebuah pesan dalam queue. Setelah periode yang ditentukan berakhir, pesan akan dihapus, terlepas dari apakah pesan tersebut telah diambil atau belum. Nilai yang valid: 60 hingga 604800. Satuan: detik. Nilai default: 345600.	345600
VisibilityTimeout	integer	No	Durasi selama pesan tetap berada dalam status Inactive setelah diambil dari queue. Nilai yang valid: 1 hingga 43200. Satuan: detik. Nilai default: 30.	60
PollingWaitSeconds	integer	No	Waktu maksimum permintaan ReceiveMessage dapat menunggu jika tidak ada pesan yang tersedia dalam queue. Nilai yang valid: 0 hingga 30. Satuan: detik. Nilai default: 0.	0
EnableLogging	boolean	No	Menentukan apakah fitur Log Management diaktifkan. Nilai yang valid adalah sebagai berikut: true: Aktifkan. false: Nonaktifkan. Nilai default: false.	true
DelaySeconds	integer	No	Periode penundaan untuk semua pesan yang dikirim ke queue. Pesan hanya dapat dikonsumsi setelah periode penundaan yang ditentukan berakhir. Nilai yang valid: 0 hingga 604800. Satuan: detik. Nilai default: 0.	0
Tag	array<object>	No	Daftar tag resource.
	object	No	Objek tag.
Key	string	No	Kunci tag.	tag1
Value	string	No	Nilai tag.	test
DlqPolicy	object	No	Kebijakan dead-letter queue (DLQ).
Enabled	boolean	No	Menentukan apakah pengiriman pesan dead-letter diaktifkan.	true
DeadLetterTargetQueue	string	No	Queue target untuk pengiriman pesan gagal.	deadLetterQueue
MaxReceiveCount	integer	No	Jumlah maksimum kali sebuah pesan dapat dikirimkan.	3
QueueType	string	No	Tipe queue. Nilai yang valid: normal: standard queue fifo: FIFO queue	normal
TenantRateLimitPolicy	object	No	Kebijakan pembatasan laju.
Enabled	boolean	No	Menentukan apakah pembatasan laju diaktifkan. Nilai yang 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 respons.	200
Status	string	Status respons.	Success
Message	string	Pesan respons.	operation success
Success	boolean	Menunjukkan apakah permintaan berhasil.	true
Data	object	Data respons.
Code	integer	Kode respons.	200
Message	string	Pesan respons.	无
Success	boolean	Menunjukkan apakah permintaan berhasil.	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.