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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
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

绑定目标名称。

此绑定目标需已在控制台创建且所属Vhost与SourceExchange所属Vhost一致，即在VirtualHost中。
InstanceId String 是 amqp-cn-v0h1kb9nu***

实例ID。
RegionId String 是 cn-hangzhou

地域ID。
SourceExchange String 是 NormalEX

源Exchange名称，且此Exchange已在控制台创建。
VirtualHost String 是 test

Vhost名称。

此Vhost已在控制台创建且是DestinationName和SourceExchange所属的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***"
}

错误码

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