CreateQueue - - Centro de documentación de Alibaba Cloud

Crea una cola.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	CreateQueue	La operación que desea ejecutar. Establezca el valor en CreateQueue.
InstanceId	String	Sí	amqp-cn-v0h1kb9nu***	El ID de la instancia.
QueueName	String	Sí	DemoQueue	El nombre de la cola por crear. El nombre debe tener entre 1 y 255 caracteres de longitud, y solo puede contener letras, dígitos y los siguientes caracteres especiales: -_.#/@ Una vez creada la cola, no es posible cambiar su nombre. Si desea modificarlo, elimine la cola y cree otra nueva.
RegionId	String	Sí	cn-hangzhou	El ID de la región.
VirtualHost	String	Sí	test	El nombre del host virtual (vhost). El nombre debe tener entre 1 y 255 caracteres de longitud, y solo puede contener letras, dígitos y los siguientes caracteres especiales: -_.#/@
AutoDeleteState	Boolean	No	false	Especifica si se elimina automáticamente la cola. Valores válidos: true: La cola se elimina automáticamente. Tras cancelarse la última suscripción de consumidores a esta cola, se elimina automáticamente. false: La cola no se elimina automáticamente.
ExclusiveState	Boolean	No	false	Especifica si la cola es exclusiva. Valores válidos: true: La cola es exclusiva. Solo la conexión que declara la cola exclusiva puede utilizarla. Al cerrarse la conexión, la cola exclusiva se elimina automáticamente. false: La cola no es exclusiva.
MessageTTL	Long	No	1000	El tiempo de vida (TTL) de mensaje de la cola. Si el periodo de retención de un mensaje en la cola supera el TTL de mensaje de la cola, el mensaje caduca. El TTL del mensaje debe ser un entero no negativo. El TTL máximo del mensaje es de un día. Unidad: milisegundos. Por ejemplo, si el TTL del mensaje de la cola es de 1,000 ms, los mensajes permanecen en la cola durante 1 segundo como máximo.
AutoExpireState	Long	No	10000	El periodo de validez tras el cual la cola se elimina automáticamente. Si no se accede a la cola dentro del periodo especificado, se elimina automáticamente. Unidad: milisegundos. Nota Solo puede usar la función correspondiente a este parámetro después de habilitarla. Para utilizar esta función, envíe un ticket.
MaxLength	Long	No	1000	La versión actual no admite este parámetro. El número máximo de mensajes que se pueden almacenar en la cola. Si se supera este umbral, se descartan los mensajes más antiguos enrutados a la cola.
DeadLetterExchange	String	No	DLExchange	El exchange de mensajes muertos. Un exchange de mensajes muertos recibe mensajes rechazados. Si un consumidor rechaza un mensaje que no se puede reintentar, dicho mensaje se enruta al exchange de mensajes muertos especificado. A continuación, el exchange de mensajes muertos enruta el mensaje a la cola vinculada a él.
DeadLetterRoutingKey	String	No	test.dl	La clave de enrutamiento de mensajes muertos. El nombre debe tener entre 1 y 255 caracteres de longitud, y solo puede contener letras, dígitos y los siguientes caracteres especiales: -_.#/@
MaximumPriority	Integer	No	10	Las prioridades de cola no son compatibles. El valor no afecta a la llamada ni a los resultados devueltos.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	59B52E2C-0B8E-44EC-A314-D0314A50***	El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

http(s)://amqp-open.cn-hangzhou.aliyuncs.com/?Action=CreateQueue
&InstanceId=amqp-cn-v0h1kb9nu***
&MaxLength=1000
&QueueName=DemoQueue
&RegionId=cn-hangzhou
&VirtualHost=test
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

<CreateQueueResponse>
        <RequestId>59B52E2C-0B8E-44EC-A314-D0314A50***</RequestId>
</CreateQueueResponse>

Formato JSON

{
    "RequestId":"59B52E2C-0B8E-44EC-A314-D0314A50***"
}

Códigos de error

Para obtener una lista de códigos de error, visite el Centro de errores de API.