CreateExchange - 创建Exchange - 云消息队列 RabbitMQ 版

Producer将消息发送到Exchange，由Exchange将消息路由到一个或多个Queue中（或者丢弃）。Exchange根据Routing Key和Binding Key将消息路由到Queue。

调试

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

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
amqp:CreateExchange	create	Exchange `acs:amqp:{#regionId}:{#accountId}:/instances/{#instanceId}/vhosts/{#vhostName}/exchanges/`	无	amqp:GetVhost

请求参数

名称	类型	必填	描述	示例值
InstanceId	string	是	实例 ID。	amqp-cn-v0h1kb9nu***
VirtualHost	string	是	Exchange 所在的 Vhost 名称。	test
ExchangeName	string	是	Exchange 名称。说明： Exchange 名称只能包含字母、数字、短划线（-）、下划线（_）、半角句号（.）、井号（#）、正斜线（/）、at 符号（@），长度限制 1~255 字符。 Exchange 创建后，名称不支持修改，只能删除后重建。	DemoExchange
ExchangeType	string	是	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。	DIRECT
XDelayedType	string	否	x-delayed-message 类型的 Exchange 可以自定义消息的 Header 属性， x-delay 用来指定消息延时投递的时间段，单位为毫秒。该类 Exchange 的路由规则取决于 x-delayed-type 参数中指定的 Exchange 类型，用于指定延迟消息最终将被投递到的实际 Exchange 类型。取值： DIRECT：将延迟消息投递到和 DIRECT 类型 Exchange 绑定的指定队列。 TOPIC：将延迟消息投递到和 TOPIC 类型 Exchange 绑定的队列。 FANOUT：将延迟消息投递到和 FANOUT 类型 Exchange 绑定的队列。 HEADERS：将延迟消息投递到和 HEADERS 类型 Exchange 绑定的队列。 X-JMS-TOPIC：将延迟消息投递到和 X-JMS-TOPIC 绑定的队列。	DIRECT
AutoDeleteState	boolean	是	是否自动删除。取值： true：是。如果绑定到该 Exchange 的最后一个 Queue 解除绑定，该 Exchange 会自动删除。 false：否。如果绑定到该 Exchange 的最后一个 Queue 解除绑定，该 Exchange 不会自动删除。	false
Internal	boolean	是	是否为内部 Exchange。取值： false：否 true：是	false
AlternateExchange	string	否	备份 Exchange。配置备份 Exchange 用于接收 Exchange 路由失败的消息。	DemoAE

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	021788F6-E50C-4BD6-9F80-66B0A19A****

示例

正常返回示例

JSON格式

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

错误码

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

变更历史

变更时间	变更内容概要	操作
2024-07-11	OpenAPI 入参发生变更	查看变更详情
2024-03-19	API 内部配置变更，不影响调用	查看变更详情