查询绑定了指定标签的实例列表
更新时间 2025-10-17 14:30:28
最近更新时间: 2025-10-17 14:30:28
接口功能介绍
查询绑定了指定标签的实例列表
接口约束
无
URI
POST /v1/instLable/spuInstLabel/query
路径参数 无
Query参数 无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池编码 | 100054c0416811e9a6690242ac110002 | |
| accountId | 是 | String | 账户 | 562b89493b1a40e1b97ea05e50dd8170 |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| labels | 是 | Array of Objects | 标签列表 | labels | |
| spuInstIds | 是 | String | 实例ID列表 | 670744821467448320 | |
| 表 labels |
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| code | 是 | String | 标签编码 | label10 | |
| id | 是 | Integer | 标签id | 33 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 响应码描述 | 900 | |
| returnObj | Object | 返回数据 | returnObj | |
| message | String | 返回文字描述 | success | |
| 表 returnObj |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| list | String | 标签列表 | list | |
| pageNum | Integer | 页码 | 1 | |
| pageSize | Integer | 每页数量 | 10 | |
| size | Integer | 数量 | 4 | |
| startRow | String | 开始行号 | 1 | |
| endRow | String | 结束行号 | 4 | |
| total | Integer | 总数 | 4 | |
| pages | Integer | 页码 | 1 | |
| prePage | Integer | 上一页 | 0 | |
| nextPage | Integer | 下一页 | 2 | |
| isFirstPage | Boolean | 是否第一页 | true | |
| isLastPage | Boolean | 是否最后一页 | true | |
| hasPreviousPage | Boolean | 是否有上一页 | false | |
| hasNextPage | Boolean | 是否有下一页 | false | |
| 表 list |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| spuInstId | String | 实例标识 | 679412759292544000 | |
| labels | String | 标签列表 | labels | |
| 表 labels |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| id | String | 标签id | 33 | |
| name | String | 标签名称 | 标签10 | |
| code | String | 标签编码 | label10 | |
| val | String | 取值 | 测试值10 | |
| remark | String | 备注 | 测试备注10 | |
| share | String | 是否共享 | ||
| createdBy | String | 创建人标识 | 1 | |
| createdTime | String | 创建时间 | 1659528115000 | |
| modifiedBy | Integer | 修改人标识 | 1 | |
| modifiedTime | String | 修改时间 | 1659528115000 |
枚举参数
无
请求示例
请求url
无
请求头header
{
"accountId": "562b89493b1a40e1b97ea05e50dd8170",
"regionId": "100054c0416811e9a6690242ac110002",
}
请求体body
{
"labels": [
{
"code": "label10",
"id": 33
}
],
"spuInstIds": ["679412759292544000"]
}
响应示例
{
"statusCode": 0,
"message": "success",
"returnObj": {
"pageNum": 1,
"pageSize": 10,
"size": 4,
"startRow": 1,
"endRow": 4,
"total": 4,
"pages": 1,
"list": [
{
"spuInstId": "654085908085081088",
"labels": [
{
"id": 33,
"name": "标签10",
"code": "label10",
"val": "测试值10",
"remark": "测试备注10",
"share": false,
"createdBy": 1,
"createdTime": 1659528115000,
"modifiedBy": null,
"modifiedTime": null
}
]
},
{
"spuInstId": "813530711326721024",
"labels": [
{
"id": 33,
"name": "标签10",
"code": "label10",
"val": "测试值10",
"remark": "测试备注10",
"share": false,
"createdBy": 1,
"createdTime": 1659528115000,
"modifiedBy": null,
"modifiedTime": null
}
]
},
{
"spuInstId": "646972016867410944",
"labels": [
{
"id": 33,
"name": "标签10",
"code": "label10",
"val": "测试值10",
"remark": "测试备注10",
"share": false,
"createdBy": 1,
"createdTime": 1659528115000,
"modifiedBy": null,
"modifiedTime": null
}
]
},
{
"spuInstId": "651929699697558528",
"labels": [
{
"id": 33,
"name": "标签10",
"code": "label10",
"val": "测试值10",
"remark": "测试备注10",
"share": false,
"createdBy": 1,
"createdTime": 1659528115000,
"modifiedBy": null,
"modifiedTime": null
}
]
}
],
"prePage": 0,
"nextPage": 0,
"isFirstPage": true,
"isLastPage": true,
"hasPreviousPage": false,
"hasNextPage": false,
"navigatePages": 8,
"navigatepageNums": [
1
],
"navigateFirstPage": 1,
"navigateLastPage": 1,
"firstPage": 1,
"lastPage": 1
}
}
状态码
请参考 状态码
错误码
请参考 错误码
