查询参数

一些请求将使用可选查询参数，这些参数将修改或增强返回的数据。有关详细信息，请参见各个资源的文档。不是每个资源都支持所有查询参数。本节仅记录当资源实施指定的查询参数时将使用的常用查询参数。

表 2  常用查询参数

参数 描述 props=true 列出资源的属性元数据（默认值为 false） limit=n 限制返回的列表元素数量 start=n 用作返回的元素数据开头的索引号（或时间）

查询参数：props

props 查询参数可用于返回单个资源实例的众多 GET 命令。它将返回一个 "props" 数据元素，其中包含属性元数据的列表。

表 3  属性元数据值

属性 描述 name 属性名称 label 属性描述 immutable 此标志指示属性不可修改 type 属性类型：字符串型、整型、布尔型... choices 对于枚举属性，则为可用值的数组

查询参数：limit

限制查询可用于返回大量元素的众多 GET 命令，以限制返回元素的最大数量。

查询参数：start

支持限制参数的命令也支持开始查询参数。此开始查询参数提供用作返回数据的开头的起始索引。对于支持时间值的资源，此索引可能是一个时间值，例如 "20130531T01:13:58"。