调用CreateBinding为Exchange绑定Queue或者Exchange。

请求参数

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

要执行的操作。取值:

CreateBinding

Argument String x-match:all;type:report;format:pdf

设置消息头属性键值对信息,消息头属性使用一个或多个键值对拼接而成。x-match属性必须配置,其余属性可自定义。x-match属性取值如下:

  • all:默认值,所有消息头的键值对必须匹配。
  • any:至少一对消息头的键值对必须匹配。

属性之间使用半角分号(;)隔开,属性键与值之间使用半角冒号(:)区分。例如x-match:all;type:report;format:pdf

该参数适用于Headers Exchange,对其它类型的Exchange无效。其它类型的Exchange,此处可以填任意值。

BindingKey String .test

绑定键。

  • 绑定源Exchange为非Topic类型:
    • 只能包含字母、数字、短划线(-)、下划线(_)、半角句号(.)、正斜线(/)、at符号(@)。
    • 长度限制1~255字符。
  • 绑定源Exchange为Topic类型:
    • 可以包含字母、数字、短划线(-)、下划线(_)、星号(*)、半角句号(.)、井号(#)、正斜线(/)、at符号(@)。
    • 如果包含井号(#),则必须以井号和英文句号(#.)开头,然后以英文句号和井号(.#)结尾。
    • 长度限制1~255字符。
BindingType String 0

绑定目标对象的类型。取值:

  • 0:Queue
  • 1:Exchange
DestinationName String DemoQueue

绑定目标名称,且此绑定目标已在控制台创建。

InstanceId String amqp-cn-v0h1kb9nu***

实例ID。

RegionId String cn-hangzhou

地域ID。

SourceExchange String NormalEX

源Exchange名称,且此Exchange已在控制台创建。

VirtualHost String test

Vhost名称,且此Vhost已在控制台创建。

返回数据

名称 类型 示例值 描述
RequestId String 09768C14-E51C-4F4A-8077-30810032C***

请求ID。

示例

请求示例

http(s)://amqp-open.cn-hangzhou.aliyuncs.com/?Action=CreateBinding
&Argument=x-match:all;type:report;format:pdf 
&BindingKey=.test
&BindingType=0
&DestinationName=DemoQueue
&InstanceId=amqp-cn-v0h1kb9nu***
&RegionId=cn-hangzhou
&SourceExchange=NormalEX
&VirtualHost=test
&<公共请求参数>

正常返回示例

XML格式

<CreateBindingResponse>
      <RequestId>09768C14-E51C-4F4A-8077-30810032C***</RequestId>
</CreateBindingResponse>

JSON格式

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

错误码

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