offset / limit 参数说明
更新时间:2024-11-22 11:03:13
PDF
参数说明:
offset
:数据偏移量, 默认为0
limit
:返回数据长度,默认为20,最大100(10/20/50/100)
以 DescribeInstances 获取主机这个 api 为例:
当 limit 为 20,offset 为 0 时,查询显示出所有的三台主机:
"instance_name": "", "instance_name": "rtr-8vwgl9kv", "instance_name": "tools", "total_count": 3
当 limit 为 20,offset 为 1 时,查询显示出第2,第3台主机:
"instance_name": "rtr-8vwgl9kv", "instance_name": "tools", "total_count": 3,
当 limit 为 20,offset 为 2 时,查询显示出第3台主机:
"instance_name": "tools", "total_count": 3,
当 limit 为 20,offset > 2时,没有主机显示:
{'action': 'DescribeInstancesResponse', 'instance_set': [], 'total_count': 3, 'ret_code': 0}
offset 表示从第 n+1个 查询结果开始显示。比如查询 101-199 号主机,此时可以设置 limit 为 100,offset 为 100.