参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Authorization | String | 是 | HMAC-SHA256 Credential=BDPP2952f97532xxxxxx/20240716/cn/openPlatform/request, SignedHeaders=host;x-content-sha256;x-date, Signature=131f3d297eb22a7xxxxxx | 详细介绍请查阅调用方式文档 |
X-Tenant | Long | 是 | 1 | 项目ID |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
ApiAction | String | 是 | PostLabels | 固定值,对应“请求说明”中的“接口名称” |
ApiVersion | String | 是 | 2023-07-03 | 固定值,版本号: 2023-07-03 |
subjectId | Int | 否 | 1 | 主体ID,参考附录-主体ID获取方式 |
type | String | 否 | rule | 标签类型(rule, import等) |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
projectId | Int | 否 | 1 | 项目id |
ids | Array[Int] | 否 | [1,2] | id列表 |
labelTypes | Array[String] | 否 | [rule] | 标签类型列表 |
subjectIds | Array[Int] | 否 | [1] | 主体id列表 |
entityIds | Array[Int] | 否 | [1] | ID类型的主键列表 |
domainIds | Array[Int] | 否 | [1] | 标签文件夹id列表 |
domainNames | String | 否 | 文件夹1 | 目录名 |
nameLike | String | 否 | xxx | 名称模糊搜索 |
statuses | Array[Int] | 否 | [0] | 标签状态:0-正常,1-删除 |
taskIds | Array[Int] | 否 | [100000018] | 任务id列表 |
computeTypes | Array[String] | 否 | [offline] | 更新方式: |
filterOrigin | Bool | 否 | true | 是否过滤原来的表的标签 |
owners | Array[String] | 否 | [admin] | 归属人 |
createTime | String | 否 | 2023-03-18 12:42:47 | 创建时间,yyyy-MM-dd HH:mm:ss |
frequencies | Array[String] | 否 | [d] | 定时更新级别,d=天级,w=周级别,m=月级别 |
syncTypes | Array[Int] | 否 | [1] | 更新类型,1=定时更新,2=手动更新 |
latestRunDate | String | 否 | 2023-03-18 | 最近运行日期,yyyy-MM-dd |
userNum | Int | 否 | 10 | 覆盖人数大于等于(仅作用于metaInfo) |
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
id | Int | 4 | 标签ID |
name | String | autotest_quanliang03181231 | 标签名称 |
orgId | Int | 1 | 集团ID |
projectId | Int | 1 | 项目ID |
descr | String | "" | 描述 |
dataSecurityLevel | String | null | 安全等级(暂废弃) |
labelType | String | rule | 创建方式: |
dataTypeName | String | string | 标签值类型: |
domainId | Int | -2 | 所属标签文件夹id |
position | Number | 3 | 当前子节点目录排序 |
entityId | Int | 1 | ID类型的主键 |
entityType | String | baseid | ID类型名称 |
computeType | String | offline | 更新方式: |
isMautag | Int | 0 | 是否为标识“全量用户”的标签(可不关注) |
syncParams | Object |
| 调度信息 |
conf | Object |
| 标签规则,标签筛选逻辑 |
taskId | Int | 100000018 | 任务ID |
dimMetId | Int | 282 | -(可不关注) |
labelRangeRules | String |
| 人工标签规则,人工上传标签时,用于枚举标签值 |
status | Int | 0 | 标签状态:0-正常,1-删除 |
createApiTask | Bool | false | 是否开启在线服务 |
realtimeTaskId | Int | null | 实时任务ID(仅实时标签有该字段) |
realtimeStatus | Int | null | 实时任务最新状态(仅实时标签有该字段):RUNNING=运行中,STOP=停止运行 |
owner | String | admin | 创建人 |
createTime | String | 2023-03-18 12:42:47 | 创建时间 |
updater | String | admin | 最新编辑人 |
updateTime | String | 2023-03-18 12:42:50 | 最新编辑时间 |
abiDimMetId | Int | 0 | -(可以不关注) |
lastSuccessTaskInstanceId | Int | 1192 | 最后更新成功的任务ID |
latestRunDate | String | 2023-04-25 | 最后更新时间:返回格式 yyyy-MM-dd |
userNum | Int | 5124 | 覆盖用户数 |
values | Array[String] | null | 枚举值 |
invokerCount | Int | 引用次数(1.24新增) | |
queryCount | Int | 查询次数(1.24新增) |
{ "subjectId": 1 }
{ "code":0, "msg":"成功", "data":[ { "id":4, "name":"autotest_quanliang03181231", "orgId":1, "projectId":1, "descr":"", "dataSecurityLevel":null, "labelType":"rule", "dataTypeName":"string", "domainId":-2, "domainName": "", // 生效版本 1.20 "position":3, "entityId":1, "entityType":"baseid", "computeType":"offline", "isMautag":0, "syncParams":{ "scheduleConf":{ "frequency":"d", "scheduleTime":"02:00:00" }, "syncType":1 }, "conf":{ "layers":[ { "filter":{ "operator":"And", "filters":[ { "operator":"And", "filters":[ { "operator":"=", "tagId":3, "value":0 } ] } ] }, "name":"标签值1" } ] }, "taskId":100000018, "dimMetId":282, "labelRangeRules":null, "status":0, "createApiTask":false, "realtimeTaskId":null, "realtimeStatus":null, "owner":"admin", "createTime":"2023-03-18 12:42:47", "updater":"admin", "updateTime":"2023-03-18 12:42:50", "abiDimMetId":0, "lastSuccessTaskInstanceId":1192, "latestRunDate":"2023-04-25", "userNum":5124, "values":null } ] }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
HTTP 状态码 | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | invalidParameter | PARAMETER INVALID | 参数非法,检查入参。 |