调用ListDownStreamBindings查询指定Exchange的下游绑定关系-云消息队列 RabbitMQ 版-阿里云

查询指定Exchange绑定了哪些Exchange或Queue。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

amqp:GetInstance

list

*Instance

acs:amqp:{#regionId}:{#accountId}:/instances/{#instanceId}

无

amqp:ListExchange
amqp:ListQueue

请求参数

名称	类型	必填	描述	示例值
InstanceId	string	是	Exchange 所属的云消息队列 RabbitMQ 版实例的 ID。	1880770869023***
VirtualHost	string	是	Exchange 所属的 Vhost 名称。	test
ExchangeName	string	是	Exchange 名称。	test
NextToken	string	否	用来标记当前查询结束的位置，以便下一次调用时作为参数传入，继续翻页。首次调用或返回最后一页时，取值为空字符串。	caeba0bbb2be03f84eb48b699f0a****
MaxResults	integer	否	最大结果集。	1

返回参数

名称	类型	描述	示例值
	object
Code	integer	返回码。返回 200 代表成功。	200
Message	string	返回信息。	operation success
RequestId	string	请求 ID。	9C1E0502-0790-4FDB-8C96-6D5C8D9B7***
Success	boolean	是否成功。	true
Data	object	返回数据。
MaxResults	integer	最大结果集。	1
NextToken	string	表示当前调用返回读取到的位置，空代表数据已经读取完毕。	caebacccb2be03f84eb48b699f0a****
Bindings	array<object>	绑定关系。
	object
SourceExchange	string	源 Exchange 名称。	test
Argument	string	x-match 属性。取值： all：默认值，所有消息头的键值对必须匹配。 any：至少一对消息头的键值对必须匹配。该参数仅适用于 Headers 类型的 Exchange，对其它类型的 Exchange 无效。	test
BindingKey	string	绑定键。绑定源 Exchange 为非 Topic 类型：只能包含字母、数字、短划线（-）、下划线（_）、半角句号（.）、正斜线（/）、at 符号（@）。长度限制 1~255 字符。绑定源 Exchange 为 Topic 类型：可以包含字母、数字、短划线（-）、下划线（_）、半角句号（.）、井号（#）、正斜线（/）、at 符号（@）。不能以半角句号（.）开头或结尾。对于井号（#）或星号（*），如果以其开头，则其后需有半角句号（.），如果以其结尾，则其前需有半角句号（.），如果既不是开头也不是结尾，则其前后均需有半角句号（.）。长度限制 1~255 字符。	amq.test
BindingType	string	绑定目标对象的类型。取值： QUEUE EXCHANGE	QUEUE
DestinationName	string	绑定目标名称。	QueueTest

示例

正常返回示例

JSON格式

{
  "Code": 200,
  "Message": "operation success",
  "RequestId": "9C1E0502-0790-4FDB-8C96-6D5C8D9B7***",
  "Success": true,
  "Data": {
    "MaxResults": 1,
    "NextToken": "caebacccb2be03f84eb48b699f0a****",
    "Bindings": [
      {
        "SourceExchange": "test",
        "Argument": "test",
        "BindingKey": "amq.test",
        "BindingType": "QUEUE",
        "DestinationName": "QueueTest"
      }
    ]
  }
}

错误码

HTTP status code	错误码	错误信息	描述
404	InstanceIdNotExist	The instance resource does not exist.
404	InstanceNotExist	The instance resource does not exist.	实例资源不存在

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

变更历史

更多信息，参考变更详情。