Queries the event buses that meet the specified conditions. You can use the Limit and NextToken parameters to implement paging.

URI

/openapi/listEventBuses

Request parameters

Parameter Type Required Example Description
NamePrefix String No My The prefix for the names of the event buses that you want to query.
Limit Int No 10 The maximum number of entries to be returned in a single call. You can use this parameter and the NextToken parameter to implement paging.
Note A maximum of 100 entries can be returned in a single call.
NextToken String No 10 If you set the Limit parameter and excess return values exist, this parameter is returned.

Response parameters

Parameter Type Example Description
EventBuses List<EventBus> The list of event buses that meet the query conditions.
EventBusName String default The name of the event bus.
EventBusARN String acs:eventbridge:cn-hangzhou:123456789098***:eventbus/default The Alibaba Cloud Resource Name (ARN) of the event bus.
NextToken String 10 The offset for the next paging request. If excess data over the specified value of the Limit parameter is available for the next paging request, this parameter is returned.

Examples

Sample requests

POST /openapi/listEventBuses HTTP/1.1
Host: 123456789098****.eventbridge.cn-hangzhou.aliyuncs.com
Date: Sat, 18 Apr 2020 05:30:41 GMT
x-eventbridge-version: 2020-04-01
Authorization: acs vZ3VL0SuJdHi****:Jo2PbTj******zYAYoYslKLvWzg=
Content-Type: application/json;charset=UTF-8
Content-Length: 26

{
    "NamePrefix": "My",
    "Limit": 10,
    "NextToken": "10"
}

Sample responses

HTTP/1.1 200 OK
Server: AliyunEventBridge
Connection: keep-alive
Content-Type: application/json;charset=utf-8
Content-Length: 79
x-eventbridge-request-id: 5E9A9081333245F1D800****
Date: Sat, 18 Apr 2020 05:30:41 GMT

{
    "EventBuses":[
        {
            "EventBusName":"default",
            "EventBusARN":"acs:eventbridge:cn-hangzhou:123456789098***:eventbus/default"
        },
        {
            "EventBusName":"MyEventBus",
            "EventBusARN":"acs:eventbridge:cn-hangzhou:123456789098***:eventbus/MyEventBus"
        }
    ],
    "NextToken":"10"
}