Queries the information about bindings whose binding source is a specific exchange.

Request parameters

Parameter Type Required Example Description
Action String Yes ListDownStreamBindings

The operation that you want to perform. Set the value to

ListDownStreamBindings.

ExchangeName String Yes test

The name of the exchange.

InstanceId String Yes 1880770869023***

The ID of the instance.

MaxResults Integer Yes 1

The maximum number of entries to return.

RegionId String Yes cn-hangzhou

The ID of the region.

VirtualHost String Yes test

The name of the vhost.

NextToken String No caeba0bbb2be03f84eb48b699f0a****

The token that marks the end position of the previous returned page. Call the operation again by using the value of the NextToken parameter returned by the previous request to obtain the next set of data. Leave this parameter empty the first time you call this operation. If all results have been returned, the value of NextToken in the response parameter is empty.

Response parameters

Parameter Type Example Description
Code Integer 200

The HTTP status code. The HTTP 200 status code indicates that the request is successful.

Data Struct

The returned data.

Bindings Array of BindingVO

An array of bindings.

Argument String test

The x-match attribute. Valid values:

  • all: (default) A headers exchange routes a message to a queue only if all binding attributes (excluding x-match) of the queue match the headers attributes of the message.
  • any: A headers exchange routes a message to a queue if one or more binding attributes (excluding x-match) of the queue match the headers attributes of the message.

This parameter applies only to headers exchanges.

BindingKey String amq.test

The binding key.

  • If the source exchange is not a topic exchange, configure the binding key based on the following requirements:
    • The binding key can contain only letters, digits, hyphens (-), underscores (_), periods (.), forward slashes (/), and at signs (@).
    • The binding key must be 1 to 255 characters in length.
  • If the source exchange is a topic exchange, configure the binding key based on the following requirements:
    • The binding key can contain letters, digits, hyphens (-), underscores (_), periods (.), number signs (#), forward slashes (/), and at signs (@).
    • If the binding key contains a number sign (#), the binding key must start with a number sign (#) followed by a period (.) and end with a number sign (#) that follows a period (.).
    • The binding key must be 1 to 255 characters in length.
BindingType String QUEUE

The type of the destination. Valid values:

  • QUEUE
  • EXCHANGE
DestinationName String QueueTest

The name of the destination.

SourceExchange String test

The name of the source exchange.

MaxResults Integer 1

The maximum number of returned entries.

NextToken String caebacccb2be03f84eb48b699f0a****

The token that marks the end of the current returned page. If this parameter is empty, it indicates that you have retrieved all the data.

Message String operation success

The returned message.

RequestId String 9C1E0502-0790-4FDB-8C96-6D5C8D9B7***

The ID of the request.

Success Boolean true

Indicates whether the request was successful.

Examples

Sample requests

http(s)://amqp-open.cn-hangzhou.aliyuncs.com/?Action=ListDownStreamBindings
&ExchangeName=test
&InstanceId=1880770869023***
&MaxResults=1
&RegionId=cn-hangzhou
&VirtualHost=test
&<Common request parameters>

Sample success responses

XML format

<Message>operation success</Message>
<RequestId>9C1E0502-0790-4FDB-8C96-6D5C8D9B7***</RequestId>
<Data>
    <NextToken>,</NextToken>
    <MaxResults>1</MaxResults>
    <Bindings>
        <Argument>test</Argument>
        <SourceExchange>test</SourceExchange>
        <BindingKey>amq.test</BindingKey>
        <BindingType>QUEUE</BindingType>
        <DestinationName>QueueTest</DestinationName>
    </Bindings>
</Data>
<Code>200</Code>
<Success>true</Success>

JSON format

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

Errors

For a list of error codes, visit the API Error Center.