CreateQueue - : Central de Documentação do Alibaba Cloud

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateQueue	Operação a ser executada. Defina o valor como CreateQueue.
InstanceId	String	Sim	amqp-cn-v0h1kb9nu***	ID da instância.
QueueName	String	Sim	DemoQueue	Nome da fila a ser criada. Deve ter de 1 a 255 caracteres e conter apenas letras, dígitos e os seguintes caracteres especiais: -_.#/@ Não é possível alterar o nome após a criação da fila. Para modificá-lo, exclua a fila existente e crie uma nova.
RegionId	String	Sim	cn-hangzhou	ID da região.
VirtualHost	String	Sim	test	Nome do host virtual (vhost). Deve ter de 1 a 255 caracteres e conter apenas letras, dígitos e os seguintes caracteres especiais: -_.#/@
AutoDeleteState	Boolean	Não	false	Define se a fila será excluída automaticamente. Valores válidos: true: exclui a fila automaticamente após o cancelamento da última assinatura de consumidores nela vinculada. false: não exclui a fila automaticamente.
ExclusiveState	Boolean	Não	false	Indica se a fila é exclusiva. Valores válidos: true: configura como fila exclusiva. Apenas a conexão que a declarou pode utilizá-la. O fechamento da conexão aciona a exclusão automática da fila. false: não configura como fila exclusiva.
MessageTTL	Long	Não	1000	Tempo de vida (TTL) das mensagens na fila. Mensagens expiram quando o período de retenção excede o TTL configurado. Deve ser um número inteiro não negativo, com limite máximo de um dia. Unidade: milissegundos. Exemplo: um TTL de 1.000 ms mantém as mensagens na fila por no máximo 1 segundo.
AutoExpireState	Long	Não	10000	Período de validade para exclusão automática da fila caso não haja acessos dentro do intervalo especificado. Unidade: milissegundos. Nota Este recurso requer ativação prévia. Para ativá-lo, envie um ticket.
MaxLength	Long	Não	1000	A versão atual não oferece suporte a este parâmetro. Número máximo de mensagens armazenáveis na fila. Ao ultrapassar esse limiar, o sistema descarta as mensagens mais antigas roteadas para ela.
DeadLetterExchange	String	Não	DLExchange	Exchange de dead letter responsável por receber mensagens rejeitadas. Quando um consumidor rejeita uma mensagem sem possibilidade de nova tentativa, ela segue para o exchange de dead letter especificado. Esse exchange encaminha a mensagem para a fila vinculada.
DeadLetterRoutingKey	String	Não	test.dl	Chave de roteamento de dead letter. Deve ter de 1 a 255 caracteres e conter apenas letras, dígitos e os seguintes caracteres especiais: -_.#/@
MaximumPriority	Integer	Não	10	Não há suporte para prioridades de fila. O valor informado não afeta a chamada nem os resultados retornados.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	59B52E2C-0B8E-44EC-A314-D0314A50***	ID da solicitação.

Exemplos

Exemplos de solicitações

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>

Exemplos de respostas de sucesso

Formato XML

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

Formato JSON

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

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros da API.