查询实例的指定属性
功能介绍
根据查询条件及指定属性分页返回(不支持扩展属性作为选定属性列)。
接口约束
不涉及。
URI
POST /rdm_{identifier}_app/publicservices/api/{modelName}/select/{pageSizePath}/{curPagePath}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
pageSizePath |
是 |
Integer |
参数解释: 分页大小(路径参数)。 约束限制: 不涉及。 取值范围: 1-1000。 默认取值: 不涉及。 |
curPagePath |
是 |
Integer |
参数解释: 当前页数(路径参数)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 1。 |
identifier |
是 |
String |
参数解释: 应用唯一标识。 约束限制: 不涉及。 取值范围: 由英文字母和数字组成,且长度为32个字符。 默认取值: 不涉及。 |
modelName |
是 |
String |
参数解释: 数据模型的英文名称。 约束限制: 不涉及。 取值范围: 大写字母开头,只能包含字母、数字、“_”,且长度为[1-60]个字符。 默认取值: 不涉及。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
curPage |
否 |
Integer |
参数解释: 当前页。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 1。 |
endIndex |
否 |
Integer |
参数解释: 结束索引。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 0。 |
maxPageSize |
否 |
Integer |
参数解释: 最大分页数。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 1000。 |
pageSize |
否 |
Integer |
参数解释: 每页大小。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 1000。 |
startIndex |
否 |
Integer |
参数解释: 起始索引。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 0。 |
totalPages |
否 |
Integer |
参数解释: 总页数。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 0。 |
totalRows |
否 |
Integer |
参数解释: 总行数。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 0。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
参数解释: IAM用户的token。 获取方法请参见获取IAM用户Token。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
applicationId |
否 |
String |
参数解释: 应用ID。 约束限制: 不涉及。 取值范围: 由英文字母和数字组成,且长度为32个字符。 默认取值: 不涉及。 |
params |
否 |
QueryRequestSelectedVo object |
参数解释: 请求参数对象。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
characterSet |
否 |
CharacterSetEnum object |
参数解释: 编码类型。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
conditions |
否 |
Array of QueryCondition objects |
参数解释: 查询条件。 此参数已废弃,不建议继续使用,建议使用替代参数filter。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
decrypt |
否 |
Boolean |
参数解释: 是否加密。 约束限制: 不涉及。 取值范围:
默认取值: false。 |
entityType |
否 |
String |
参数解释: 实体类型。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
filter |
否 |
QueryCondition object |
参数解释: 查询条件。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
isNeedTotal |
否 |
Boolean |
参数解释: 是否需要查询总记录数。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
isPresentAll |
否 |
Boolean |
参数解释: 是否需要展示所有参考对象信息。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
needPresentDetail |
否 |
Array of strings |
参数解释: 需要展示详细信息的参考对象。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
orderBy |
否 |
String |
参数解释: 按某个字段进行排序。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
orderByTableAlias |
否 |
String |
参数解释: 排序字段的表别名。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
publicData |
否 |
String |
参数解释: 多租查询参数。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
selectedField |
是 |
Array of SelectedField objects |
参数解释: 指定需返回的属性。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
sort |
否 |
String |
参数解释: 排序方向。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
sorts |
否 |
Array of SortInfoVo objects |
参数解释: 排序。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
isTransformResBody |
否 |
Boolean |
参数解释: 是否需要格式化分类属性。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
conditionName |
否 |
String |
参数解释: 查询条件的名称(数据模型的属性英文名称)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
conditionValue |
否 |
String |
参数解释: 查询条件值(已过时)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
conditionValues |
否 |
Array of strings |
参数解释: 查询条件的值。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
conditions |
否 |
Array of QueryCondition objects |
参数解释: 查询条件列表。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
ignoreStr |
否 |
Boolean |
参数解释: 是否忽略大小写。 约束限制: 不涉及。 取值范围:
默认取值: false。 |
joinTableAlias |
否 |
String |
参数解释: 关联查询时被关联表的别名。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
joiner |
否 |
String |
参数解释: 连接符。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
operator |
否 |
String |
参数解释: 操作符。 约束限制:
取值范围:
默认取值: 不涉及。 |
preCondition |
否 |
QueryCondition object |
参数解释: 当前condition对象的上一层级。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
是 |
String |
参数解释: 字段名称,如果是子参考对象的属性,则为“参考对象.属性名称”,例如:“master.name”。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
nameAs |
否 |
String |
参数解释: 字段别名。如果不填,默认使用name参数的值。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
characterSet |
否 |
CharacterSetEnum object |
参数解释: SQL编码类型。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
orderBy |
否 |
String |
参数解释: 按某个字段进行排序。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
sort |
否 |
String |
参数解释: 排序方向。 约束限制: 不涉及。 取值范围:
默认取值: ASC。 |
sortInfo |
否 |
String |
参数解释: 排序信息。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
sortInfoOrderBy |
否 |
String |
参数解释: 排序信息字段。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
result |
String |
参数解释: 请求结果。 取值范围:
默认取值: 不涉及。 |
data |
Array of objects |
参数解释: 请求参数对象。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
errors |
Array of strings |
参数解释: 异常信息。 取值范围: 不涉及。 默认取值: 不涉及。 |
请求示例
POST https://dme.cn-north-4.huaweicloud.com/rdm_b3f9b7523a6141f4b2d76b92d6595281_app/publicservices/api/PersistableModel/select/10/1
{
"applicationId" : "b3f9b7523a6141f4b2d76b92d6595281",
"params" : {
"selectedField" : [ {
"name" : "rdmExtensionType",
"nameAs" : "nameAsRdmExtensionType"
} ],
"characterSet" : "UTF8",
"isNeedTotal" : true,
"isPresentAll" : true,
"publicData" : "INCLUDE_PUBLIC_DATA",
"sorts" : [ ],
"decrypt" : false,
"filter" : {
"joiner" : "and",
"ignoreStr" : false,
"conditions" : [ {
"conditionName" : "rdmExtensionType",
"operator" : "=",
"conditionValues" : [ "PersistableModel" ],
"ignoreStr" : false
} ]
}
}
}
响应示例
状态码:200
OK
{
"result" : "SUCCESS",
"data" : [ {
"nameAsRdmExtensionType" : "PersistableModel"
} ],
"errors" : [ ],
"pageInfo" : {
"curPage" : 1,
"pageSize" : 10,
"totalRows" : 1,
"totalPages" : 1
}
}
状态码
状态码 |
描述 |
---|---|
200 |
OK |
错误码
请参见错误码。