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=truena 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âmetro Tipo Obrigatório Exemplo Descrição DelaySeconds Integer Não. 0 Perí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.
MaximumMessageSize Integer Não. 1024 Tamanho máximo do corpo da mensagem enviado para a fila. Valores válidos: 1024 a 65536. Unidade: bytes.
Valor padrão: 65536.
MessageRetentionPeriod Integer Não. 120 Tempo 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.
VisibilityTimeout Integer Não. 60 Perí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.
PollingWaitSeconds Integer Não. 0 Tempo 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.
LoggingEnabled Boolean Não True Define 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. |