调用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类型。取值:

  • FANOUT:该类型路由规则非常简单,会把所有发送到该Exchange的消息路由到所有与它绑定的Queue中,相当于广播功能。
  • DIRECT:该类型路由规则会将消息路由到Binding Key与Routing Key完全匹配的Queue中。
  • TOPIC:该类型与Direct类型相似,只是规则没有那么严格,可以模糊匹配和多条件匹配,即该类型Exchange使用Routing Key模式匹配和字符串比较的方式将消息路由至绑定的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)://[Endpoint]/?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***"
}

错误码

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