You need to enable JavaScript to run this app.
导航
根据项目id获取项目下标签列表 - PostLabels
最近更新时间:2024.12.06 13:07:29首次发布时间:2024.07.10 15:50:07

请求说明

  • 请求方式:POST
  • 接口名称:PostLabels
  • 请求地址:https://console.volcengine.com/cdp/open_platform/openapi

请求参数

参数

类型

是否必选

示例值

描述

Authorization

String

HMAC-SHA256 Credential=BDPP2952f97532xxxxxx/20240716/cn/openPlatform/request, SignedHeaders=host;x-content-sha256;x-date, Signature=131f3d297eb22a7xxxxxx

详细介绍请查阅调用方式文档

X-Tenant

Long

1

项目ID

Query

参数

类型

是否必选

示例值

描述

ApiAction

String

PostLabels

固定值,对应“请求说明”中的“接口名称”

ApiVersion

String

2023-07-03

固定值,版本号: 2023-07-03

subjectId

Int

1

主体ID,参考附录-主体ID获取方式

type

String

rule

标签类型(rule, import等)

Body

参数

类型

是否必选

示例值

描述

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]

更新方式:
offline: 离线,realtime: 实时

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

创建方式:
rule(规则)
import(导入)
manual(人工)
logic (逻辑)
combine (组合)
ml_model(机器学习模型)
etl_model(数据清洗模型)
hive_sql(hive sql标签)
clickhouse_sql (ch sql标签)
multi_stage(多阶段)
rfm (rfm)
preference(偏好)

dataTypeName

String

string

标签值类型:
文本型:string
数值型:bigint
小数型:double
多值文本型:array_string
日期型:date
时间日期型:datetime
多值数值型:array_bigint
多值日期型:array_date
多值日期时间型:array_datetime

domainId

Int

-2

所属标签文件夹id

position

Number

3

当前子节点目录排序

entityId

Int

1

ID类型的主键

entityType

String

baseid

ID类型名称

computeType

String

offline

更新方式:
offline: 离线,realtime: 实时

isMautag

Int

0

是否为标识“全量用户”的标签(可不关注)

syncParams

Object

{
    "scheduleConf": {
        "frequency": "w",
        "scheduleDay": [
            1,
            2
        ],
        "scheduleTime": "02:00:00"
    },
    "syncType": 1
}

调度信息
frequency:定时更新级别,d=天级,w=周级别,月级别
scheduleDay: 调度天,周级别时1代表周一,月级别时1代表1号
scheduleTime: 调度具体时间,格式 HH:mm:ss

conf

Object

{
    "layers": [
        {
            "filter": {
                "operator": "And",
                "filters": [
                    {
                        "operator": "And",
                        "filters": [
                            {
                                "operator": "=",
                                "tagId": 3,
                                "value": 0
                            }
                        ]
                    }
                ]
            },
            "name": "标签值1"
        }
    ]
}

标签规则,标签筛选逻辑

taskId

Int

100000018

任务ID

dimMetId

Int

282

-(可不关注)

labelRangeRules

String

{
    "value": {
        "enumValue": [
            "测试1",
            "测试2",
            "测试3"
        ]
    }
}

人工标签规则,人工上传标签时,用于枚举标签值

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

参数非法,检查入参。