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=trueen 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ámetro Tipo Obligatorio Ejemplo Descripción DelaySeconds Integer No. 0 Periodo 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.
MaximumMessageSize Integer No. 1024 Tamañ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.
MessageRetentionPeriod Integer No. 120 Periodo 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.
VisibilityTimeout Integer No. 60 Periodo de invisibilidad durante el cual el mensaje recibido permanece en estado Inactive. Valores válidos: de 1 a 43200. Unidad: segundos.
Valor predeterminado: 30.
PollingWaitSeconds Integer No. 0 Tiempo 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.
LoggingEnabled Boolean No True Indica 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. |