Todos los productos
Search
Centro de documentos

:SetQueueAttributes

Última actualización: Sep 04, 2026

Modifica una cola.

Autorización

De forma predeterminada, solo las cuentas de Alibaba Cloud pueden invocar esta operación. Los usuarios de RAM solo pueden invocarla después de recibir los permisos correspondientes. A continuación se describe la información de autorización de esta operación. Para obtener más información, consulte Authorization policies and examples.

Nombre

Valor

API

SetQueueAttributes

Action

mns:SetQueueAttributes

Item

acs:mns:$region:$accountid:/queues/$queueName

Solicitud

Una solicitud consta de las siguientes partes:

  • Línea de solicitud

    PUT /queues/$queueName?metaoverride=true HTTP/1.1

  • Parámetros de URI

    Para modificar los parámetros de una cola, especifique metaoverride=true en el URI.

  • Encabezados de solicitud específicos de la operación

    Ninguno.

  • Cuerpo de la solicitud

    El cuerpo de la solicitud está en formato XML. Puede incluir los parámetros de la cola en el cuerpo de la solicitud. Todos los parámetros son opcionales.

    ParámetroTipoObligatorioEjemploDescripción
    DelaySecondsIntegerNo.0Periodo de retardo tras el cual se pueden consumir todos los mensajes enviados a la cola.

    Valores válidos: de 0 a 604800. Unidad: segundos.

    Valor predeterminado: 0.

    MaximumMessageSizeIntegerNo.1024Tamaño máximo del cuerpo del mensaje que se puede enviar a la cola.

    Valores válidos: de 1024 a 65536. Unidad: bytes.

    Valor predeterminado: 65536.

    MessageRetentionPeriodIntegerNo.120Periodo máximo durante el cual un mensaje se conserva en la cola. Una vez transcurrido este periodo, el mensaje se elimina independientemente de si se consumió o no.

    Valores válidos: de 60 a 604800. Unidad: segundos.

    Valor predeterminado: 345600.

    VisibilityTimeoutIntegerNo.60Periodo de invisibilidad durante el cual el mensaje recibido permanece en estado Inactive.

    Valores válidos: de 1 a 43200. Unidad: segundos.

    Valor predeterminado: 30.

    PollingWaitSecondsIntegerNo.0Tiempo máximo de espera de una solicitud ReceiveMessage cuando no hay mensajes disponibles en la cola.

    Valores válidos: de 0 a 30. Unidad: segundos.

    Valor predeterminado: 0.

    LoggingEnabledBooleanNoTrueIndica si se habilita la función de gestión de registros. Valores válidos:
    Valores válidos:
    • True: habilita la función de gestión de registros.
    • False: deshabilita la función de gestión de registros.

    Valor predeterminado: False.

    Si desea usar Terraform para gestionar alicloud_message_service_queue, reemplace el parámetro LoggingEnabled por el parámetro EnableLogging.

Mensaje de error

Una respuesta consta de las siguientes partes:

  • Código de estado HTTP

    HTTP/1.1 204 No Content

  • Encabezados de respuesta específicos de la operación

    Ninguno.

  • Cuerpo de la respuesta

    Ninguno.

Ejemplos

Solicitudes de ejemplo

    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>          

Respuestas de ejemplo

    HTTP/1.1 204 No Content
    x-mns-request-id:512B2A634403E52B1956****
    x-mns-version: 2015-06-06            

Códigos de error

Código de error

Mensaje de error

Código de estado HTTP

Descripción

InvalidArgument

The value of Element should between Low and High seconds/bytes.

400

El mensaje de error devuelto porque el valor del parámetro no es válido. Asegúrese de que el valor se encuentre dentro del rango permitido.

QueueNotExist

The queue name you provided is not exist.

404

El mensaje de error devuelto porque la cola especificada no existe. Debe crear una cola.