Todos os produtos
Search
Central de documentação

:CreateExchange

Última atualização: Jul 08, 2026

Crie um exchange.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

CreateExchange

Operação a ser executada. Defina o valor como CreateExchange.

InstanceId

String

Sim

amqp-cn-v0h1kb9nu***

ID da instância.

VirtualHost

String

Sim

test

Nome do vhost onde o exchange será criado.

ExchangeName

String

Sim

DemoExchange

Nome do exchange. Deve seguir estas convenções:

  • Deve ter entre 1 e 255 caracteres e conter apenas letras, dígitos e os seguintes caracteres especiais: - _ . # / @

  • Não é possível modifique o nome após a criação. Para alterá-lo, exclua o exchange atual e crie outro.

ExchangeType

String

Sim

DIRECT

Tipo do exchange. Valores válidos:

  • DIRECT: Roteia a mensagem para a fila cuja chave de vinculação (binding key) seja idêntica à chave de roteamento da mensagem.

  • TOPIC: Semelhante ao tipo direct, mas roteia mensagens para uma ou mais filas com base em correspondência aproximada ou múltiplas condições entre a chave de roteamento da mensagem e as chaves de vinculação do exchange.

  • FANOUT: Encaminha todas as mensagens recebidas para todas as filas vinculadas a este exchange. Ideal para cenários de broadcast.

  • HEADERS: Similar ao tipo direct, mas utiliza atributos de cabeçalho (headers) em vez de chaves de roteamento. Ao vincular um exchange headers a uma fila, configure atributos de vinculação no formato chave-valor. Ao enviar uma mensagem, defina os atributos headers no mesmo formato. O roteamento ocorre conforme a correspondência entre os atributos headers da mensagem e os atributos de vinculação da fila.

XDelayedType

String

Não

DIRECT

Refere-se ao exchange x-delayed-message. Use o cabeçalho x-delay da mensagem para definir um período de atraso antes da entrega, em milissegundos. O parâmetro x-delayed-type determina o tipo de exchange subjacente para onde as mensagens atrasadas serão enviadas. Valores válidos:

  • DIRECT: Entrega mensagens atrasadas a filas vinculadas a um exchange direct.

  • TOPIC: Entrega mensagens atrasadas a filas vinculadas a um exchange topic.

  • FANOUT: Entrega mensagens atrasadas a filas vinculadas a um exchange fanout.

  • HEADERS: Entrega mensagens atrasadas a filas vinculadas a um exchange headers.

  • X-JMS-TOPIC: Entrega mensagens atrasadas a filas vinculadas a um exchange x-jms-topic.

AutoDeleteState

Boolean

Sim

false

Define se a exclusão automática está ativada. Valores válidos:

  • true: O exchange é excluído automaticamente quando a última fila vinculada a ele for desvinculada.

  • false: O exchange permanece ativo mesmo após a desvinculação da última fila associada.

Internal

Boolean

Sim

false

Indica se o exchange é interno. Valores válidos:

  • false

  • true

AlternateExchange

String

Não

DemoAE

Exchange alternativo. Recebe mensagens que não puderam ser roteadas para nenhuma fila pelo exchange atual.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

021788F6-E50C-4BD6-9F80-66B0A19A****

ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://amqp-open.cn-hangzhou.aliyuncs.com/?Action=CreateExchange
&AutoDeleteState=false
&ExchangeName=DemoExchange
&ExchangeType=DIRECT
&InstanceId=amqp-cn-v0h1kb9nu***
&Internal=false
&RegionId=cn-hanghzou
&VirtualHost=test
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateExchangeResponse>
    <RequestId>021788F6-E50C-4BD6-9F80-66B0A19A6***</RequestId>
</CreateExchangeResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "021788F6-E50C-4BD6-9F80-66B0A19A6***"
}

Códigos de erro

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.