You need to enable JavaScript to run this app.
文档中心
大数据研发治理套件

大数据研发治理套件

复制全文
下载 pdf
标签管理
UpdateEntityTag - 更新数据地图实体标签
复制全文
下载 pdf
UpdateEntityTag - 更新数据地图实体标签

该接口用于给实体打标签,实体包括表、列。

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

参数
类型
是否必填
示例值
描述
Action
String
是

UpdateEntityTag

要执行的操作,取值:UpdateEntityTag。

Version
String
是

2026-03-01

API的版本,取值:2026-03-01。

Body

参数
类型
是否必填
示例值
描述
EntityTypeName
String
是

LasFormationColumn

实体的元数据类型

EntityQualifiedName
String
是

LasFormationColumn:///hive2/zbc_test_06_02/test_table_06_22_04/name@102/default/default@21000xxxxx

实体的元数据唯一键

Tags
Array of Object
是

"Tags": [
{
"TypeName": "Tag",
"QualifiedName": "Tag:///zbc的标签1@102/default/default@21000xxxxx"
}
]

更新的tag标签信息

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数
类型
示例值
描述
Success
Double

true

更新是否成功

AffectedCount
Integer

1

更新的实体数

请求示例

POST /?Action=UpdateEntityTag&Version=2026-03-01 HTTP/1.1
Host: dataleap-qa.cn-beijing.volcengineapi.com
Content-Type: application/json
X-Date: 20260301T120000Z
Authorization: HMAC-SHA256 Credential=AK****/20260301/cn-beijing/dataleap_qa/request, SignedHeaders=host;x-date, Signature=***

{
  "EntityTypeName": "LasFormationColumn",
  "EntityQualifiedName": "LasFormationColumn:///hive2/zbc_test_06_02/test_table_06_22_04/name@102/default/default@21000xxxxx",
  "Tags": [
    {
      "TypeName": "Tag",
      "QualifiedName": "Tag:///zbc的标签1@102/default/default@21000xxxxx"
    },
    {
      "TypeName": "Tag",
      "QualifiedName": "Tag:///zbc的标签2@102/default/default@21000xxxxx"
    }
  ]
}

返回示例

={
    "ResponseMetadata": {
        "RequestId": "20260629181214FBC2F1C5D06CEDA9AF46",
        "Action": "UpdateEntityTag",
        "Version": "2026-03-01",
        "Service": "dataleap_qa",
        "Region": "cn-beijing"
    },
    "Result": {
        "ErrorCode": "01-200-C00000",
        "Code": 0,
        "Version": "v2",
        "Message": "success",
        "Data": {
            "Success": true,
            "AffectedCount": 1
        }
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码
错误码
错误信息
说明
400
InvalidParameter

The specified parameter %s is invalid.

400
MissingParameter

The required parameter %s is missing.

404
NotFound

The requested resource does not exist.

500
InternalError

The request has failed due to an unknown error.

最近更新时间:2026.07.07 17:34:44
这个页面对您有帮助吗?
有用
有用
无用
无用