Todos os produtos
Search
Central de documentação

:SetQueueAttributes

Última atualização: Jul 04, 2026

Modifique uma fila.

Autorização

Por padrão, apenas contas Alibaba Cloud podem chamar esta operação. Usuários RAM só podem executar essa chamada após receberem as permissões necessárias. A tabela a seguir descreve as informações de autorização desta operação. Para mais informações, consulte Políticas e exemplos de autorização.

Nome

Valor

API

SetQueueAttributes

Action

mns:SetQueueAttributes

Item

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

Requisição

Uma requisição consiste nas seguintes partes:

  • Linha de requisição

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

  • Parâmetros de URI

    Para modificar os parâmetros de uma fila, especifique metaoverride=true na URI.

  • Cabeçalhos de requisição específicos da operação

    Nenhum.

  • Corpo da requisição

    O corpo da requisição está no formato XML. É possível incluir os parâmetros da fila no corpo da requisição. Todos os parâmetros são opcionais.

    ParâmetroTipoObrigatórioExemploDescrição
    DelaySecondsIntegerNão.0Período de atraso após o qual todas as mensagens enviadas à fila ficam disponíveis para consumo.

    Valores válidos: 0 a 604800. Unidade: segundos.

    Valor padrão: 0.

    MaximumMessageSizeIntegerNão.1024Tamanho máximo do corpo da mensagem enviado para a fila.

    Valores válidos: 1024 a 65536. Unidade: bytes.

    Valor padrão: 65536.

    MessageRetentionPeriodIntegerNão.120Tempo máximo de retenção de uma mensagem na fila. Após esse período, a mensagem é excluída independentemente de ter sido consumida.

    Valores válidos: 60 a 604800. Unidade: segundos.

    Valor padrão: 345600.

    VisibilityTimeoutIntegerNão.60Período de invisibilidade durante o qual a mensagem recebida permanece no estado Inactive.

    Valores válidos: 1 a 43200. Unidade: segundos.

    Valor padrão: 30.

    PollingWaitSecondsIntegerNão.0Tempo máximo de espera de uma requisição ReceiveMessage quando não há mensagens disponíveis na fila.

    Valores válidos: 0 a 30. Unidade: segundos.

    Valor padrão: 0.

    LoggingEnabledBooleanNãoTrueDefine se o recurso de gerenciamento de log deve ser ativado. Valores válidos:
    Valores válidos:
    • True: ative o recurso de gerenciamento de log.
    • False: desativa o recurso de gerenciamento de log.

    Valor padrão: False.

    Se você usar o Terraform para gerencie alicloud_message_service_queue, substitua o parâmetro LoggingEnabled pelo parâmetro EnableLogging.

Mensagem de erro

Uma resposta consiste nas seguintes partes:

  • Código de status HTTP

    HTTP/1.1 204 No Content

  • Cabeçalhos de resposta específicos da operação

    Nenhum.

  • Corpo da resposta

    Nenhum.

Exemplos

Exemplos de requisições

    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>          

Exemplos de respostas

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

Códigos de erro

Código de erro

Mensagem de erro

Código de status HTTP

Descrição

InvalidArgument

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

400

Erro retornado porque o valor do parâmetro é inválido. Verifique se o valor está dentro do intervalo permitido.

QueueNotExist

The queue name you provided is not exist.

404

Erro retornado porque a fila especificada não existe. Crie uma fila.