Memodifikasi antrian.
Otorisasi
Secara default, hanya akun Alibaba Cloud yang dapat memanggil operasi ini. Pengguna RAM hanya dapat memanggil operasi ini setelah diberikan izin terkait. Tabel berikut menjelaskan informasi otorisasi untuk operasi ini. Untuk informasi lebih lanjut, lihat Kebijakan izin dan contoh.
| Nama | Nilai |
| API | SetQueueAttributes |
| Aksi | mns:SetQueueAttributes |
| Item | acs:mns:$region:$accountid:/queues/$queueName |
Permintaan
Sebuah permintaan terdiri dari bagian-bagian berikut:
- Baris permintaan
PUT /queues/$queueName?metaoverride=true HTTP/1.1 - Parameter URI
Untuk memodifikasi parameter antrian, tentukan
metaoverride=truedalam URI. - Header permintaan spesifik operasi
Tidak ada.
Badan Permintaan
Badan permintaan dalam format XML. Parameter antrian dapat disertakan dalam badan permintaan. Semua parameter bersifat opsional.
Parameter Tipe Diperlukan Contoh Deskripsi DelaySeconds Integer Tidak. 0 Periode penundaan setelah semua pesan yang dikirim ke antrian dapat dikonsumsi. Nilai valid: 0 hingga 604800. Unit: detik.
Nilai default: 0.
MaximumMessageSize Integer Tidak. 1024 Ukuran maksimum tubuh pesan yang dapat dikirim ke antrian. Nilai valid: 1024 hingga 65536. Unit: byte.
Nilai default: 65536.
MessageRetentionPeriod Integer Tidak. 120 Periode maksimum waktu sebuah pesan dapat disimpan dalam antrian. Setelah periode ini berakhir, pesan dihapus tanpa memperhatikan apakah pesan tersebut telah dikonsumsi. Nilai valid: 60 hingga 604800. Unit: detik.
Nilai default: 345600.
VisibilityTimeout Integer Tidak. 60 Periode ketidakterlihatan selama pesan yang diterima tetap dalam keadaan Inactive. Nilai valid: 1 hingga 43200. Unit: detik.
Nilai default: 30.
PollingWaitSeconds Integer Tidak. 0 Periode maksimum waktu permintaan ReceiveMessage menunggu jika tidak ada pesan yang tersedia dalam antrian. Nilai valid: 0 hingga 30. Unit: detik.
Nilai default: 0.
LoggingEnabled Boolean Tidak True Menentukan apakah fitur manajemen log diaktifkan. Nilai valid: Nilai valid:- True: mengaktifkan fitur manajemen log.
- False: menonaktifkan fitur manajemen log.
Nilai default: False.
Jika Anda ingin menggunakan Terraform untuk mengelola alicloud_message_service_queue, ganti parameter LoggingEnabled dengan parameter EnableLogging.
Pesan kesalahan
Respon terdiri dari bagian-bagian berikut:
- Kode Status HTTP
HTTP/1.1 204 No Content - Header respons spesifik operasi
Tidak ada.
- Badan Respons
Tidak ada.
Contoh
Contoh permintaan
PUT /queues/$queueName?Metaoverride=true HTTP/1.1
Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
Date: Wed, 08 Mar 2012 12:00:00 GMT
x-mns-version: 2015-06-06
Authorization: MNS 15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAM****
<?xml version="1.0" encoding="UTF-8"?>
<Queue xmlns="http://mns.aliyuncs.com/doc/v1/">
<VisibilityTimeout >60</VisibilityTimeout>
<MaximumMessageSize>1024</MaximumMessageSize>
<MessageRetentionPeriod>120</MessageRetentionPeriod>
<DelaySeconds>30</DelaySeconds>
<LoggingEnabled>True</LoggingEnabled>
</Queue> Contoh respons
HTTP/1.1 204 No Content
x-mns-request-id:512B2A634403E52B1956****
x-mns-version: 2015-06-06 Kode kesalahan
| Kode kesalahan | Pesan kesalahan | Kode status HTTP | Deskripsi |
| InvalidArgument | Nilai Element harus antara Low dan High detik/byte. | 400 | Pesan kesalahan dikembalikan karena nilai parameter tidak valid. Pastikan bahwa nilainya berada dalam rentang nilai. |
| QueueNotExist | Nama antrian yang Anda berikan tidak ada. | 404 | Pesan kesalahan dikembalikan karena antrian yang ditentukan tidak ada. Anda harus membuat antrian. |