调用CreateExchange创建Exchange。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateExchange

要执行的操作。取值:

CreateExchange

AutoDeleteState Boolean false

是否自动删除。取值:

  • true:是。如果绑定到该Exchange的最后一个Queue解除绑定,该Exchange会自动删除。
  • false:否。如果绑定到该Exchange的最后一个Queue解除绑定,该Exchange不会自动删除。
ExchangeName String DemoExchange

Exchange名称。说明:

  • Exchange名称只能包含字母、数字、短划线(-)、下划线(_)、半角句号(.)、井号(#)、正斜线(/)、at 符号(@),长度限制1~255 字符。
  • Exchange创建后,名称不支持修改,只能删除后重建。
ExchangeType String DIRECT

Exchange类型。取值:

  • DIRECT:该类型路由规则会将消息路由到Binding Key与Routing Key完全匹配的Queue中。
  • TOPIC:该类型与DIRECT类型相似,使用Routing Key模式匹配和字符串比较的方式将消息路由至绑定的Queue。
  • FANOUT:该类型路由规则非常简单,会把所有发送到该Exchange的消息路由到所有与它绑定的Queue中,相当于广播功能。
  • HEADERS:该类型与DIRECT类型相似。Headers Exchange使用Headers属性代替Routing Key进行路由匹配,在绑定Headers Exchange和Queue时,设置绑定属性的键值对;在向Headers Exchange发送消息时,设置消息的Headers属性键值对,使用消息Headers属性键值对和绑定属性键值对比较的方式将消息路由至绑定的Queue。
InstanceId String amqp-cn-v0h1kb9nu***

实例ID。

Internal Boolean false

是否为内部Exchange。取值:

  • false:否
  • true:是
RegionId String cn-hanghzou

实例的地域ID。

VirtualHost String test

Exchange所在的Vhost名称。

AlternateExchange String DemoAE

备份Exchange。配置备份Exchange用于接收Exchange路由失败的消息。

返回数据

名称 类型 示例值 描述
RequestId String 021788F6-E50C-4BD6-9F80-66B0A19A6***

请求ID。

示例

请求示例

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
&<公共请求参数>

正常返回示例

XML格式

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

JSON格式

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

错误码

访问错误中心查看更多错误码。