文档首页/ 数据接入服务 DIS/ SDK参考/ 使用SDK/ 使用SDK（Java）/ 查询通道列表
更新时间：2024-10-25 GMT+08:00
查看PDF
分享

查询通道列表

参考初始化DIS客户端的操作初始化一个DIS客户端实例，实例名称为dic。

使用DIS SDK列出当前活动的通道。

使用setLimit方法设定每次查询时返回的通道数量，若不指定则默认返回的通道数量上限为10。即通道数量少于等于10时显示实际通道数量，通道数量大于10时显示为10。

1
2
3
 
ListStreamsRequest listStreamsRequest = new ListStreamsRequest();
listStreamsRequest.setLimit(5);
System.out.println("listStream: " + JsonUtils.objToJson(dic.listStreams(listStreamsRequest)));
表1 请求参数说明

参数名

类型

说明

limit

long

单次请求返回通道列表的最大数量。

取值范围：1~100。

默认值：10。

exclusiveStartStreamName

string

从该通道开始返回通道列表，返回的通道列表不包括此通道名称。

如果需要分页查询，第一页查询时不传该字段。返回结果has_more_streams为true时，进行下一页查询，exclusiveStartStreamName传入第一页查询结果的最后一条通道名称。

该demo中start_Stream_Name定义为stream0之前的一个通道名称，limit限制为5，所以返回如下信息。

1
 
listStream: {"total_number":20,"stream_names":["Stream0","Stream1","Stream2","Stream3","Stream4"],"has_more_streams":true}
表2 响应参数说明

参数名

类型

说明

total_number

Int

当前租户所有通道数量。

stream_names

List<String>

满足当前请求条件的通道名称的列表。

has_more_streams

Boolean

是否还有更多满足条件的通道。

  • 是：true。
  • 否：false。
父主题： 使用SDK（Java）