CreateBinding - 创建绑定 - 云消息队列 RabbitMQ 版

Producer将消息发送到Exchange，Exchange根据创建的绑定关系以及路由规则选择将消息路由到指定的Queue或其他Exchange中。

调试

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

授权信息

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

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

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

请求参数

名称	类型	必填	描述	示例值
InstanceId	string	是	云消息队列 RabbitMQ 版实例的 ID。	amqp-cn-v0h1kb9nu***
VirtualHost	string	是	Vhost 名称。此 Vhost 已在控制台创建且是 DestinationName 和 SourceExchange 所属的 Vhost。	test
SourceExchange	string	是	源 Exchange 名称，且此 Exchange 已在控制台创建。	NormalEX
DestinationName	string	是	绑定目标名称。此绑定目标需已在控制台创建且所属 Vhost 与 SourceExchange 所属 Vhost 一致，即在 VirtualHost 中。	DemoQueue
BindingKey	string	否	绑定键。绑定源 Exchange 为非 Topic 类型：只能包含字母、数字、短划线（-）、下划线（_）、半角句号（.）、正斜线（/）、at 符号（@）。长度限制 1~255 字符。绑定源 Exchange 为 Topic 类型：可以包含字母、数字、短划线（-）、下划线（_）、星号（）、半角句号（.）、井号（#）、正斜线（/）、at 符号（@）。不能以半角句号（.）开头或结尾。对于井号（#）或星号（），如果以其开头，则其后需有半角句号（.），如果以其结尾，则其前需有半角句号（.），如果既不是开头也不是结尾，则其前后均需有半角句号（.）。长度限制 1~255 字符。	.test
BindingType	string	是	绑定目标对象的类型。取值： 0：Queue 1：Exchange	0
Argument	string	否	设置消息头属性键值对信息，消息头属性使用一个或多个键值对拼接而成。x-match 属性必须配置，其余属性可自定义。x-match 属性取值如下： all：默认值，所有消息头的键值对必须匹配。 any：至少一对消息头的键值对必须匹配。属性之间使用半角分号（;）隔开，属性键与值之间使用半角冒号（:）区分。例如 x-match:all;type:report;format:pdf 该参数适用于 Headers Exchange，对其它类型的 Exchange 无效。其它类型的 Exchange，此处可以填任意值。	x-match:all;type:report;format:pdf

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	09768C14-E51C-4F4A-8077-30810032C***

示例

正常返回示例

JSON格式

{
  "RequestId": "09768C14-E51C-4F4A-8077-30810032C***"
}

错误码

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

变更历史

变更时间	变更内容概要	操作
2024-11-12	API 内部配置变更，不影响调用	查看变更详情