调用ListBindings查询绑定。

请求参数

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

要执行的操作。取值:

ListBindings

InstanceId String 1880770869023***

实例ID。

MaxResults Integer 1

本次读取的最大数据记录数量。取值:

1~100
RegionId String cn-hangzhou

地域ID。

VirtualHost String Test

Vhost名称。

NextToken String caeba0bbb2be03f84eb48b699f0a****

用来标记当前查询结束的位置,以便下一次调用时作为参数传入,继续翻页。首次调用和当返回最后一页时,取值为空字符串。

返回数据

名称 类型 示例值 描述
Data Struct

返回数据。

Bindings Array of BindingDO

绑定。

Argument String all

x-match属性。取值:

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

该参数仅适用于Headers类型的Exchange。

BindingKey String amq.test

绑定键。

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

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

  • QUEUE
  • EXCHANGE
DestinationName String QueueTest

绑定目标名称。

SourceExchange String test

源Exchange名称。

MaxResults Integer 1

本次请求所返回的最大记录条数。

NextToken String caebacccb2be03f84eb48b699f0a****

表示当前调用返回读取到的位置,空代表数据已经读取完毕。

RequestId String E0A71208-3E87-4732-81CC-B18E0B4B1***

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ListBindings
&InstanceId=1880770869023***
&MaxResults=1
&RegionId=cn-hangzhou
&VirtualHost=Test
&NextToken=caeba0bbb2be03f84eb48b699f0a****
&<公共请求参数>

正常返回示例

XML格式

<ListBindingsResponse>
      <RequestId>E0A71208-3E87-4732-81CC-B18E0B4B1***</RequestId>
      <Data>
            <NextToken>,</NextToken>
            <MaxResults>1</MaxResults>
            <Bindings>
                  <SourceExchange>test</SourceExchange>
                  <Argument>all</Argument>
                  <BindingType>QUEUE</BindingType>
                  <BindingKey>amq.test</BindingKey>
                  <DestinationName>QueueTest</DestinationName>
            </Bindings>
      </Data>
</ListBindingsResponse>

JSON格式

{
    "RequestId":"E0A71208-3E87-4732-81CC-B18E0B4B1***",
    "Data":{
        "NextToken":",",
        "MaxResults":"1",
        "Bindings":[
            {
                "SourceExchange":"test",
                "Argument":"all",
                "BindingType":"QUEUE",
                "BindingKey":"amq.test",
                "DestinationName":"QueueTest"
            }
        ]
    }
}

错误码

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