全部产品
Search
文档中心

:SetQueueAttributes

更新时间:Nov 09, 2025

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.

NamaNilai
APISetQueueAttributes
Aksimns:SetQueueAttributes
Itemacs: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=true dalam 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.

    ParameterTipeDiperlukanContohDeskripsi
    DelaySecondsIntegerTidak.0Periode penundaan setelah semua pesan yang dikirim ke antrian dapat dikonsumsi.

    Nilai valid: 0 hingga 604800. Unit: detik.

    Nilai default: 0.

    MaximumMessageSizeIntegerTidak.1024Ukuran maksimum tubuh pesan yang dapat dikirim ke antrian.

    Nilai valid: 1024 hingga 65536. Unit: byte.

    Nilai default: 65536.

    MessageRetentionPeriodIntegerTidak.120Periode 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.

    VisibilityTimeoutIntegerTidak.60Periode ketidakterlihatan selama pesan yang diterima tetap dalam keadaan Inactive.

    Nilai valid: 1 hingga 43200. Unit: detik.

    Nilai default: 30.

    PollingWaitSecondsIntegerTidak.0Periode maksimum waktu permintaan ReceiveMessage menunggu jika tidak ada pesan yang tersedia dalam antrian.

    Nilai valid: 0 hingga 30. Unit: detik.

    Nilai default: 0.

    LoggingEnabledBooleanTidakTrueMenentukan 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 kesalahanPesan kesalahanKode status HTTPDeskripsi
InvalidArgumentNilai Element harus antara Low dan High detik/byte.400Pesan kesalahan dikembalikan karena nilai parameter tidak valid. Pastikan bahwa nilainya berada dalam rentang nilai.
QueueNotExistNama antrian yang Anda berikan tidak ada.404Pesan kesalahan dikembalikan karena antrian yang ditentukan tidak ada. Anda harus membuat antrian.